Enum Codepage 

#[non_exhaustive]
pub enum Codepage {
    Cp437,
    Unicode {
        start: char,
    },
    Identity,
    Custom(Vec<char>),
}

Available on crate feature tilesets only.

Maps row-major tile indices in a sprite sheet to Unicode codepoints.

#[non_exhaustive] allows adding new variants (e.g. Cp1252) without a semver break.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Cp437

Standard CP437 layout: the i-th tile maps to CP437_TO_UNICODE[i].

Only the first 256 tiles in the sheet are mapped; extras are ignored.

Unicode

Starting at start, tile index i maps to char::from_u32(start as u32 + i).

Tiles that would map to a surrogate or exceed char::MAX are skipped.

Fields

start: char

Codepoint of the first tile; subsequent tiles increment by 1.

Identity

Positional mapping: tile index i maps to char::from_u32(i).

This is the simplest option when you don’t care about Unicode semantics and just want to reference tiles by a zero-based index. Use Tile::glyph values 0, 1, 2, … to address individual sprites in sheet order.

Tiles whose index falls in the surrogate range (0xD800–0xDFFF) are skipped; all others are valid.

Custom(Vec<char>)

Explicit mapping: tile i maps to table[i].

Tiles beyond table.len() are ignored.

Implementations

impl Codepage

pub fn codepoint(&self, i: usize) -> Option<char>

Returns the codepoint for tile index i, or None if out of range or invalid (surrogates, indices past char::MAX).

pub const fn len(&self) -> Option<usize>

Number of tiles this codepage defines, or None for unbounded variants.

pub fn is_empty(&self) -> bool

Returns true if the codepage defines zero tiles.

Trait Implementations

impl Clone for Codepage

fn clone(&self) -> Codepage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Codepage

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

Formats the value using the given formatter.

impl Eq for Codepage

impl PartialEq for Codepage

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Codepage