Struct font_kit::sources::fs::FsSource

pub struct FsSource { /* private fields */ }

A source that loads fonts from a directory or directories on disk.

This source uses the WalkDir abstraction from the walkdir crate to locate fonts.

This is the native source on Android and OpenHarmony.

Implementations

impl FsSource

pub fn new() -> FsSource

Opens the default set of directories on this platform and indexes the fonts found within.

Do not rely on this function for systems other than Android or OpenHarmony. It makes a best effort to locate fonts in the typical platform directories, but it is too simple to pick up fonts that are stored in unusual locations but nevertheless properly installed.

pub fn in_path<P>(path: P) -> FsSource

where P: AsRef<Path>,

Indexes all fonts found in path

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.

This implementation 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 Default for FsSource

fn default() -> Self

Returns the “default value” for a type.

impl Source for FsSource

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.