ConvertTextToPaths

Redigering af indholdsstrømme, skrifttyper

Beskrivelse

Omskriver instruktioner til tekstvisning på de valgte sider som kald af vektorbaserede Form XObject-objekter, samtidig med at glyfplacering, tekstafstand, skriveretning, transformationer, fyldfarve, stregfarve og stregindstillinger bevares

TrueType- og Type 1-glyfkonturer udtrækkes én gang og genbruges til gentagne glyffer. Type 3 CharProcs konverteres til almindelige Form XObjects med deres skrifttypematrix, afgrænsningsfelt og ressourceomfang bevaret. De oprindelige instruktioner til tekstvisning og valg af skrifttype fjernes

Konverteringen er transaktionel. Alle valgte indholdslag og ønskede indlejrede Forms fortolkes og konverteres i hukommelsen, før et PDF-objekt ændres. Ikke-understøttede skrifttyper, gengivelsestilstande 4 til 7 med tekstklipning, fejlbehæftet teksttilstand og tvetydige ressourceområder for delte Forms medfører fejl uden delvis omskrivning af dokumentet

Konverteret tekst kan ikke længere søges, markeres eller udtrækkes som tekst. Den forbliver skalerbart vektorindhold til gengivelse og udskrivning

Syntaks

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

Parametre

PageRange	Sideintervaludtryk med etbaserede sidetal. En tom værdi vælger alle sider
Options	Bitvis kombination af `PDF_TEXT_PATH_RECURSE_FORMS` for at konvertere indlejrede Form XObject-objekter og `PDF_TEXT_PATH_PURGE_FONTS` for at fjerne kildeskrifttyperessourcer, der ikke længere bruges. `PDF_TEXT_PATH_DEFAULT` aktiverer begge indstillinger

Returværdier

1 or greater	Antallet af konverterede tekstvisningsinstruktioner
0	Der blev ikke fundet nogen kvalificeret tekst, intervallet eller indstillingerne var ugyldige, eller konverteringen mislykkedes. Undersøg `LastErrorCode` for at skelne mellem fejl

Fejlkoder

506	Kildeskrifttypen kan ikke levere et understøttet vektorglyfprogram
507	En gengivelsestilstand med tekstklipning kræver en klippesti, som ikke kan repræsenteres af en uafhængig glyf-Form
508	Tekstprogrammet, skrifttypetilstanden eller det rekursive Form-ressourceområde er forkert udformet eller tvetydigt

Eksempel

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