Struct Substitute 

pub struct Substitute<'a> {
    pub alias: &'a Name,
    pub dict: &'a Dict,
    pub font: &'a Font,
}

One second face: the resource name it is filed under, the dictionary the appearance’s /Resources /Font carries, and the loaded face itself.

A borrow of what FormFonts already holds. The three travel together because a generator needs all three to write one character — the alias for the Tf, the face for the width, and the dictionary so the name resolves when the stream is drawn.

use pdfrum_doc::ap::FormFonts;
use pdfrum_object::{Dict, NoResolve};

// A catalog with no `/AcroForm` still yields the stock fallback face.
let mut ctx = pdfrum_page::BuildContext::new();
let fonts = FormFonts::load(&Dict::default(), &NoResolve, &mut ctx);
use pdfrum_font::Charset;

// A second face for the characters the `/DA` font cannot write.
if let Some(substitute) = fonts.substitute(Charset::ShiftJis) {
    // The alias is the `Tf` name and the key in the appearance's
    // own `/Resources /Font`.
    assert!(!substitute.alias.as_bytes().is_empty());
}

Fields

alias: &'a Name

The Tf name, and the key in the appearance’s font resources.

dict: &'a Dict

The font dictionary that key maps to.

font: &'a Font

The loaded face, for widths and for the codes it can write.

Trait Implementations

impl<'a> Clone for Substitute<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for Substitute<'a>

impl<'a> Debug for Substitute<'a>

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

Formats the value using the given formatter.