FPdfTextShapingHb - PDFium Delphi Component

Jednotka: FPdfTextShapingHb

Tvarovací backend HarfBuzz pro cíle Free Pascal, který váže libharfbuzz za běhu a bere bajty fontu od resolveru dodaného hostitelem

Syntaxe

TPdfFontDataResolver = function(const FontName: WideString;
  out FontData: TBytes): Boolean of object;

EPdfHarfBuzzError = class(Exception);

TPdfHarfBuzzTextShaper = class(TPdfTextShaper)
  constructor Create(const Resolver: TPdfFontDataResolver);
  destructor Destroy; override;
  function Shape(const Text, FontName: WideString; FontSize: Single;
    const Options: TPdfTextShapingOptions;
    out Shaped: TPdfShapedText): Boolean; override;
end;

function HarfBuzzAvailable: Boolean;
function HarfBuzzVersionString: string;

Popis

FPdfTextShapingHb je protějšek backendu Uniscribe z FPdfTextShaping pro cíle, které nemají usp10.dll. Rozhraní se kompiluje pouze pod Free Pascalem, protože Delphi cílí na Windows, kde platí backend Uniscribe

Oba backendy si práci dělí jinak. Uniscribe segmentuje, tvaruje, umisťuje a přeřazuje v jednom průchodu, zatímco HarfBuzz tvaruje jediný běh, jehož směr a písmo jsou už známé. Zbytek dodává tato jednotka: FPdfBidi vyřeší úrovně vnoření, Unicode písmo každého znaku rozdělí text na běhy a běhy se vyskládají do vizuálního pořadí, které dává pravidlo L2 z UAX #9. Znaky common, inherited a neznámého písma zůstávají v běhu, ve kterém právě jsou, takže číslice ani mezera nerozdělí slovo

libharfbuzz se váže za běhu přes DynLibs, takže není build závislostí a jeho absence se nahlásí místo toho, aby byla fatální. HarfBuzzAvailable hlásí, zda byla knihovna nalezena a požadované vstupní body vyřešeny, a HarfBuzzVersionString vrací verzi nahrané knihovny

Shaper si fonty sám nehledá. Uniscribe čte binární data fontu z GDI device contextu, což nemá přenositelný ekvivalent, takže hostitel předá Create resolver TPdfFontDataResolver, který mapuje název fontu na bajty TrueType nebo OpenType. Vyjmenovávání fontů - fontconfig, CoreText nebo vlastní složka fontů aplikace - tak zůstává mimo jednotku, která do té politiky nic nemá

Funkce

Function	Description
`HarfBuzzAvailable`	True, když byl libharfbuzz nalezen a požadované vstupní body vyřešeny; první volání provede vazbu
`HarfBuzzVersionString`	Verze nahrané knihovny jako "major.minor.micro", nebo prázdný řetězec, když knihovna není k dispozici

Typy

Type	Description
`TPdfFontDataResolver`	Method reference mapující `FontName` na bajty souboru fontu v `FontData`; vrácení False donutí shaper ukončit požadavek jako neúspěšný stejně jako nečitelný GDI font ve Windows
`EPdfHarfBuzzError`	Výjimka vyvolaná, když není nakonfigurován žádný resolver, když není libharfbuzz k dispozici, nebo když nelze vytvořit HarfBuzz blob, face, font ani buffer
`TPdfHarfBuzzTextShaper`	Implementace `TPdfTextShaper` postavená na HarfBuzz, s `Create`, `Destroy` a `Shape`

Členové TPdfHarfBuzzTextShaper

Member	Description
`Create(Resolver)`	Vytvoří shaper a uloží `TPdfFontDataResolver`, který použije při každém hledání fontu
`Destroy`	Uvolní cachovanou HarfBuzz face a blob, poté zavolá zděděný destruktor
`Shape(Text, FontName, FontSize, Options, Shaped)`	Vyřeší úrovně vnoření, rozdělí text podle úrovně a písma, vytvaruje každý běh přes HarfBuzz a vrátí běhy ve vizuálním pořadí v `Shaped`; False, když text neposkytne žádné glyfy

Poznámky

Vazba je líná: první volání HarfBuzzAvailable zkouší libharfbuzz-0.dll a harfbuzz.dll na Windows, libharfbuzz.0.dylib a libharfbuzz.dylib na macOS a libharfbuzz.so.0 a libharfbuzz.so jinde
Handle knihovny zůstává otevřený po celou životnost procesu, protože jeho uvolnění, zatímco jiné vlákno je uvnitř tvarovacího volání, by shodilo hostitele
Shape vyvolá EPdfTextShapingError pro prázdný text, prázdný název fontu, nekladnou velikost fontu, neplatné limity Options, text přes MaxCharacters, glyfy přes MaxGlyphs nebo data fontu, která resolver nedodal
Shape vyvolá EPdfHarfBuzzError, když není nakonfigurován žádný TPdfFontDataResolver, když není libharfbuzz k dispozici, nebo když nelze vytvořit HarfBuzz objekt
Face se cachuje na název fontu spolu s bajty, ze kterých byla sestavena, a uvolní se, když se požadovaný název změní nebo se shaper zničí
Celý řetězec jde do HarfBuzz s označeným během uvnitř, takže propojovací písma stále vidí znaky po obou stranách a vyberou správné kontextové tvary
Posuvy a ofsety se vrací v bodech, převedené z pevných hodnot 26.6, které HarfBuzz hlásí
Pozice clusterů jsou logické indexy do zdrojového textu a délky clusterů vycházejí ze vzdálenosti k začátku dalšího clusteru, v libovolném směru čtení
Počet běhů omezuje Options.MaxRuns a Options.Direction mapuje ptdLeftToRight a ptdRightToLeft na pevný směr odstavce, cokoli jiného se vyřeší automaticky
Shaped.FontData drží bajty, které resolver vrátil; přesně to TPdf.AddShapedText potřebuje k sestavení CID fontu

Viz také

FPdfTextShaping, TPdf.AddShapedText, TPdf.AddCidType2Text, ConfigureSystemFontProvider

FPdfTextShapingHb jednotka