FPdfTextShaping - PDFium Delphi Component

Unit: FPdfTextShaping

Tvaruje obojsmerný text Unicode do vizuálnych behov glyfov pre TPdf.AddShapedText, s ohraničenými veľkosťami vstupu a výstupu a rozšíriteľnou základnou triedou tvarovača

Workflow

API	Purpose
`ShapePdfText(Text, FontName, FontSize, Direction, out Shaped)`	Tvaruje text vstavanou implementáciou Windows Uniscribe s predvolenými limitmi zdrojov
`TPdfTextShaper.Shape`	Abstraktná zmluva tvarovania pre vlastné enginy, ktoré vracajú identifikátory glyfov, zhluky, vizuálne behy, posuny a vybrané dáta fontu
`TPdfUniscribeTextShaper.Shape`	Použije `usp10.dll` na rozčlenenie, tvarovanie, umiestnenie a vizuálne preusporiadanie behov textu
`TPdfTextShapingOptions.Default`	Vracia automatický smer s limitmi 1,000,000 znakov, 2,000,000 glyfov a 100,000 behov
`ConfigureTextShaper(Shaper)`	Inštaluje tvarovací backend, ktorý jednotka používa, a nahrádza vstavaný backend pre zvyšok procesu; jednotka preberá vlastníctvo inštancie
`ClearTextShaper`	Odstráni nainštalovaný backend a vráti sa k platformovému predvolenému
`ActiveTextShaper`	Backend, ktorý sa práve používa, alebo nil, keď na tejto platforme nie je dostupný žiadny tvarovač
`ActiveTextShaperName`	Názov, ktorý aktívny backend hlási, na logovanie a na odlíšenie jedného nasadenia od druhého

Public types

Type	Description
`EPdfTextShapingError`	Výnimka vyvolaná pri neplatných vstupoch, porušení limitov zdrojov, zlyhaniach dát fontu alebo chybách enginu tvarovania
`TPdfTextDirection`	`ptdAuto`, `ptdLeftToRight` alebo `ptdRightToLeft`
`TPdfShapedGlyph`	Jeden glyf s `GlyphID`, `Advance`, `OffsetX`, `OffsetY`, `ClusterStart` a `ClusterLength`
`TPdfShapedGlyphs`	Dynamické pole záznamov `TPdfShapedGlyph`
`TPdfShapedRun`	Jeden vizuálny beh s `TextStart`, `TextLength`, `VisualX`, `Width`, `BidiLevel`, `IsRightToLeft` a `Glyphs`
`TPdfShapedRuns`	Dynamické pole záznamov `TPdfShapedRun` vo vizuálnom poradí
`TPdfShapedText`	Zdrojový `Text`, vybraný `FontName`, `FontSize`, vložené `FontData`, vytvarované `Runs`, celková `Width`, `GlyphCount` a `LogicalCharacterCount`
`TPdfTextShapingOptions`	Limity zdrojov `Direction`, `MaxCharacters`, `MaxGlyphs` a `MaxRuns`
`TPdfTextShaper`	Abstraktná základná trieda pre implementáciu tvarovania dodanú volajúcim
`TPdfUniscribeTextShaper`	Vstavaná implementácia `TPdfTextShaper` pre Windows

Remarks

ptdAuto preskúma zdrojový text a nájde prvý silný smerový znak
Pozície zhlukov používajú logické indexy zdrojového textu, zatiaľ čo Runs sa vracajú vo vizuálnom poradí
FontData obsahuje bajty vybraného fontu, ktoré TPdf.AddShapedText potrebuje na vytvorenie CID fontu
Vlastný TPdfTextShaper použite, keď musí tvarovanie bežať na platforme inej než Windows alebo cez iný tvarovací engine
Uniscribe je vstavaný backend na Windows a inštaluje sa automaticky; inde je ActiveTextShaper nil, kým ConfigureTextShaper nedodá backend, a FPdfTextShapingHb pre ten prípad poskytuje backend HarfBuzz

Example

var
  Shaped: TPdfShapedText;
  MeasuredWidth: Single;
begin
  if ShapePdfText(Text, 'Segoe UI', 12, ptdAuto, Shaped) then
    MeasuredWidth := Shaped.Width;
end;

FPdfTextShaping jednotka

Unit: FPdfTextShaping

Workflow

Public types

Remarks

Example

See Also