Struct FontStack 

pub struct FontStack { /* private fields */ }

Fonts the application shipped, tried a glyph at a time in the order given.

A family is the faces of one typeface, a file for each weight or style. Text in a stack is set in the first family, and each letter that family has no glyph for comes from the next family that has one, the way CSS reads font-family: Inter, Pretendard. Letters no family has come from the machine’s own fonts. Within a family the face is picked by the weight and style the text asks for, which each face’s file says for itself.

A stack is registered once and named by id, so a theme can make it the font of every role and stay Copy:

static INTER_REGULAR: &[u8] = include_bytes!("../assets/fonts/Inter-Regular.otf");
static INTER_BOLD: &[u8] = include_bytes!("../assets/fonts/Inter-Bold.otf");
static PRETENDARD_REGULAR: &[u8] = include_bytes!("../assets/fonts/Pretendard-Regular.otf");

let latin = [asset(AssetKind::Font, INTER_REGULAR), asset(AssetKind::Font, INTER_BOLD)];
let korean = [asset(AssetKind::Font, PRETENDARD_REGULAR)];
let stack = FontStack::new().family(latin).family(korean).register();
let theme = Theme::adaptive(DesignSystem::Material3).with_default_font(stack);

The faces have to be registered before the stack that names them, which the order above gives for free. A stack naming an id that is not a registered face is reported by the Renderer, and that face is left out.

Implementations

impl FontStack

pub fn new() -> Self

pub fn family(self, faces: impl IntoIterator<Item = u32>) -> Self

Adds one family, tried after every family added before it. An empty family is left out, and so is anything past MAX_FONT_STACK_FAMILIES families or MAX_FONT_STACK_FACES faces.

pub fn families(&self) -> &[Vec<u32>]

The families, in the order they are tried.

pub fn to_bytes(&self) -> Vec<u8>

The asset bytes: the magic, the version, then the families.

pub fn from_bytes(bytes: &[u8]) -> Option<Self>

Reads bytes FontStack::to_bytes wrote, or None for anything else.

pub fn register(&self) -> u32

Registers the stack and returns the id a theme or a font list names it by.

The same stack registered twice is one registration, as with any asset, so this can run in a component body.

Trait Implementations

impl Clone for FontStack

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FontStack

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

Formats the value using the given formatter.

impl Default for FontStack

fn default() -> Self

Returns the “default value” for a type.

impl Eq for FontStack

impl PartialEq for FontStack

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for FontStack