FPdfTextShaping - PDFium Delphi Component

Unità: FPdfTextShaping

Trasforma il testo Unicode bidirezionale in run di glifi visivi per TPdf.AddShapedText, con dimensioni di input e output delimitate e una classe base di shaper estensibile

Flusso di lavoro

API	Scopo
`ShapePdfText(Text, FontName, FontSize, Direction, out Shaped)`	Esegue lo shaping del testo con l'implementazione Uniscribe di Windows integrata e i limiti di risorsa predefiniti
`TPdfTextShaper.Shape`	Contratto astratto di shaping per motori personalizzati che restituiscono identificatori di glifi, cluster, run visivi, avanzamenti e dati del font selezionato
`TPdfUniscribeTextShaper.Shape`	Usa `usp10.dll` per suddividere, plasmare, posizionare e riordinare visivamente i run di testo
`TPdfTextShapingOptions.Default`	Restituisce direzione automatica con limiti di 1.000.000 caratteri, 2.000.000 glifi e 100.000 run
`ConfigureTextShaper(Shaper)`	Installa il backend di shaping usato dall'unità, sostituendo quello integrato per il resto del processo; l'unità acquisisce la proprietà dell'istanza
`ClearTextShaper`	Rimuove un backend installato e torna al default della piattaforma
`ActiveTextShaper`	Il backend attualmente in uso, oppure nil quando sulla piattaforma non è disponibile alcuno shaper
`ActiveTextShaperName`	Il nome riportato dal backend attivo, per il logging e per distinguere una distribuzione dall'altra

Tipi pubblici

Tipo	Descrizione
`EPdfTextShapingError`	Eccezione generata per input non validi, violazioni dei limiti di risorsa, errori sui dati dei font o errori del motore di shaping
`TPdfTextDirection`	`ptdAuto`, `ptdLeftToRight` o `ptdRightToLeft`
`TPdfShapedGlyph`	Un glifo con `GlyphID`, `Advance`, `OffsetX`, `OffsetY`, `ClusterStart` e `ClusterLength`
`TPdfShapedGlyphs`	Array dinamico di record `TPdfShapedGlyph`
`TPdfShapedRun`	Un run visivo con `TextStart`, `TextLength`, `VisualX`, `Width`, `BidiLevel`, `IsRightToLeft` e `Glyphs`
`TPdfShapedRuns`	Array dinamico di record `TPdfShapedRun` in ordine visivo
`TPdfShapedText`	`Text` sorgente, `FontName` e `FontSize` selezionati, `FontData` incorporato, `Runs` plasmati, `Width` totale, `GlyphCount` e `LogicalCharacterCount`
`TPdfTextShapingOptions`	Limiti di risorsa `Direction`, `MaxCharacters`, `MaxGlyphs` e `MaxRuns`
`TPdfTextShaper`	Classe base astratta per un'implementazione di shaping fornita dal chiamante
`TPdfUniscribeTextShaper`	Implementazione Windows integrata di `TPdfTextShaper`

Osservazioni

ptdAuto esamina il testo sorgente alla ricerca del primo carattere direzionale forte
Le posizioni dei cluster usano indici logici del testo sorgente mentre i Runs vengono restituiti in ordine visivo
FontData contiene i byte del font selezionato richiesti da TPdf.AddShapedText per creare un font CID
Usa un TPdfTextShaper personalizzato quando lo shaping deve essere eseguito su una piattaforma non Windows o tramite un altro motore di shaping
Uniscribe è il backend integrato su Windows e viene installato automaticamente; altrove ActiveTextShaper è nil finché ConfigureTextShaper non ne fornisce uno, e FPdfTextShapingHb offre un backend HarfBuzz per quel caso

Esempio

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

Vedi anche

TPdf.AddShapedText