Struct Font 

pub struct Font<'a> { /* private fields */ }

A loaded TrueType font

Implementations

impl<'a> Font<'a>

pub fn from_bytes(data: &'a [u8]) -> Result<Self>

Load a font from bytes

Arguments

• data - The font file data (must live as long as the Font)

Example

let font_data = include_bytes!("../tests/fonts/FiraMono-Medium.ttf");
let font = Font::from_bytes(font_data)?;

pub fn glyph_by_char(&self, c: char) -> Result<Glyph<'_>>

Get a glyph by character

Arguments

• c - The character to look up

Returns

The glyph for the character, or an error if not found

Example

let glyph = font.glyph_by_char('A')?;
println!("Advance: {}", glyph.advance);

pub fn glyph_by_id(&self, glyph_id: GlyphId, character: char) -> Glyph<'_>

Get a glyph by its glyph ID

This is useful when working with text shaping libraries or when you already have glyph IDs from other sources (e.g., rustybuzz, cosmic-text).

Arguments

• glyph_id - The glyph ID to look up
• character - The character this glyph represents (for display purposes)

Returns

A glyph with metrics and outline information

Example

use ttf_parser::GlyphId;

let glyph_id = GlyphId(42);
let glyph = font.glyph_by_id(glyph_id, 'A');

pub fn face(&self) -> &Face<'a>

Access the underlying ttf-parser Face for advanced operations

This allows you to use any ttf-parser functionality directly, such as accessing font tables, kerning information, or other font metadata that fontmesh doesn’t expose.

Example

// Get kerning between two glyphs
let face = font.face();
let kern = face.kerning_subtables();

// Access font name
for name in face.names() {
    println!("{:?}: {}", name.name_id, name.to_string());
}

pub fn units_per_em(&self) -> u16

Get the font’s units per em

pub fn ascender(&self) -> f32

Get the font’s ascender

pub fn descender(&self) -> f32

Get the font’s descender

pub fn line_gap(&self) -> f32

Get the font’s line gap

impl<'a> Font<'a>

pub fn glyph_to_mesh_2d(&self, character: char) -> Result<Mesh2D>

Convert a character glyph to a 2D triangle mesh

Uses default quality (20 subdivisions per curve).

Arguments

• character - The character to convert

Returns

A 2D triangle mesh

Example

let mesh = font.glyph_to_mesh_2d('A')?;
println!("Generated {} vertices", mesh.vertices.len());

pub fn glyph_to_mesh_3d(&self, character: char, depth: f32) -> Result<Mesh3D>

Convert a character glyph to a 3D triangle mesh with extrusion

Uses default quality (20 subdivisions per curve).

Arguments

• character - The character to convert
• depth - The extrusion depth

Returns

A 3D triangle mesh with normals

Example

let mesh = font.glyph_to_mesh_3d('A', 5.0)?;
println!("Generated {} triangles", mesh.triangle_count());