Struct SpriteCache 

pub struct SpriteCache { /* private fields */ }

Available on crate feature tilesets only.

Cache of decoded sprites, keyed by Unicode codepoint.

Reload / hot-swap is not supported

load is append-only: it decodes a tileset and merges its sprites into the existing map, with later registrations winning on codepoint collision (see load docs). There is no unload or clear, and nothing observes or invalidates sprites already handed out via get.

This is a deliberate scope decision, not an oversight: games generally don’t hot-swap tilesets at runtime, and a SpriteCache is only ever populated once, when a backend is built. If you need to iterate on a sprite sheet (e.g. during dev-mode asset editing) or otherwise want a tileset change to take effect, rebuild the whole renderer from a fresh backend configuration rather than mutating an existing cache in place.

Implementations

impl SpriteCache

pub const fn new() -> Self

Creates an empty sprite cache.

pub fn get(&self, ch: char) -> Option<&Sprite>

Returns the sprite for ch, if registered.

pub fn iter(&self) -> impl ExactSizeIterator<Item = (char, &Sprite)>

Iterates every registered (codepoint, sprite) in codepoint order.

Used by GPU backends to build a sprite atlas from the whole decoded set (the software backend only ever needs per-glyph get at blit time).

pub fn is_empty(&self) -> bool

Whether any sprite is registered.

pub fn load(&mut self, opts: &TilesetOptions) -> Result<(), TilesetError>

Loads a tileset, decoding the PNG and inserting all sprites.

On codepoint collision, the new sprite replaces the old one and a message is logged via log::warn.

Errors

Returns TilesetError::PngDecode if the bytes are not a valid PNG, TilesetError::ZeroTileSize if opts.tile_width or opts.tile_height is 0, or TilesetError::InvalidDimensions if the decoded image dimensions are not evenly divisible by the tile size.

Trait Implementations

impl Debug for SpriteCache

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

Formats the value using the given formatter.

impl Default for SpriteCache

fn default() -> Self

Returns the “default value” for a type.