Struct FontCollection 

pub struct FontCollection { /* private fields */ }

FontCollection owns registered faces and sources for resolving missing fonts.

Paragraph building consults sources in order and registers their answers. Unanswered requests accumulate until Self::take_unanswered is called.

Implementations

impl FontCollection

pub fn new() -> FontCollection

new creates an empty collection with no font sources.

pub fn faces(&self) -> &FaceSet

faces returns the faces currently registered in the collection.

A built paragraph clones this set and remains independent of later changes.

pub fn register(&mut self, family: &str, bytes: Vec<u8>) -> Option<FontId>

register adds font bytes under a family, with the weight, slant and width the file declares.

The face answers only to family, as FaceSet::register describes. It returns None when face zero cannot be parsed.

pub fn add(&mut self, font: Font) -> FontId

add registers an already parsed font.

pub fn add_fallback(&mut self, id: FontId)

add_fallback appends a registered font to the global fallback order.

id must belong to this collection.

pub fn get(&self, id: FontId) -> &Font

get returns a registered font by identifier.

Panics

Panics if id does not belong to this collection.

pub fn len(&self) -> usize

len returns the number of registered fonts.

pub fn family(&self, name: &str) -> Option<FontId>

family returns the first font matching a family name or alias.

pub fn add_source(&mut self, source: impl FontSource + 'static)

add_source appends a source consulted when registered fonts cannot satisfy a request.

pub fn add_boxed_source(&mut self, source: Box<dyn FontSource>)

add_boxed_source appends an already boxed font source.

pub fn is_empty(&self) -> bool

is_empty reports whether no fonts are currently registered.

pub fn adopt_faces(&mut self, faces: FaceSet)

adopt_faces replaces the registered faces with a prepared set.

This supports hosts that answer FontDemand using FaceSet::grown_by.

pub fn take_unanswered(&mut self) -> FontDemand

take_unanswered drains font requests that no source could satisfy.

Hosts may load and Self::register matching fonts before rebuilding affected paragraphs.

pub fn require_family(&mut self, name: &str) -> bool

require_family makes sure the family name has a face, asking the sources when none is registered.

The sources are asked in order and what they answer is registered (Skia’s findTypefaces walking its managers). It returns false when nobody had the family, and records the miss for Self::take_unanswered.

pub fn require_codepoint( &mut self, families: &[String], codepoint: char, attrs: FontAttrs, ) -> bool

require_codepoint makes sure a face that families and attrs resolve to covers codepoint, asking the sources for a fallback face when none does.

It is the per-character half of Self::require_family (Skia’s defaultFallback(unicode, ..)): false means no source covered the character, and the miss is recorded for Self::take_unanswered.

Trait Implementations

impl Default for FontCollection

fn default() -> FontCollection

Returns the “default value” for a type.