Struct FontAtlasData 

pub struct FontAtlasData { /* private fields */ }

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.

Implementations

impl FontAtlasData

pub const PADDING: i32 = 1

pub const CELLS_PER_SLICE: i32 = 32

pub fn new( font_name: CompactString, font_size: f32, max_halfwidth_base_glyph_id: u16, texture_dimensions: (i32, i32, i32), cell_size: CellSize, underline: LineDecoration, strikethrough: LineDecoration, glyphs: Vec<Glyph>, texture_data: Vec<u8>, ) -> FontAtlasData

Creates a new font atlas with the given parameters.

pub fn font_name(&self) -> &str

Returns the font name.

pub fn font_size(&self) -> f32

Returns the font size in points.

pub fn max_halfwidth_base_glyph_id(&self) -> u16

Returns the maximum halfwidth base glyph ID.

Fullwidth glyphs are assigned IDs starting from this value.

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

Returns the texture dimensions as (width, height, layers).

pub fn underline(&self) -> LineDecoration

Returns the underline decoration configuration.

pub fn strikethrough(&self) -> LineDecoration

Returns the strikethrough decoration configuration.

pub fn glyphs(&self) -> &[Glyph]

Returns a slice of all glyphs in the atlas.

pub fn texture_data(&self) -> &[u8]

Returns the raw texture data.

pub fn into_glyphs(self) -> Vec<Glyph>

Consumes the atlas and returns its glyphs.

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

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) -> Result<Vec<u8>, SerializationError>

Serializes the font atlas to binary format.

Returns

A byte vector containing the serialized font atlas data, or an error if serialization fails (e.g., a string field exceeds 255 bytes)

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) -> CellSize

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

The cell dimensions in pixels

Trait Implementations

impl Clone for FontAtlasData

fn clone(&self) -> FontAtlasData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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