ConvertTextToPaths

Úpravy toku obsahu, písma

Popis

Přepíše instrukce zobrazující text na vybraných stránkách jako vektorová vyvolání Form XObject, zatímco zachovává umístění glyfů, rozestup textu, režim psaní, transformace, barvu výplně, barvu tahu a nastavení tahu

Obrysy glyfů TrueType a Type 1 se extrahují jednou a znovu používají pro opakované glyfy. CharProcs Type 3 se převádějí na běžné Form XObject se zachovanou maticí fontu, ohraničujícím rámečkem a rozsahem prostředků. Původní instrukce zobrazující text a vybírající font se odstraní

Konverze je transakční. Každá vybraná obsahová vrstva a požadovaný vnořený Form se parsují a převádějí v paměti, než se změní jakýkoli objekt PDF. Nepodporované fonty, režimy vykreslení ořezu textu 4 až 7, poškozený textový stav a nejednoznačné sdílené rozsahy prostředků Form selžou, aniž by částečně přepsaly dokument

Převedený text už není prohledávatelný, volitelný ani extrahovatelný jako text. Zůstává škálovatelným vektorovým obsahem pro vykreslování a tisk

Syntaxe

Delphi

Function TPDFlib.ConvertTextToPaths(Const PageRange: WideString= ''; Options: Integer= PDF_TEXT_PATH_DEFAULT): Integer;

ActiveX

Function PDFlib::ConvertTextToPaths(PageRange As String, Options As Long) As Long

DLL

int DLConvertTextToPaths(int InstanceID, const wchar_t *PageRange, int Options);
int DLConvertTextToPathsA(int InstanceID, const char *PageRange, int Options);

Parametry

Návratové hodnoty1 or greaterNumber of text-showing instructions converted0No eligible text was found, the range or options were invalid, or conversion failed. Inspect LastErrorCode to distinguish errors

PageRange	Výraz rozsahu stránek s čísly stránek od 1. Prázdná hodnota vybere všechny stránky
Options	Bitová kombinace `PDF_TEXT_PATH_RECURSE_FORMS` pro převod vnořených Form XObject a `PDF_TEXT_PATH_PURGE_FONTS` k odstranění zdrojových fontových prostředků, které se stanou nepoužitými. `PDF_TEXT_PATH_DEFAULT` zapne obě volby

Kódy chyb

1 or greater	Počet převedených instrukcí zobrazujících text
0	Nenalezen žádný vyhovující text, rozsah nebo volby byly neplatné, nebo konverze selhala. Pro rozlišení chyb prohlédněte `LastErrorCode`

Kódy chyb

506	Zdrojový font nemůže dodat podporovaný vektorový glyfový program
507	Režim vykreslování s ořezem textu vyžaduje ořezovou cestu, kterou nelze vyjádřit nezávislým Formem glyfu
508	Textový program, stav fontu, nebo rekurzivní rozsah prostředků Form je poškozený nebo nejednoznačný

Příklad

Converted := PDF.ConvertTextToPaths('1-3,5', PDF_TEXT_PATH_DEFAULT);
If (Converted= 0)and (PDF.LastErrorCode<> 0) Then
  raise Exception.Create(PDF.LastError);