Struct FallbackFontChain 

pub struct FallbackFontChain<'a> { /* private fields */ }

Combines a primary BitmapFont with an ordered list of fallback fonts.

resolve tries the primary font’s char mapping first; on a miss, it tries each fallback font in order; only if every font in the chain misses does it fall back to the primary font’s solid-block glyph. This lets a caller layer, say, an ASCII or partial-coverage primary font with one or more broader fallback fonts, so a char missing from the primary doesn’t automatically become a solid block if some other font in the chain actually has it.

This type ships no bundled fallback font data – every font in the chain, primary or fallback, is supplied by the caller. Bundling a ready-to-use Latin-1/Extended fallback font is a natural follow-up now that this mechanism exists, but is out of scope here.

Callers who don’t need a fallback chain can keep using a bare BitmapFont and BitmapFont::char_to_index/BitmapFont::rows directly, exactly as before – this type is purely additive and opt-in.

Implementations

impl<'a> FallbackFontChain<'a>

pub const fn new(primary: BitmapFont, fallbacks: &'a [BitmapFont]) -> Self

Constructs a chain from a primary font and an ordered list of fallback fonts.

pub fn resolve(&self, ch: char) -> ResolvedGlyph

Resolves ch to a glyph, trying the primary font first, then each fallback font in order, only substituting the primary font’s solid-block glyph if every font in the chain misses.

Trait Implementations

impl<'a> Clone for FallbackFontChain<'a>

fn clone(&self) -> FallbackFontChain<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for FallbackFontChain<'a>

impl<'a> Debug for FallbackFontChain<'a>

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

Formats the value using the given formatter.