Struct FontLibrary 

pub struct FontLibrary { /* private fields */ }

Library of loaded fonts

This is the type of the global singleton accessible via the library() function. Thread-safety is handled via internal locks.

Implementations

impl FontLibrary

Font management

pub fn resolver(&self) -> MutexGuard<'_, Resolver>

Get a reference to the font resolver

pub fn first_face_for(&self, font_id: FontId) -> Result<FaceId, InvalidFontId>

Get the first face for a font

Each font identifier has at least one font face. This resolves the first (default) one.

pub fn get_first_face( &self, font_id: FontId, ) -> Result<FaceRef<'_>, InvalidFontId>

Get the first face for a font

This is a wrapper around FontLibrary::first_face_for and FontLibrary::get_face.

pub fn contains_face( &self, font_id: FontId, face_id: FaceId, ) -> Result<bool, InvalidFontId>

Check whether a FaceId is part of a FontId

pub fn face_for_char( &self, font_id: FontId, last_face_id: Option<FaceId>, c: char, ) -> Result<Option<FaceId>, InvalidFontId>

Resolve the font face for a character

If last_face_id is a face used by font_id and this face covers c, then return last_face_id. (This is to avoid changing the font face unnecessarily, such as when encountering a space amid Arabic text.)

Otherwise, return the first face of font_id which covers c.

Otherwise (if no face covers c) return None.

pub fn select_font( &self, selector: &FontSelector, script: Script, ) -> Result<FontId, NoFontMatch>

Select a font

This method uses internal caching to enable fast look-ups of existing (loaded) fonts. Resolving new fonts may be slower.

impl FontLibrary

Face management

pub fn get_face(&self, id: FaceId) -> FaceRef<'static>

Get a font face from its identifier

Panics if id is not valid (required: id.get() < self.num_faces()).

pub fn get_face_store(&self, id: FaceId) -> &'static FaceStore

Get access to the FaceStore

Panics if id is not valid (required: id.get() < self.num_faces()).