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 using default attributes.

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.

Trait Implementations

impl Default for FontCollection

fn default() -> FontCollection

Returns the “default value” for a type.