Struct font_kit::sources::multi::MultiSource

pub struct MultiSource {
    subsources: Vec<Box<dyn Source>>,
}

A source that encapsulates multiple sources and allows them to be queried as a group.

This is useful when an application wants a library of fonts consisting of the installed system fonts plus some other application-supplied fonts.

Fields

subsources: Vec<Box<dyn Source>>

Implementations

impl MultiSource

pub fn from_sources(subsources: Vec<Box<dyn Source>>) -> MultiSource

Creates a new source that contains all the fonts in the supplied sources.

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.

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.

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.

pub fn iter(&self) -> MultiIter<'_>

Returns an iterator over the contained sources.

pub fn iter_mut(&mut self) -> MultiIterMut<'_>

Returns an iterator over the contained sources with mutable access.

pub fn find_source<T: Source + 'static>(&self) -> Option<&T>

A convenience method to get the first source with the given type.

Returns None if no source of the given type was found.

pub fn find_source_mut<T: Source + 'static>(&mut self) -> Option<&mut T>

A convenience method to get the first source with the given type.

Returns None if no source of the given type was found.

Trait Implementations

impl Index<usize> for MultiSource

type Output = dyn Source

The returned type after indexing.

fn index(&self, idx: usize) -> &Self::Output

Performs the indexing (container[index]) operation.

impl IndexMut<usize> for MultiSource

fn index_mut(&mut self, idx: usize) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl Source for MultiSource

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.