Struct font_kit::sources::mem::MemSource

pub struct MemSource { /* private fields */ }

A source that keeps fonts in memory.

Implementations

impl MemSource

pub fn empty() -> MemSource

Creates a new empty memory source.

pub fn from_fonts<I>(fonts: I) -> Result<MemSource, FontLoadingError>

where I: Iterator<Item = Handle>,

Creates a new memory source that contains the given set of font handles.

The fonts referenced by the handles are eagerly loaded into memory.

pub fn add_font(&mut self, handle: Handle) -> Result<Font, FontLoadingError>

Add an existing font handle to a MemSource.

Returns the font that was just added.

Note that adding fonts to an existing MemSource is slower than creating a new one from a Handle iterator, since this method sorts after every addition, rather than once at the end.

pub fn add_fonts( &mut self, handles: impl Iterator<Item = Handle>, ) -> Result<(), FontLoadingError>

Add a number of existing font handles to a MemSource.

Note that adding fonts to an existing MemSource is slower than creating a new one from a Handle iterator, because extra unnecessary sorting with occur with every call to this method.

pub fn all_fonts(&self) -> Result<Vec<Handle>, SelectionError>

Returns paths of all fonts installed on the system.

pub fn all_families(&self) -> Result<Vec<String>, SelectionError>

Returns the names of all families installed on the system.

pub fn select_family_by_name( &self, family_name: &str, ) -> Result<FamilyHandle, SelectionError>

Looks up a font family by name and returns the handles of all the fonts in that family.

FIXME(pcwalton): Case-insensitive comparison.

pub fn select_by_postscript_name( &self, postscript_name: &str, ) -> Result<Handle, SelectionError>

Selects a font by PostScript name, which should be a unique identifier.

The default implementation, which is used by the DirectWrite and the filesystem backends, does a brute-force search of installed fonts to find the one that matches.

pub fn select_best_match( &self, family_names: &[FamilyName], properties: &Properties, ) -> Result<Handle, SelectionError>

Performs font matching according to the CSS Fonts Level 3 specification and returns the handle.

Trait Implementations

impl Source for MemSource

fn all_fonts(&self) -> Result<Vec<Handle>, SelectionError>

Returns paths of all fonts installed on the system.

fn all_families(&self) -> Result<Vec<String>, SelectionError>

Returns the names of all families installed on the system.

fn select_family_by_name( &self, family_name: &str, ) -> Result<FamilyHandle, SelectionError>

Looks up a font family by name and returns the handles of all the fonts in that family.

fn select_by_postscript_name( &self, postscript_name: &str, ) -> Result<Handle, SelectionError>

Selects a font by PostScript name, which should be a unique identifier.

fn as_any(&self) -> &dyn Any

Accesses this Source as Any, which allows downcasting back to a concrete type from a trait object.

fn as_mut_any(&mut self) -> &mut dyn Any

Accesses this Source as Any, which allows downcasting back to a concrete type from a trait object.

fn select_best_match( &self, family_names: &[FamilyName], properties: &Properties, ) -> Result<Handle, SelectionError>

Performs font matching according to the CSS Fonts Level 3 specification and returns the handle.