Struct ZplEngine 

pub struct ZplEngine { /* private fields */ }

The main entry point for processing and rendering ZPL labels.

ZplEngine holds the parsed instructions, label dimensions, and configuration required to render a label using a specific backend.

Implementations

impl ZplEngine

pub fn new( zpl: &str, width: Unit, height: Unit, resolution: Resolution, ) -> ZplResult<Self>

Creates a new ZplEngine instance by parsing a ZPL string.

Arguments

• zpl - The raw ZPL string to parse.
• width - The physical width of the label.
• height - The physical height of the label.
• resolution - The printing resolution (DPI).

Errors

Returns an error if the ZPL is invalid or if the instruction building fails.

pub fn set_fonts(&mut self, fonts: Arc<FontManager>)

Sets the font manager to be used during rendering.

If no font manager is provided, a default one will be used.

pub fn render<B: ZplForgeBackend>( &self, backend: B, variables: &HashMap<String, String>, ) -> ZplResult<Vec<u8>>

Renders the parsed instructions using the provided backend.

Arguments

• backend - An implementation of ZplForgeBackend (e.g., PNG, PDF).
• variables - A map of template variables to replace in text fields (format: {{key}}).

Errors

Returns an error if rendering fails at the backend level.

Trait Implementations

impl Debug for ZplEngine

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

Formats the value using the given formatter.