ConvertTextToPaths

Bewerking van contentstreams, Fonts

Beschrijving

Herschrijft tekstweergave-instructies op de geselecteerde pagina's als vector-Form XObject-aanroepen waarbij glyphplaatsing, tekstspatiëring, schrijfrichting, transformaties, vulkleur, lijnkleur en lijninstellingen behouden blijven

TrueType- en Type 1-glyphomtrekken worden één keer geëxtraheerd en hergebruikt voor herhaalde glyphs. Type 3-CharProcs worden omgezet in gewone Form XObjects met hun fontmatrix, bounding box en resourcebereik behouden. De oorspronkelijke instructies voor tekstweergave en fontselectie worden verwijderd

De conversie is transactioneel. Elke geselecteerde inhoudslaag en elke gevraagde geneste Form wordt in het geheugen geparseerd en omgezet voordat er ook maar iets aan PDF-objecten verandert. Niet-ondersteunde fonts, tekst-clipping-rendermodi 4 tot en met 7, misvormde teksttoestand en dubbelzinnige gedeelde Form-resourcebereiken falen zonder het document gedeeltelijk te herschrijven

Geconverteerde tekst is niet langer doorzoekbaar, selecteerbaar of extraheerbaar als tekst. Ze blijft schaalbare vectorinhoud voor rendering en afdruk

Syntaxis

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);

Parameters

PageRange	Paginabereikexpressie met paginanummers beginnend bij 1. Een lege waarde selecteert elke pagina
Options	Bitsgewijze combinatie van `PDF_TEXT_PATH_RECURSE_FORMS` om geneste Form XObjects om te zetten en `PDF_TEXT_PATH_PURGE_FONTS` om bronfontresources die ongebruikt raken te verwijderen. `PDF_TEXT_PATH_DEFAULT` zet beide opties aan

Retourwaarden

1 or greater	Aantal omgezette tekstweergave-instructies
0	Er is geen geschikte tekst gevonden, het bereik of de opties waren ongeldig, of de conversie is mislukt. Raadpleeg `LastErrorCode` om fouten te onderscheiden

Foutcodes

506	Het bronfont kan geen ondersteund vectorglyphprogramma leveren
507	Een tekst-clipping-rendermodus vereist een clipping path die niet als onafhankelijke glyph-Form kan worden weergegeven
508	Het tekstprogramma, de fonttoestand of het recursieve Form-resourcebereik is misvormd of dubbelzinnig

Voorbeeld

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