Struct FontOptions 

pub struct FontOptions {
    pub include_system_fonts: bool,
    pub custom_paths: Vec<PathBuf>,
}

Options for font initialization.

Use this to customize font loading behavior when calling init_fonts_with_options.

Example

use typst_batch::{FontOptions, init_fonts_with_options};
use std::path::Path;

let options = FontOptions::new()
    .with_system_fonts(true)
    .with_custom_paths(&[
        Path::new("assets/fonts"),
        Path::new("content/fonts"),
    ]);

init_fonts_with_options(&options);

Fields

include_system_fonts: bool

Whether to include system fonts.

custom_paths: Vec<PathBuf>

Custom font directories to search.

Implementations

impl FontOptions

pub fn new() -> Self

Create new font options with default settings.

Default:

• System fonts: enabled
• Custom paths: empty

pub fn with_system_fonts(self, include: bool) -> Self

Set whether to include system fonts.

Disabling system fonts can speed up initialization in controlled environments where only specific fonts are needed.

pub fn with_custom_paths(self, paths: &[&Path]) -> Self

Set custom font paths to search.

These directories are searched for .ttf, .otf, and other font files.

pub fn add_path(self, path: impl AsRef<Path>) -> Self

Add a single custom font path.

Trait Implementations

impl Clone for FontOptions

fn clone(&self) -> FontOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FontOptions

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

Formats the value using the given formatter.

impl Default for FontOptions

fn default() -> FontOptions

Returns the “default value” for a type.