Struct Tile 

pub struct Tile { /* private fields */ }

A single drawable tile in the terminal grid.

Each tile occupies one cell on a single layer; a Grid holds up to 256 independent layers of tiles per cell, composited bottom-to-top. Sub-cell pixel offsets (dx, dy) are visual only, they do not affect grid logic or hit-testing. Backends that cannot represent pixel offsets (e.g. CrosstermBackend) ignore them.

A tile does not carry its own multi-codepoint grapheme text (see TileFlags::HAS_EXTRA): that lives in a sparse side-table on the owning Grid, keeping every Tile a small, fully Copy value regardless of whether the egc feature is enabled. Read it back via Grid::grapheme.

Implementations

impl Tile

pub fn new(glyph: char, style: Style) -> Self

Creates a new tile with the given glyph and style.

dx and dy default to 0 (no sub-cell offset). glyph’s display width is computed once here (see width) rather than on every render.

pub const fn glyph(&self) -> char

Returns the tile’s glyph (primary codepoint).

pub const fn width(&self) -> u16

Returns the precomputed display (column) width of glyph.

Computed once when the glyph is written (see with_glyph and Grid::write_grapheme), not recomputed on every render. For tiles written via write_grapheme, this reflects the full grapheme cluster’s width, not just the primary codepoint’s.

pub const fn style(&self) -> Style

Returns the tile’s style.

pub const fn dx(&self) -> i16

Returns the sub-cell pixel X offset.

pub const fn dy(&self) -> i16

Returns the sub-cell pixel Y offset.

pub const fn flags(&self) -> TileFlags

Returns the wide-character flags for this tile.

pub const fn is_empty(&self) -> bool

Returns true if nothing has been written to this tile.

Empty tiles are transparent when compositing layers. An explicit space (e.g. Tile::new(' ', style)) is not empty.

pub fn with_glyph(self, glyph: char) -> Self

Sets the glyph for this tile (builder style).

Writing content marks the tile non-empty (see is_empty). Recomputes the cached display width (see width) for the new glyph.

pub const fn with_style(self, style: Style) -> Self

Sets the style for this tile (builder style).

Writing content marks the tile non-empty (see is_empty).

pub const fn with_offset(self, dx: i16, dy: i16) -> Self

Sets the sub-cell pixel offset for this tile (builder style).

Writing content marks the tile non-empty (see is_empty).

Trait Implementations

impl Clone for Tile

fn clone(&self) -> Tile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Tile

impl Debug for Tile

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

Formats the value using the given formatter.

impl Default for Tile

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Tile

impl Hash for Tile

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Tile

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Tile