FPdfTextShapingHb - PDFium Delphi Component

Unit: FPdfTextShapingHb

Backend tvarovania HarfBuzz pre ciele Free Pascal, ktorý viaže libharfbuzz za behu a bajty fontov berie z resolvera dodávaného hostiteľom

Syntax

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;

Description

FPdfTextShapingHb je náprotivok backendu Uniscribe v FPdfTextShaping pre ciele bez usp10.dll. Rozhranie sa kompiluje len pod Free Pascal, pretože Delphi cieli Windows, kde sa uplatňuje backend Uniscribe

Oba backendy si rozdeľujú prácu inak. Uniscribe rozčlení, vytvaruje, umiestni a preusporiada v jednom prechode, zatiaľ čo HarfBuzz tvaruje jediný beh, ktorého smer a písmo sú už známe. Táto jednotka dodáva zvyšok: FPdfBidi vyrieši úrovne zapustenia, skript Unicode každého znaku rozsegmentuje text na behy a behy sa rozložia do vizuálneho poradia, ktoré dáva pravidlo L2 z UAX #9. Znaky so skriptom Common, Inherited a neznámym pokračujú v behu, v ktorom sa nachádzajú, takže číslica ani medzera nerozdelí slovo

libharfbuzz sa viaže za behu cez DynLibs, takže nie je buildovou závislosťou a jeho neprítomnosť sa nahlási namiesto fatálneho zlyhania. HarfBuzzAvailable oznamuje, či bola knižnica nájdená a či sa rozpoznali požadované vstupné body, a HarfBuzzVersionString vráti verziu načítanej knižnice

Tvarovač si fonty nevyhľadáva. Uniscribe číta binárny font z GDI device contextu, čo nemá prenosný ekvivalent, takže hostiteľ odovzdá do Create TPdfFontDataResolver, ktorý mapuje názov fontu na bajty TrueType alebo OpenType. Výber fontov - fontconfig, CoreText alebo vlastný priečinok fontov aplikácie - tak zostáva mimo jednotky, ktorá nemá čo rozhodovať o tejto politike

Functions

Function	Description
`HarfBuzzAvailable`	True, keď sa našla libharfbuzz a rozpoznali sa požadované vstupné body; prvé volanie vykoná viazanie
`HarfBuzzVersionString`	Verzia načítanej knižnice ako "major.minor.micro", alebo prázdny reťazec, keď knižnica nie je dostupná

Types

Type	Description
`TPdfFontDataResolver`	Referencia na metódu, ktorá mapuje `FontName` na bajty súboru fontu v `FontData`; vrátenie False spôsobí, že tvarovač zamietne požiadavku rovnakým spôsobom ako nečitateľný GDI font na Windows
`EPdfHarfBuzzError`	Výnimka vyvolaná, keď nie je nakonfigurovaný žiadny resolver, keď libharfbuzz nie je dostupné, alebo keď nemožno vytvoriť blob, face, font či buffer HarfBuzz
`TPdfHarfBuzzTextShaper`	Implementácia `TPdfTextShaper` postavená na HarfBuzz s `Create`, `Destroy` a `Shape`

Members of TPdfHarfBuzzTextShaper

Member	Description
`Create(Resolver)`	Vytvorí tvarovač a uloží `TPdfFontDataResolver`, ktorý použije pri každom vyhľadaní fontu
`Destroy`	Uvoľní cache face a blob HarfBuzz, potom zdedený deštruktor
`Shape(Text, FontName, FontSize, Options, Shaped)`	Vyrieši úrovne zapustenia, rozsegmentuje text podľa úrovne a skriptu, vytvaruje každý beh cez HarfBuzz a vráti behy vo vizuálnom poradí v `Shaped`; False, keď text neposkytne žiadne glyfy

Remarks

Viazanie je odložené: prvé volanie HarfBuzzAvailable vyskúša libharfbuzz-0.dll a harfbuzz.dll na Windows, libharfbuzz.0.dylib a libharfbuzz.dylib na macOS a libharfbuzz.so.0 a libharfbuzz.so inde
Handle knižnice zostáva otvorený po celý život procesu, pretože jeho uvoľnenie, kým je iné vlákno vnútri tvarovacieho volania, by zrazilo hostiteľa
Shape vyvolá EPdfTextShapingError pri prázdnom texte, prázdnom názve fontu, nekladnej veľkosti fontu, neplatných limitoch v Options, texte nad MaxCharacters, glyfoch nad MaxGlyphs alebo dátach fontu, ktoré resolver nedodal
Shape vyvolá EPdfHarfBuzzError, keď nie je nakonfigurovaný žiadny TPdfFontDataResolver, keď libharfbuzz nie je dostupné, alebo keď nemožno vytvoriť objekt HarfBuzz
Jedna face sa cacheuje na názov fontu spolu s bajtmi, z ktorých bola zostavená, a uvoľní sa, keď sa požadovaný názov zmení alebo sa tvarovač zničí
Celý reťazec sa odovzdá HarfBuzz s označeným behom vnútri neho, takže písma s viazaním znakov stále vidia znaky na oboch stranách a vyberú správne kontextové tvary
Posuny a ofsety sa vracajú v bodoch, prepočítané z fixbodových hodnôt 26.6, ktoré HarfBuzz hlási
Pozície zhlukov sú logické indexy do zdrojového textu a dĺžky zhlukov vychádzajú zo vzdialenosti k začiatku ďalšieho zhluku, v ktoromkoľvek smere čítania
Počet behov obmedzuje Options.MaxRuns a Options.Direction mapuje ptdLeftToRight a ptdRightToLeft na pevný smer odseku, pričom všetko ostatné sa vyrieši automaticky
Shaped.FontData drží bajty, ktoré resolver vrátil, čo je presne to, čo TPdf.AddShapedText potrebuje na stavbu CID fontu

FPdfTextShapingHb jednotka