Struct FontMesh 

pub struct FontMesh {
    pub data: Vec<u8>,
}

Asset containing font data for 3D text mesh generation.

This asset type holds the raw bytes of a TrueType font file. Fonts are automatically loaded from the asset server and used by the TextMesh component to generate 3D mesh geometry.

Loading Fonts

Fonts are loaded like any other Bevy asset:

let font: Handle<FontMesh> = asset_server.load("fonts/MyFont.ttf");

Place your font files in the assets/fonts/ directory (or any subdirectory of assets/).

Supported Formats

• TrueType (.ttf)

Note: Some OpenType fonts (.otf) with TrueType outlines are supported, but OpenType fonts with CFF/PostScript outlines are not (limitation of ttf-parser).

Fields

data: Vec<u8>

Raw font file data in TTF or OTF format.

Implementations

impl FontMesh

pub fn glyph_metrics(&self, character: char) -> Option<GlyphMetrics>

Get metrics for a specific character.

Returns None if the character is not in the font.

Example

if let Some(font) = font_assets.get(&font_handle) {
    if let Some(metrics) = font.glyph_metrics('A') {
        println!("Advance width of 'A': {}", metrics.advance);
    }
}

pub fn font_metrics(&self) -> Option<FontMetrics>

Get font-level metrics (ascender, descender, line height, etc.)

Returns None if the font data is invalid.

Example

if let Some(font) = font_assets.get(&font_handle) {
    if let Some(metrics) = font.font_metrics() {
        println!("Line height: {}", metrics.line_height);
    }
}

pub fn text_width(&self, text: &str) -> f32

Calculate the width of a text string.

This sums the advance widths of all characters. Does not account for kerning.

Example

if let Some(font) = font_assets.get(&font_handle) {
    let width = font.text_width("Hello");
    println!("Text width: {}", width);
}

pub fn char_positions(&self, text: &str) -> Vec<(usize, f32)>

Get character positions for a line of text.

Returns a vector of (char_index, x_position) pairs for each character. Useful for cursor positioning in text editors.

Example

if let Some(font) = font_assets.get(&font_handle) {
    let positions = font.char_positions("Hello");
    for (idx, x) in positions {
        println!("Char {} at x={}", idx, x);
    }
}

Trait Implementations

impl Debug for FontMesh

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

Formats the value using the given formatter.

impl TypePath for FontMesh

fn type_path() -> &'static str

Returns the fully qualified path of the underlying type.

fn short_type_path() -> &'static str

Returns a short, pretty-print enabled path to the type.

fn type_ident() -> Option<&'static str>

Returns the name of the type, or None if it is anonymous.

fn crate_name() -> Option<&'static str>

Returns the name of the crate the type is in, or None if it is anonymous.

fn module_path() -> Option<&'static str>

Returns the path to the module the type is in, or None if it is anonymous.

impl VisitAssetDependencies for FontMesh

fn visit_dependencies(&self, visit: &mut impl FnMut(UntypedAssetId))

impl Asset for FontMesh