Struct FontRegistry

pub struct FontRegistry { /* private fields */ }

A loaded font registry: the theme’s declared families materialised into live fontdue::Font handles, indexed by family id / weight / style.

Implementations

impl FontRegistry

pub fn new() -> Self

Create an empty registry. Use Self::insert / Self::set_fallbacks to populate it, or Self::from_families to load a whole theme in one go.

pub fn insert( &mut self, family: impl Into<String>, weight: u16, style: FontStyle, font: Arc<Font>, )

Register a single font source.

pub fn set_fallbacks(&mut self, family: impl Into<String>, chain: Vec<String>)

Set the fallback chain for a family.

pub fn len(&self) -> usize

Number of loaded sources across all families. Useful in tests.

pub fn is_empty(&self) -> bool

Whether the registry has no sources loaded.

pub fn resolve( &self, family: &str, weight: u16, style: FontStyle, ) -> Option<Arc<Font>>

Resolve a triple to a loaded [Font]. See the module docs for the precedence order.

pub fn from_families( families: &HashMap<String, FontFamilyDef>, ) -> Result<Self, FontLoadError>

Load every source declared in families into the registry.

families is keyed by family id (the string the theme JSON uses in fonts.<id> and that super::FontRef::Named references). The family’s name field is carried for human display only; lookups go through the id.

pub fn from_families_lenient(families: &HashMap<String, FontFamilyDef>) -> Self

Like Self::from_families but tolerant: sources that fail to load are logged via eprintln! and skipped instead of aborting the whole registry build. Intended for the runtime path where a missing TTF on a user’s machine should degrade to “fall back to system font for that weight” rather than crash the shell.

Returns a registry that may be partial — callers cannot assume any specific weight is loaded, only that what COULD be loaded is loaded. Font resolution’s fallback ladder (family → closest weight → fallback chain → Canvas::font) handles the gaps gracefully.

Trait Implementations

impl Debug for FontRegistry

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

Formats the value using the given formatter.

impl Default for FontRegistry

fn default() -> FontRegistry

Returns the “default value” for a type.