PDFium Delphi Component Docs

AddShapedText metoda

Component: TPdf  ·  Units: PDFium, FPdfTextShaping

Syntax

function AddShapedText(const Text, Font: WString; FontSize: Single; X, Y: Double; out Shaped: TPdfShapedText; Direction: TPdfTextDirection = ptdAuto; Color: TColor = clBlack; Alpha: Byte = $FF): Boolean;

Description

Tvaruje text Unicode nativním skriptovacím strojem Windows, načte vybrané systémové písmo jednou a zapíše explicitně umístěné glyfy prostřednictvím rozhraní písem CID Type 2 PDFium

ptdAuto určí základní směr odstavce z prvního silného znaku, zatímco explicitní režimy zleva doprava a zprava doleva jsou k dispozici pro rozložení řízené aplikací

Unicode semantics

Každý glyf obdrží ohraničené mapování CID a vygenerovanou položku ToUnicode, včetně mapování respektujících clustery pro ligatury a kontextové tvary

Textový objekt nese původní logický řetězec v ActualText, takže vyhovující konzumenti mohou obnovit logické pořadí čtení, i když je geometrie umístěných glyfů bidi obsahem ve vizuálním pořadí

TPdf.Text sleduje fyzické pořadí extrakce bidi PDFium, a proto se může lišit od původního logického pořadí vstupu

Shaping result

TPdfShapedText vrací bajty písma, celkovou šířku, počty glyfů a logických znaků a vizuální běhy obsahující úrovně bidi, ID glyfů, posuny, odsazení a zdrojové clustery

Pro tvarování bez úpravy dokumentu použijte ShapePdfText, nebo vytvořte TPdfUniscribeTextShaper s TPdfTextShapingOptions, když jsou vyžadovány explicitní rozpočty znaků, glyfů a běhů

Safety and performance

Limity vstupu, glyfů a běhů selžou uzavřeně ještě před neohraničenou alokací

Běhy sdílející jednu účaří se generují jako jeden textový objekt a pozice glyfů se vytvářejí v lineárním čase

Metoda vyžaduje exporty PDFium pro písma CID Type 2, kódy znaků, pozice, označený obsah a opětovné generování obsahu

See Also

AddText, GetStructuredText, GenerateLayout