PDFium Delphi Component Docs

AddCidType2Text metode

Component: TPdf  ·  Unit: PDFium

Syntax

function AddCidType2Text(const FontData: TBytes; const Glyphs: TPdfCidGlyphs; FontSize: Single; X, Y: Double; const Options: TPdfCidFontOptions; out Report: TPdfCidFontReport; Color: TColor = clBlack; Alpha: Byte = $FF): Boolean;

Description

Memuat data TrueType atau TrueType Collection yang disediakan pemanggil melalui loader font CID Type 2 native PDFium dan menambahkan satu atau lebih objek teks terposisi ke halaman aktif

Setiap TPdfCidGlyph menyediakan identifier glyph sumber, teks Unicode, advance, dan offset horizontal atau vertikal opsional

CID berurutan mengisolasi instance glyph yang berulang sehingga identifier glyph yang sama dapat membawa pemetaan klaster Unicode yang berbeda

Embedding and subsetting

pcfemFull menyematkan font terpilih secara lengkap, pcfemSubsetPreferred mencoba subset daftar glyph dan mundur ke font lengkap, dan pcfemSubsetRequired menolak operasi jika subset yang aman tidak dapat dihasilkan

Subsetting selalu mempertahankan glyph nol, menolak keluaran yang membuat font membesar, dan memverifikasi bahwa setiap GID asli yang diminta masih ada sebelum data sampai ke PDFium

TTCIndex memilih salah satu anggota TrueType Collection dan harus tetap nol untuk font mandiri

Unicode and verification

ToUnicode CMap yang dibangkitkan memetakan setiap CID berurutan ke UnicodeText yang disediakan, termasuk pemetaan ligatur multi-code-unit dan supplementary-plane

Pemetaan kosong menjadi U+200B sehingga setiap CID tetap dapat diekstrak dan diamati

Ketika VerifyExtraction diaktifkan, metode ini membuka kembali model teks halaman, membaca hanya objek yang disisipkan, membandingkan hasilnya dengan ExpectedText, dan mengembalikan semua objek yang disisipkan saat hasilnya tidak cocok

Options and report

TPdfCidFontOptions.Default memilih pcfemSubsetPreferred sebagai EmbeddingMode, memverifikasi ekstraksi, membatasi data font hingga 64 MiB, instance glyph hingga 65,534, dan MaxUnicodeCharacters hingga 1,048,576 unit kode Unicode terpetakan

TPdfCidFontReport mencatat jumlah glyph total dan UniqueGlyphCount, OriginalFontBytes dan EmbeddedFontBytes, SubsetAttempted, SubsetApplied, UsedFullFontFallback, SubsetErrorCode, FontEmbedded, teks yang diharapkan dan yang terekstrak, serta ExtractionMatches

Atomicity and performance

Posisi glyph dibangkitkan dalam waktu linear dan glyph yang berbagi satu baseline dipancarkan sebagai satu objek teks native

Offset vertikal yang berbeda memakai objek teks terisolasi sambil mempertahankan urutan objek logis

Validasi dan subsetting diselesaikan sebelum penyisipan, dan kegagalan native berikutnya menghapus setiap objek yang ditambahkan oleh panggilan ini sebelum konten halaman dibangkitkan ulang

See Also

BuildToUnicodeCMap, AddShapedText, AddText, GetStructuredText