Struct FontFallbackChain 

pub struct FontFallbackChain {
    pub css_fallbacks: Vec<CssFallbackGroup>,
    pub unicode_fallbacks: Vec<ScriptFallbackGroup>,
    pub last_resort: Vec<FontMatch>,
    pub original_stack: Vec<String>,
}

A resolved font fallback chain for one CSS font stack and style.

Fields

css_fallbacks: Vec<CssFallbackGroup>

The CSS stack, entry by entry.

unicode_fallbacks: Vec<ScriptFallbackGroup>

One group per requested script block that has any candidate. Fonts already reachable through css_fallbacks are not repeated here.

last_resort: Vec<FontMatch>

FcFallbackConfig::last_resort, resolved. The first entry is used for any character nothing above covers.

original_stack: Vec<String>

The stack as requested, unexpanded.

Implementations

impl FontFallbackChain

pub fn empty(stack: &[String]) -> Self

A chain that resolves nothing, for stack.

pub fn resolve_codepoint(&self, cp: u32) -> Option<(FontId, &str)>

Returns the resolved font for a given codepoint and the CSS fallback tier it came from.

pub fn resolve_char( &self, _cache: &FcFontCache, ch: char, ) -> Option<(FontId, String)>

Similar to resolve_codepoint, but takes a char and unused cache reference for backward compatibility with 4.x.

pub fn resolve_text( &self, cache: &FcFontCache, text: &str, ) -> Vec<(char, Option<(FontId, String)>)>

Per-character resolution of text.

pub fn query_for_text( &self, _cache: &FcFontCache, text: &str, ) -> Vec<ResolvedFontRun>

Split text into runs of consecutive characters that resolve to the same font. This is the shaping entry point: shape each run with its font. A run whose font_id is None has no font in the chain.

pub fn fonts(&self) -> impl Iterator<Item = &FontMatch>

Every font in the chain, in resolution order, each once.

Trait Implementations

impl Clone for FontFallbackChain

fn clone(&self) -> FontFallbackChain

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FontFallbackChain

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

Formats the value using the given formatter.

impl Eq for FontFallbackChain

impl PartialEq for FontFallbackChain

fn eq(&self, other: &FontFallbackChain) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for FontFallbackChain