Struct FcFontCache 

pub struct FcFontCache { /* private fields */ }

Font cache, initialized at startup.

Implementations

impl FcFontCache

pub fn resolve_font_chain( &self, font_families: &[String], weight: FcWeight, italic: PatternMatch, oblique: PatternMatch, trace: &mut Vec<TraceMsg>, ) -> FontFallbackChain

Resolve a fallback chain for a CSS font stack with the default script set.

pub fn resolve_font_chain_with_scripts( &self, font_families: &[String], weight: FcWeight, italic: PatternMatch, oblique: PatternMatch, scripts_hint: Option<&[UnicodeRange]>, _trace: &mut Vec<TraceMsg>, ) -> FontFallbackChain

Resolve a fallback chain, building script fallback groups for the requested unicode blocks.

pub fn compute_fallbacks( &self, font_id: &FontId, _trace: &mut Vec<TraceMsg>, ) -> Vec<FontMatchNoFallback>

Finds all registered fonts covering part of font_id’s coverage, ranked by closeness.

impl FcFontCache

pub fn fallback_config(&self) -> FcFallbackConfig

The fallback configuration this cache resolves with (a copy).

pub fn set_fallback_config(&self, config: FcFallbackConfig) -> &Self

Replace the fallback configuration.

pub fn with_fallback_config(self, config: FcFallbackConfig) -> Self

Builder-style set_fallback_config.

pub fn system_alias_prefs(&self, family: &str) -> Vec<String>

👎Deprecated since 5.0.0:

read fallback_config().generic_candidates(..) / substitutions_for(..)

The configured candidates for family: a generic keyword’s base.

pub fn expand_font_families_config_first( &self, families: &[String], os: OperatingSystem, unicode_ranges: &[UnicodeRange], ) -> Vec<String>

👎Deprecated since 5.0.0:

use fallback_config().candidate_families(families, ranges)

Expand a CSS stack through this cache’s configuration, filling gaps.

pub fn with_memory_fonts(&self, fonts: Vec<(FcPattern, FcFont)>) -> &Self

Adds in-memory font files.

pub fn with_memory_font_with_id( &self, id: FontId, pattern: FcPattern, font: FcFont, ) -> &Self

Adds a memory font with a specific ID (for testing).

pub fn insert_builder_font(&self, pattern: FcPattern, path: FcFontPath)

Register a newly-parsed on-disk font.

pub fn insert_fast_pattern( &self, pattern: FcPattern, path: FcFontPath, ) -> FontId

Insert a fast-probed pattern into the cache and return its.

pub fn lookup_paths_cached(&self, path: &str) -> Option<Vec<FontId>>

Every FontId registered from the file at path (one per face and.

pub fn get_font_by_id(&self, id: &FontId) -> Option<OwnedFontSource>

Get font data for a given font ID.

pub fn get_metadata_by_id(&self, id: &FontId) -> Option<FcPattern>

Get metadata for a font ID.

pub fn get_font_bytes(&self, id: &FontId) -> Option<Arc<FontBytes>>

Get the font bytes for id as a shared FontBytes.

pub fn build() -> Self

Scans system font directories using filename heuristics (no allsorts).

pub fn is_memory_font(&self, id: &FontId) -> bool

Check if a font ID is a memory font (preferred over disk fonts).

pub fn list(&self) -> Vec<(FcPattern, FontId)>

Every registered font with its pattern, in registration order.

pub fn for_each_pattern<F: FnMut(&FcPattern, &FontId)>(&self, f: F)

Visit every registered font without cloning.

pub fn is_empty(&self) -> bool

pub fn len(&self) -> usize

Number of registered fonts (one per face and name record).

pub fn query_with_fallback( &self, pattern: &FcPattern, trace: &mut Vec<TraceMsg>, ) -> Option<FontMatch>

Like FcFontCache::query, but total: it returns None only when the.

pub fn query( &self, pattern: &FcPattern, trace: &mut Vec<TraceMsg>, ) -> Option<FontMatch>

Queries a font from the in-memory cache, returns the first found font (early return).

pub fn get_memory_font(&self, id: &FontId) -> Option<FcFont>

Get in-memory font data (cloned out of the shared state).

pub fn query_matches_internal( k: &FcPattern, pattern: &FcPattern, trace: &mut Vec<TraceMsg>, ) -> bool

pub fn extract_font_name_tokens(name: &str) -> Vec<String>

Extract tokens from a font name.

pub fn calculate_unicode_coverage(ranges: &[UnicodeRange]) -> u64

Total coverage of ranges in codepoints (widths summed; callers.

pub fn normalize_unicode_ranges(ranges: Vec<UnicodeRange>) -> Vec<UnicodeRange>

Coalesce ranges into a sorted, disjoint set.

pub fn calculate_unicode_compatibility( requested: &[UnicodeRange], available: &[UnicodeRange], ) -> i32

Calculate how well a font’s Unicode ranges cover the requested ranges.

pub fn calculate_style_score(original: &FcPattern, candidate: &FcPattern) -> i32

Trait Implementations

impl Clone for FcFontCache

fn clone(&self) -> Self

Shallow clone — the returned handle shares the same underlying.

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

Performs copy-assignment from source.

impl Debug for FcFontCache

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

Formats the value using the given formatter.

impl Default for FcFontCache

fn default() -> Self

Returns the “default value” for a type.