Struct Tile 

pub struct Tile {
    pub(crate) glyph: char,
    pub(crate) style: Style,
    pub(crate) dx: i16,
    pub(crate) dy: i16,
    pub(crate) flags: TileFlags,
    pub(crate) extra: Option<Arc<String>>,
}

A single drawable tile in the terminal grid.

Each tile occupies one cell on a single layer (see ADR 008 for the layer model). 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.

Fields

glyph: char

Primary codepoint. For ASCII and most Unicode this is the whole story.

style: Style

Style applied to this tile.

dx: i16

Pixel offset from the cell’s left edge. Negative shifts left.

Only meaningful for graphical backends (e.g. SoftwareBackend).

dy: i16

Pixel offset from the cell’s top edge. Negative shifts up.

Only meaningful for graphical backends (e.g. SoftwareBackend).

flags: TileFlags

Wide-character role flags (e.g. TileFlags::WIDE_CHAR).

Only present when the egc feature is enabled.

extra: Option<Arc<String>>

Allocated only when the grapheme cluster has more than one codepoint (combining marks, ZWJ emoji sequences, etc.).

When Some, the full EGC string is stored here. The glyph field still holds the first codepoint for fast single-char paths.

Only present when the egc feature is enabled.

Implementations

impl Tile

pub const 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).

pub const fn glyph(&self) -> char

Returns the tile’s glyph (primary codepoint).

pub const fn style(&self) -> Style

Returns the tile’s style.

pub const fn flags(&self) -> TileFlags

Returns the wide-character flags for this tile.

Only present when the egc feature is enabled.

pub fn extra(&self) -> Option<&str>

Returns the extra EGC data for this tile, if any.

Some only for multi-codepoint grapheme clusters (combining marks, ZWJ sequences, etc.). None for the common single-codepoint case.

Only present when the egc feature is enabled.

pub fn grapheme(&self) -> Option<&str>

Returns the full grapheme cluster for this tile.

When the tile contains a multi-codepoint EGC (combining marks, ZWJ sequences, etc.) this returns the stored string. For the common single-codepoint case it returns None; use glyph and encode_utf8 to reconstruct the string.

Only present when the egc feature is enabled.

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

Sets the glyph for this tile (builder style).

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

Sets the style for this tile (builder style).

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

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

pub(crate) fn reset(&mut self)

Resets this tile to the default (space, default style, no offset).

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

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 Eq for Tile

impl StructuralPartialEq for Tile