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

Padding in pixels around each glyph cell to prevent texture bleeding.

pub const CELLS_PER_SLICE: i32 = 32

Number of glyph cells per texture layer.

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>, ) -> Self

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<Self, SerializationError>

Deserializes a font atlas from binary format.

Arguments

• serialized - Binary data containing the serialized font atlas

Errors

Returns SerializationError if the binary data is malformed or cannot be deserialized.

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.

Errors

Returns SerializationError if serialization fails (e.g., a string field exceeds 255 bytes).

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

Formats the value using the given formatter.

impl Default for FontAtlasData

fn default() -> Self

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