Struct bookbinder_common::fonts::LIMITED_FONT_DB

pub struct LIMITED_FONT_DB { /* fields omitted */ }

a minimal font db containing default sans and serif fonts which are guaranteed to be present

Methods from Deref<Target = Database>

pub fn is_empty(&self) -> bool

Returns true if the Database contains no font faces.

pub fn len(&self) -> usize

Returns the number of font faces in the Database.

Note that Database stores font faces, not fonts. For example, if a caller will try to load a font collection (*.ttc) that contains 5 faces, then the Database will load 5 font faces and this method will return 5, not 1.

pub fn query(&self, query: &Query<'_>) -> Option<ID>

Performs a CSS-like query and returns the best matched font face.

pub fn faces(&self) -> &[FaceInfo]

Returns a reference to an internal storage.

This can be used for manual font matching.

pub fn face(&self, id: ID) -> Option<&FaceInfo>

Selects a FaceInfo by id.

Returns None if a face with such ID was already removed, or this ID belong to the other Database.

pub fn face_source(&self, id: ID) -> Option<(Arc<Source>, u32)>

Returns font face storage and the face index by ID.

pub fn with_face_data<P, T>(&self, id: ID, p: P) -> Option<T> where
    P: FnOnce(&[u8], u32) -> T, 

Executes a closure with a font's data.

We can't return a reference to a font binary data because of lifetimes. So instead, you can use this method to process font's data.

The closure accepts raw font data and font face index.

In case of Source::File, the font file will be memory mapped.

Returns None when font file loading failed.

Example

let is_variable = db.with_font_data(id, |font_data, face_index| {
    let font = ttf_parser::Font::from_data(font_data, face_index).unwrap();
    font.is_variable()
})?;

Trait Implementations

impl Deref for LIMITED_FONT_DB

type Target = Database

The resulting type after dereferencing.

fn deref(&self) -> &Database

Dereferences the value.

impl LazyStatic for LIMITED_FONT_DB

fn initialize(lazy: &Self)