Struct FontconfigSource

pub struct FontconfigSource { /* private fields */ }

A source that contains the fonts installed on the system, as reported by the Fontconfig library.

On macOS and Windows, the Cargo feature source-fontconfig can be used to opt into fontconfig support. To prefer it over the native font source (only if you know what you’re doing), use the source-fontconfig-default feature.

Implementations

impl FontconfigSource

pub fn new() -> FontconfigSource

Initializes Fontconfig and prepares it for queries.

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.

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 Default for FontconfigSource

fn default() -> Self

Returns the “default value” for a type.

impl Source for FontconfigSource

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.