Skip to contents

Load a CID Type 2 (composite TrueType) font with explicit mappings

Source: R/api_completion.R
pdf_font_load_cidtype2.Rd

Wraps FPDFText_LoadCidType2Font. The CID Type 2 path is a specialisation of pdf_font_load() that takes explicit ToUnicode CMap and CID-to-GID mapping tables — useful for embedding fonts whose glyph indexing differs from the default CID identity mapping (e.g. East Asian fonts with custom GID lookups).

Usage

pdf_font_load_cidtype2(
  doc,
  font_data,
  to_unicode_cmap = "",
  cid_to_gid = raw(0)
)

Arguments

doc

A pdfium_doc opened with readwrite = TRUE.

font_data

Either a raw vector of TTF bytes or a path to a TTF file on disk.

to_unicode_cmap

Character scalar — the CMap content as a PostScript-style CMap string. Empty string "" uses PDFium's default.

cid_to_gid

Raw vector — the CID-to-GID mapping table (big-endian uint16 pairs). raw(0) uses the identity mapping.

Value

A pdfium_font handle.

Details

For ordinary TTF embedding, pdf_font_load() with cid = TRUE is usually all you need.

See also

pdf_font_load() for the simpler TTF path.