Struct FontManager 

pub struct FontManager { /* private fields */ }

Manages fonts and their mapping to ZPL font identifiers.

This structure tracks registered fonts and maps them to the single-character identifiers used in ZPL commands (e.g., ‘^A0’, ‘^AA’).

Implementations

impl FontManager

pub fn get_font_bytes(&self, name: &str) -> Option<&[u8]>

Retrieves the raw TTF/OTF bytes for a font by its ZPL identifier.

This is used by backends that need the raw font data (e.g., PDF embedding).

pub fn get_font_name(&self, name: &str) -> Option<&str>

Returns the internal font name mapped to a ZPL identifier.

pub fn get_font(&self, name: &str) -> Option<&FontArc>

Retrieves a font by its ZPL identifier.

Arguments

• name - The ZPL font identifier (e.g., “0”, “A”).

pub fn register_font( &mut self, name: &str, bytes: &[u8], from: char, to: char, ) -> ZplResult<()>

Registers a new font and maps it to a range of ZPL identifiers.

Custom fonts must be in TrueType (.ttf) or OpenType (.otf) format. Once registered, the font can be used in ZPL commands like ^A or ^CF by referencing the assigned identifiers.

Arguments

• name - An internal name for the font.
• bytes - The raw TrueType/OpenType font data.
• from - The starting ZPL identifier in the range (A-Z, 0-9).
• to - The ending ZPL identifier in the range (A-Z, 0-9).

Errors

Returns an error if the font data is invalid.

Example

use zpl_forge::FontManager;

let mut font_manager = FontManager::default();

// Load your font file bytes
// let font_bytes = std::fs::read("fonts/Oswald-Regular.ttf")?;

// Register it for a range of ZPL identifiers (e.g., from 'A' to 'Z')
// font_manager.register_font("Oswald", &font_bytes, 'A', 'Z')?;

Trait Implementations

impl Clone for FontManager

fn clone(&self) -> FontManager

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FontManager

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

Formats the value using the given formatter.

impl Default for FontManager

fn default() -> Self

Creates a FontManager with a lightweight open-source default font registered for all identifiers (‘A’ to ‘9’).

Uses Inconsolata (SIL Open Font License) embedded directly in the binary, ensuring zero native dependencies on the host OS.