FPdfTextShaping - PDFiumPas

Unit: FPdfTextShaping

Formerer todireksjonal Unicode-tekst til visuelle glyffruns for TPdf.AddShapedText, med begrensede inn- og utdatastørrelser og en utvidbar shaper-grunnklasse

Workflow

API	Purpose
`ShapePdfText(Text, FontName, FontSize, Direction, out Shaped)`	Formerer tekst med den innebygde Windows Uniscribe-implementasjonen og standard ressursgrenser
`TPdfTextShaper.Shape`	Abstrakt shaping-kontrakt for egendefinerte motorer som returnerer glyffidentifikatorer, klynger, visuelle runs, fremskritt og valgte fontdata
`TPdfUniscribeTextShaper.Shape`	Bruker `usp10.dll` til å segmentere, shape, plassere og visuelt stokke om tekstruns
`TPdfTextShapingOptions.Default`	Returnerer automatisk retning med grensene 1,000,000 tegn, 2,000,000 glyffer og 100,000 runs
`ConfigureTextShaper(Shaper)`	Installerer shaping-backend-en uniten bruker, og erstatter den innebygde for resten av prosessen; uniten tar eierskap til instansen
`ClearTextShaper`	Fjerner en installert backend og går tilbake til plattformstandarden
`ActiveTextShaper`	Backend-en som er i bruk for øyeblikket, eller nil når ingen shaper er tilgjengelig på denne plattformen
`ActiveTextShaperName`	Navnet den aktive backend-en rapporterer, for logging og for å skille ulike utrullinger fra hverandre

Public types

Type	Description
`EPdfTextShapingError`	Unntak som utløses ved ugyldige inndata, brudd på ressursgrensene, fontdatafeil eller feil i shaping-motoren
`TPdfTextDirection`	`ptdAuto`, `ptdLeftToRight` eller `ptdRightToLeft`
`TPdfShapedGlyph`	Én glyff med `GlyphID`, `Advance`, `OffsetX`, `OffsetY`, `ClusterStart` og `ClusterLength`
`TPdfShapedGlyphs`	Dynamisk array av `TPdfShapedGlyph`-records
`TPdfShapedRun`	Én visuell run med `TextStart`, `TextLength`, `VisualX`, `Width`, `BidiLevel`, `IsRightToLeft` og `Glyphs`
`TPdfShapedRuns`	Dynamisk array av `TPdfShapedRun`-records i visuell rekkefølge
`TPdfShapedText`	Kildeteksten `Text`, valgt `FontName`, `FontSize`, innebygd `FontData`, shapede `Runs`, total `Width`, `GlyphCount` og `LogicalCharacterCount`
`TPdfTextShapingOptions`	`Direction` samt ressursgrensene `MaxCharacters`, `MaxGlyphs` og `MaxRuns`
`TPdfTextShaper`	Abstrakt grunnklasse for en shaping-implementasjon levert av kalleren
`TPdfUniscribeTextShaper`	Innebygd Windows-implementasjon av `TPdfTextShaper`

Remarks

ptdAuto undersøker kildeteksten etter det første sterke retningsbestemte tegnet
Klyngeposisjoner bruker logiske indekser i kildeteksten, mens Runs returneres i visuell rekkefølge
FontData inneholder bytene for den valgte fonten som TPdf.AddShapedText trenger for å opprette en CID-font
Bruk en egendefinert TPdfTextShaper når shaping må kjøre på en ikke-Windows-plattform eller gjennom en annen shaping-motor
Uniscribe er innebygd backend på Windows og installeres automatisk; andre steder er ActiveTextShaper nil til ConfigureTextShaper leverer én, og FPdfTextShapingHb gir en HarfBuzz-backend for det tilfellet

Example

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

FPdfTextShaping-enhet

Unit: FPdfTextShaping

Workflow

Public types

Remarks

Example

See Also