FPdfTextShaping - PDFium Delphi Component

Unit: FPdfTextShaping

Vormt bidirectionele Unicode-tekst tot visuele glyph-runs voor TPdf.AddShapedText, met begrensde invoer- en uitvoerafmetingen en een uitbreidbare shaper-basisklasse

Workflow

API	Purpose
`ShapePdfText(Text, FontName, FontSize, Direction, out Shaped)`	Vormt tekst met de ingebouwde Windows Uniscribe-implementatie en standaard resourcelimieten
`TPdfTextShaper.Shape`	Abstract vormingscontract voor eigen engines die glyph-identificatoren, clusters, visuele runs, advances en geselecteerde lettertypedata teruggeven
`TPdfUniscribeTextShaper.Shape`	Gebruikt `usp10.dll` om tekst-runs te itemiseren, te vormen, te plaatsen en visueel te herschikken
`TPdfTextShapingOptions.Default`	Geeft automatische richting terug met limieten van 1,000,000 tekens, 2,000,000 glyphs en 100,000 runs
`ConfigureTextShaper(Shaper)`	Installeert de shaping-backend die de unit gebruikt en vervangt de ingebouwde voor de rest van het proces; de unit wordt eigenaar van de instantie
`ClearTextShaper`	Verwijdert een geïnstalleerde backend en gaat terug naar de platformstandaard
`ActiveTextShaper`	De backend die momenteel in gebruik is, of nil wanneer er op dit platform geen shaper beschikbaar is
`ActiveTextShaperName`	De naam die de actieve backend rapporteert, voor logging en om de ene inzet van de andere te onderscheiden

Public types

Type	Description
`EPdfTextShapingError`	Exceptie die wordt opgeworpen bij ongeldige invoer, schendingen van resourcelimieten, fouten in lettertypedata of fouten in de vormingsengine
`TPdfTextDirection`	`ptdAuto`, `ptdLeftToRight` of `ptdRightToLeft`
`TPdfShapedGlyph`	Eén glyph met `GlyphID`, `Advance`, `OffsetX`, `OffsetY`, `ClusterStart` en `ClusterLength`
`TPdfShapedGlyphs`	Dynamische array van `TPdfShapedGlyph`-records
`TPdfShapedRun`	Eén visuele run met `TextStart`, `TextLength`, `VisualX`, `Width`, `BidiLevel`, `IsRightToLeft` en `Glyphs`
`TPdfShapedRuns`	Dynamische array van `TPdfShapedRun`-records in visuele volgorde
`TPdfShapedText`	Brontekst `Text`, geselecteerde `FontName`, `FontSize`, ingebedde `FontData`, gevormde `Runs`, totale `Width`, `GlyphCount` en `LogicalCharacterCount`
`TPdfTextShapingOptions`	Resourcelimieten `Direction`, `MaxCharacters`, `MaxGlyphs` en `MaxRuns`
`TPdfTextShaper`	Abstracte basisklasse voor een door de aanroeper geleverde vormingsimplementatie
`TPdfUniscribeTextShaper`	Ingebouwde Windows-implementatie van `TPdfTextShaper`

Remarks

ptdAuto onderzoekt de brontekst op het eerste sterke richtingsteken
Clusterposities gebruiken logische brontekstindexen, terwijl Runs in visuele volgorde worden teruggegeven
FontData bevat de geselecteerde lettertypebytes die TPdf.AddShapedText nodig heeft om een CID-lettertype aan te maken
Gebruik een eigen TPdfTextShaper wanneer vorming op een niet-Windowsplatform of via een andere vormingsengine moet plaatsvinden
Uniscribe is de ingebouwde backend op Windows en wordt automatisch geïnstalleerd; elders is ActiveTextShaper nil totdat ConfigureTextShaper er een aanlevert, en FPdfTextShapingHb biedt voor dat geval een HarfBuzz-backend

Example

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

FPdfTextShaping unit

Unit: FPdfTextShaping

Workflow

Public types

Remarks

Example

See Also