Struct font_kit::sources::fs::FsSource

source ·
pub struct FsSource { /* private fields */ }
Expand description

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.

Implementations§

source§

impl FsSource

source

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. 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.

source

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

Returns paths of all fonts installed on the system.

source

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

Returns the names of all families installed on the system.

source

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.

source

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.

source

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§

source§

impl Source for FsSource

source§

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

Returns paths of all fonts installed on the system.
source§

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

Returns the names of all families installed on the system.
source§

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.
source§

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

Selects a font by PostScript name, which should be a unique identifier. Read more
source§

fn as_any(&self) -> &dyn Any

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

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.
source§

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.

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.