FPdfTextShapingHb - PDFium Delphi Component

Unit: FPdfTextShapingHb

Backend de shaping HarfBuzz pentru ținte Free Pascal, care leagă libharfbuzz la rulare și își ia octeții de font de la un rezolvator furnizat de aplicația gazdă

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 este contrapiesa backend-ului Uniscribe din FPdfTextShaping, pentru ținte care nu au usp10.dll. Interfața este compilată doar sub Free Pascal, pentru că Delphi vizează Windows, unde se aplică backend-ul Uniscribe

Cele două backend-uri își împart lucrul diferit. Uniscribe împarte în itemi, modelează, poziționează și reordonează într-o singură trecere, în timp ce HarfBuzz modelează un singur run a cărui direcție și script sunt deja cunoscute. Această unitate furnizează restul: FPdfBidi rezolvă nivelurile de embedding, scriptul Unicode al fiecărui caracter segmentează textul în runs, iar runs-urile sunt așezate în ordinea vizuală pe care o dă regula L2 din UAX #9. Caracterele cu script Common, Inherited și necunoscut continuă run-ul în care se află, astfel încât o cifră sau un spațiu nu taie un cuvânt

libharfbuzz este legat la rulare prin DynLibs, deci nu este o dependență de build, iar absența sa este raportată, nu fatală. HarfBuzzAvailable raportează dacă biblioteca a fost găsită și punctele de intrare necesare au fost rezolvate, iar HarfBuzzVersionString returnează versiunea bibliotecii încărcate

Shaper-ul nu caută fonturi. Uniscribe citește binarul fontului dintr-un context de dispozitiv GDI, ceea ce nu are un echivalent portabil, așa că aplicația gazdă transmite lui Create un TPdfFontDataResolver care asociază un nume de font cu octeții TrueType sau OpenType. Astfel, enumerarea fonturilor - fontconfig, CoreText sau propriul dosar de fonturi al aplicației - rămâne în afara unei unități care nu are nicio treabă cu acea politică

Functions

Function	Description
`HarfBuzzAvailable`	True când libharfbuzz a fost găsit și punctele de intrare necesare rezolvate; primul apel execută legarea
`HarfBuzzVersionString`	Versiunea bibliotecii încărcate ca "major.minor.micro", sau un șir vid când biblioteca nu este disponibilă

Types

Type	Description
`TPdfFontDataResolver`	Referință de metodă care asociază `FontName` cu octeții fișierului de font din `FontData`; returnarea False face ca shaper-ul să eșueze cererea la fel cum o face un font GDI ilizibil pe Windows
`EPdfHarfBuzzError`	Excepție ridicată când niciun rezolvator nu este configurat, când libharfbuzz nu este disponibil sau când un blob, o față, un font sau un buffer HarfBuzz nu poate fi creat
`TPdfHarfBuzzTextShaper`	Implementare `TPdfTextShaper` bazată pe HarfBuzz, cu `Create`, `Destroy` și `Shape`

Members of TPdfHarfBuzzTextShaper

Member	Description
`Create(Resolver)`	Creează shaper-ul și reține `TPdfFontDataResolver` pe care îl va folosi la fiecare căutare de font
`Destroy`	Eliberează fața HarfBuzz și blob-ul din cache, apoi destructorul moștenit
`Shape(Text, FontName, FontSize, Options, Shaped)`	Rezolvă nivelurile de embedding, segmentează textul după nivel și script, modelează fiecare run prin HarfBuzz și returnează runs-urile în ordine vizuală în `Shaped`; False când textul nu produce glife

Remarks

Legarea este lazy: primul apel HarfBuzzAvailable sondează libharfbuzz-0.dll și harfbuzz.dll pe Windows, libharfbuzz.0.dylib și libharfbuzz.dylib pe macOS, respectiv libharfbuzz.so.0 și libharfbuzz.so în rest
Handle-ul bibliotecii rămâne deschis pe durata de viață a procesului, pentru că descărcarea în timp ce un alt thread este într-un apel de shaping ar prăbuși aplicația gazdă
Shape ridică EPdfTextShapingError pentru text vid, nume de font vid, dimensiune de font nepozitivă, limite Options invalide, text peste MaxCharacters, glife peste MaxGlyphs sau date de font pe care rezolvatorul nu le-a putut furniza
Shape ridică EPdfHarfBuzzError când niciun TPdfFontDataResolver nu este configurat, când libharfbuzz nu este disponibil sau când un obiect HarfBuzz nu poate fi creat
O singură față este ținută în cache per nume de font, împreună cu octeții din care a fost construită, și este eliberată când numele cerut se schimbă sau când shaper-ul este distrus
Întregul șir este predat către HarfBuzz cu run-ul marcat în interiorul său, astfel încât scripturile cu ligatură văd totuși caracterele de pe ambele părți și aleg formele contextuale corecte
Avansurile și offseturile sunt returnate în puncte, convertite din valorile în virgulă fixă 26.6 raportate de HarfBuzz
Pozițiile clusterelor sunt indexuri logice în textul sursă, iar lungimile de cluster provin din distanța până la începutul clusterului următor, în oricare dintre direcțiile de lectură
Numărul de runs este plafonat de Options.MaxRuns, iar Options.Direction aplică ptdLeftToRight și ptdRightToLeft pe o direcție fixă de paragraf, orice altceva fiind rezolvat automat
Shaped.FontData reține octeții returnați de rezolvator, exact ceea ce are nevoie TPdf.AddShapedText pentru a construi un font CID

Unitatea FPdfTextShapingHb