Struct FontAtlasData 

pub struct FontAtlasData {
    pub font_name: CompactString,
    pub font_size: f32,
    pub max_halfwidth_base_glyph_id: u16,
    pub texture_dimensions: (i32, i32, i32),
    pub cell_size: (i32, i32),
    pub underline: LineDecoration,
    pub strikethrough: LineDecoration,
    pub glyphs: Vec<Glyph>,
    pub texture_data: Vec<u8>,
}

Font atlas data for GPU-accelerated terminal rendering.

Contains a pre-rasterized font atlas stored as a 2D texture array, where each layer holds 32 glyphs in a 1×32 grid. The atlas includes multiple font styles (normal, bold, italic, bold+italic) and full Unicode support including emoji.

Fields

font_name: CompactString

The name of the font

font_size: f32

The font size in points

max_halfwidth_base_glyph_id: u16

The number of single-cell (halfwidth) glyphs per layer, before fullwidth glyphs begin.

Fullwidth glyphs (e.g., CJK characters) are assigned IDs starting from this value, aligned to even boundaries. This allows the renderer to distinguish halfwidth from fullwidth glyphs by comparing against this threshold.

texture_dimensions: (i32, i32, i32)

Width, height and depth of the texture in pixels

cell_size: (i32, i32)

Width and height of each character cell

underline: LineDecoration

Underline configuration

strikethrough: LineDecoration

Strikethrough configuration

glyphs: Vec<Glyph>

The glyphs in the font

texture_data: Vec<u8>

The 3d texture data containing the font glyphs

Implementations

impl FontAtlasData

pub const PADDING: i32 = 1i32

pub const CELLS_PER_SLICE: i32 = 32i32

pub fn from_binary( serialized: &[u8], ) -> Result<FontAtlasData, FontAtlasDeserializationError>

Deserializes a font atlas from binary format.

Arguments

• serialized - Binary data containing the serialized font atlas

Returns

The deserialized font atlas or an error if deserialization fails

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

Serializes the font atlas to binary format.

Returns

A byte vector containing the serialized font atlas data

pub fn terminal_size( &self, viewport_width: i32, viewport_height: i32, ) -> (i32, i32)

Calculates how many terminal columns and rows fit in the given viewport dimensions.

Arguments

• viewport_width - Width of the viewport in pixels
• viewport_height - Height of the viewport in pixels

Returns

A tuple of (columns, rows) that fit in the viewport

pub fn cell_size(&self) -> (i32, i32)

Returns the padded terminal cell size.

The cell size includes padding (1 pixel on each side, 2 pixels total per dimension) to prevent texture bleeding artifacts during GPU rendering.

Returns

A tuple of (width, height) in pixels for each terminal cell

Trait Implementations

impl Debug for FontAtlasData

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

Formats the value using the given formatter.

impl Default for FontAtlasData

fn default() -> FontAtlasData

Returns the “default value” for a type.

impl PartialEq for FontAtlasData

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for FontAtlasData