Struct FontLoadOptions 

pub struct FontLoadOptions {
    pub mode: FontLoadMode,
    pub external_dirs: Vec<PathBuf>,
    pub asset_paths: Vec<SharedString>,
    pub embedded_fonts: Vec<EmbeddedFont>,
    pub required_families: Vec<SharedString>,
}

Options used by load_app_fonts to combine embedded and mounted fonts.

Fields

mode: FontLoadMode

Resource selection policy.

external_dirs: Vec<PathBuf>

External directories scanned recursively for supported font files.

asset_paths: Vec<SharedString>

Font asset paths resolved through the current GPUI gpui::AssetSource.

embedded_fonts: Vec<EmbeddedFont>

Embedded fallback fonts bundled into the executable.

required_families: Vec<SharedString>

Family names that must be visible after loading.

This is stronger than checking FontLoadReport.loaded: a GPUI backend can accept bytes and still fail to expose a family if the file format is not supported on that platform.

Implementations

impl FontLoadOptions

pub fn new(mode: FontLoadMode) -> Self

Creates an option set for the supplied resource mode.

pub fn external_dir(self, dir: impl Into<PathBuf>) -> Self

Adds a recursively scanned external font directory.

pub fn asset_path(self, path: impl Into<SharedString>) -> Self

Adds a GPUI asset path such as "fonts/PingFangSC-Regular.ttf".

pub fn embedded( self, name: impl Into<SharedString>, bytes: impl Into<Cow<'static, [u8]>>, ) -> Self

Adds one embedded font file to the fallback set.

pub fn require_family(self, family: impl Into<SharedString>) -> Self

Requires a family name to be visible after loading completes.

ExternalThenEmbedded uses this list to decide whether external files really satisfied the selected typography. If an external source returns Ok(()) but the family is still absent, embedded fallback fonts are tried before the final report is produced.

Trait Implementations

impl Clone for FontLoadOptions

fn clone(&self) -> FontLoadOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FontLoadOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for FontLoadOptions

fn default() -> FontLoadOptions

Returns the “default value” for a type.