bevy/crates/bevy_text/src/font.rs

use alloc::sync::Arc;

use bevy_asset::Asset;
use bevy_reflect::TypePath;

/// An [`Asset`] that contains the data for a loaded font, if loaded as an asset.
///
/// Loaded by [`FontLoader`](crate::FontLoader).
///
/// # A note on fonts
///
/// `Font` may differ from the everyday notion of what a "font" is.
/// A font *face* (e.g. Fira Sans Semibold Italic) is part of a font *family* (e.g. Fira Sans),
/// and is distinguished from other font faces in the same family
/// by its style (e.g. italic), its weight (e.g. bold) and its stretch (e.g. condensed).
///
/// Bevy currently loads a single font face as a single `Font` asset.
#[derive(Debug, TypePath, Clone, Asset)]
pub struct Font {
    /// Content of a font file as bytes
    pub data: Arc<Vec<u8>>,
}

impl Font {
    /// Creates a [`Font`] from bytes
    pub fn try_from_bytes(
        font_data: Vec<u8>,
    ) -> Result<Self, cosmic_text::ttf_parser::FaceParsingError> {
        use cosmic_text::ttf_parser;
        ttf_parser::Face::parse(&font_data, 0)?;
        Ok(Self {
            data: Arc::new(font_data),
        })
    }
}