FPdfTextShaping - PDFium Delphi Component

Unit: FPdfTextShaping

Membentuk teks Unicode bidireksional menjadi visual glyph run untuk TPdf.AddShapedText, dengan ukuran masukan dan keluaran berbatas serta kelas dasar shaper yang dapat diperluas

Workflow

API	Purpose
`ShapePdfText(Text, FontName, FontSize, Direction, out Shaped)`	Membentuk teks dengan implementasi Uniscribe Windows bawaan dan batas sumber daya standar
`TPdfTextShaper.Shape`	Kontrak shaping abstrak untuk engine kustom yang mengembalikan identifier glyph, klaster, visual run, advance, dan data font terpilih
`TPdfUniscribeTextShaper.Shape`	Memakai `usp10.dll` untuk mengitemisasi, membentuk, menempatkan, dan mengurutkan ulang text run secara visual
`TPdfTextShapingOptions.Default`	Mengembalikan arah otomatis dengan batas 1,000,000 karakter, 2,000,000 glyph, dan 100,000 run
`ConfigureTextShaper(Shaper)`	Memasang backend shaping yang dipakai unit, menggantikan backend bawaan untuk sisa proses; unit mengambil kepemilikan atas instance tersebut
`ClearTextShaper`	Menghapus backend yang terpasang dan kembali ke bawaan platform
`ActiveTextShaper`	Backend yang sedang dipakai, atau nil ketika tidak ada shaper yang tersedia di platform ini
`ActiveTextShaperName`	Nama yang dilaporkan oleh backend aktif, untuk logging dan untuk membedakan satu deployment dari yang lain

Public types

Type	Description
`EPdfTextShapingError`	Exception yang dimunculkan untuk masukan tidak valid, pelanggaran batas sumber daya, kegagalan data font, atau kesalahan engine shaping
`TPdfTextDirection`	`ptdAuto`, `ptdLeftToRight`, atau `ptdRightToLeft`
`TPdfShapedGlyph`	Satu glyph dengan `GlyphID`, `Advance`, `OffsetX`, `OffsetY`, `ClusterStart`, dan `ClusterLength`
`TPdfShapedGlyphs`	Array dinamis dari record `TPdfShapedGlyph`
`TPdfShapedRun`	Satu visual run dengan `TextStart`, `TextLength`, `VisualX`, `Width`, `BidiLevel`, `IsRightToLeft`, dan `Glyphs`
`TPdfShapedRuns`	Array dinamis dari record `TPdfShapedRun` dalam urutan visual
`TPdfShapedText`	`Text` sumber, `FontName` dan `FontSize` terpilih, `FontData` tersemat, `Runs` hasil shaping, lebar total `Width`, `GlyphCount`, dan `LogicalCharacterCount`
`TPdfTextShapingOptions`	Batas sumber daya `Direction`, `MaxCharacters`, `MaxGlyphs`, dan `MaxRuns`
`TPdfTextShaper`	Kelas dasar abstrak untuk implementasi shaping yang disediakan pemanggil
`TPdfUniscribeTextShaper`	Implementasi Windows bawaan dari `TPdfTextShaper`

Remarks

ptdAuto memeriksa teks sumber untuk menemukan karakter berarah kuat pertama
Posisi klaster memakai indeks logis teks sumber sedangkan Runs dikembalikan dalam urutan visual
FontData berisi byte font terpilih yang dibutuhkan TPdf.AddShapedText untuk membuat font CID
Gunakan TPdfTextShaper kustom ketika shaping harus berjalan di platform non-Windows atau melalui engine shaping lain
Uniscribe adalah backend bawaan di Windows dan terpasang otomatis; di tempat lain ActiveTextShaper bernilai nil sampai ConfigureTextShaper menyediakannya, dan FPdfTextShapingHb menyediakan backend HarfBuzz untuk kasus tersebut

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