Struct FontMap 

pub struct FontMap { /* private fields */ }

Font encoding information extracted from a PDF document.

Maps font resource names to their ToUnicode CMap (if available), encoding type, and glyph widths.

Implementations

impl FontMap

pub fn from_page(doc: &Document, page_num: u32) -> Result<Self>

Build a font map from a page’s font resources in a lopdf Document.

pub fn empty() -> Self

Create an empty font map (no CMap decoding — raw byte fallback).

pub fn from_xobject_stream( doc: &Document, stream_id: ObjectId, page_fonts: &FontMap, ) -> Self

Build a FontMap from a Form XObject’s (or AP stream’s) own Resources/Font dictionary. The XObject’s fonts take priority over page_fonts so that character-code decoding uses the correct CMap for each stream.

Falls back to page_fonts for any name not found in the stream’s own Resources, and uses page_fonts as-is when the stream has no Resources.

pub fn decode_string(&self, font_name: &str, bytes: &[u8]) -> String

Decode a PDF string from a Tj/TJ operand using the font’s ToUnicode CMap.

pub fn build_reverse_map(&self, font_name: &str) -> HashMap<char, u32>

Build a reverse map (Unicode char → character code) for a font.

Priority:

1. ToUnicode CMap reverse map (most authoritative).
2. Differences/Encoding-based reverse map (for fonts without ToUnicode but with explicit Encoding/Differences, e.g. TeX OT1 fonts). Only populated for single-byte (Builtin) fonts.
3. Empty map — caller falls back to Latin-1.

Trait Implementations

impl Clone for FontMap

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FontMap

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.