Enum Handle 

pub enum Handle {
    Path {
        path: PathBuf,
        font_index: u32,
    },
    Memory {
        bytes: Arc<Vec<u8>>,
        font_index: u32,
    },
    Native {
        inner: Arc<dyn Any + Sync + Send>,
    },
}

Encapsulates the information needed to locate and open a font.

This is either the path to the font or the raw in-memory font data.

To open the font referenced by a handle, use a loader.

Variants

Path

A font on disk referenced by a path.

Fields

path: PathBuf

The path to the font.

font_index: u32

The index of the font, if the path refers to a collection.

If the path refers to a single font, this value will be 0.

Memory

A font in memory.

Fields

bytes: Arc<Vec<u8>>

The raw TrueType/OpenType/etc. data that makes up this font.

font_index: u32

The index of the font, if the memory consists of a collection.

If the memory consists of a single font, this value will be 0.

Native

An already-loaded font.

Fields

inner: Arc<dyn Any + Sync + Send>

Type-erased font storage. Use Self::from_native to retrieve the font object.

Implementations

impl Handle

pub fn from_path(path: PathBuf, font_index: u32) -> Handle

Creates a new handle from a path.

font_index specifies the index of the font to choose if the path points to a font collection. If the path points to a single font file, pass 0.

pub fn from_memory(bytes: Arc<Vec<u8>>, font_index: u32) -> Handle

Creates a new handle from raw TTF/OTF/etc. data in memory.

font_index specifies the index of the font to choose if the memory represents a font collection. If the memory represents a single font file, pass 0.

pub fn from_native<T: Loader>(inner: &T) -> Self

where T::NativeFont: Sync + Send,

Creates a new handle from a system handle.

pub fn native_as<T: 'static>(&self) -> Option<&T>

Retrieves a handle to the font object.

May return None if inner object is not of type T or if this handle does not contain a native font object.

pub fn load(&self) -> Result<Font, FontLoadingError>

A convenience method to load this handle with the default loader, producing a Font.

Trait Implementations

impl Clone for Handle

fn clone(&self) -> Handle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Handle

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

Formats the value using the given formatter.