Struct SpriteRegistry 

pub struct SpriteRegistry { /* private fields */ }

Registry for sprites and variants.

Handles resolution of sprite names to renderable sprites, including expanding variants to their effective sprite representation.

Implementations

impl SpriteRegistry

pub fn new() -> Self

Create a new empty sprite registry.

pub fn register_sprite(&mut self, sprite: Sprite)

Register a sprite.

pub fn register_variant(&mut self, variant: Variant)

Register a variant.

pub fn get_sprite(&self, name: &str) -> Option<&Sprite>

Get a sprite by name (does not resolve variants).

pub fn get_variant(&self, name: &str) -> Option<&Variant>

Get a variant by name.

pub fn contains(&self, name: &str) -> bool

Check if a name refers to a sprite or variant.

pub fn resolve( &self, name: &str, palette_registry: &PaletteRegistry, strict: bool, ) -> Result<ResolvedSprite, SpriteError>

Resolve a name to a sprite-like structure, expanding variants.

In strict mode, returns an error if the name or base is not found. In lenient mode, returns a fallback result with warnings.

The returned ResolvedSprite contains the effective grid and merged palette.

pub fn names(&self) -> impl Iterator<Item = &String>

Get all sprite and variant names.

pub fn len(&self) -> usize

Get the total number of sprites and variants in the registry.

pub fn is_empty(&self) -> bool

Check if the registry is empty (no sprites or variants).

pub fn clear(&mut self)

Clear all sprites and variants from the registry.

pub fn sprite_count(&self) -> usize

Get the number of sprites (excluding variants).

pub fn variant_count(&self) -> usize

Get the number of variants (excluding sprites).

pub fn sprites(&self) -> impl Iterator<Item = (&String, &Sprite)>

Iterate over all sprites in the registry.

pub fn variants(&self) -> impl Iterator<Item = (&String, &Variant)>

Iterate over all variants in the registry.

Trait Implementations

impl Clone for SpriteRegistry

fn clone(&self) -> SpriteRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SpriteRegistry

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

Formats the value using the given formatter.

impl Default for SpriteRegistry

fn default() -> SpriteRegistry

Returns the “default value” for a type.

impl Registry<Sprite> for SpriteRegistry

fn contains(&self, name: &str) -> bool

Check if an item with the given name exists in the registry.

fn get(&self, name: &str) -> Option<&Sprite>

Get an item by name.

fn len(&self) -> usize

Get the number of items in the registry.

fn clear(&mut self)

Clear all items from the registry.

fn names(&self) -> Box<dyn Iterator<Item = &String> + '_>

Get an iterator over all names in the registry.

fn is_empty(&self) -> bool

Check if the registry is empty.

impl Registry<Variant> for SpriteRegistry

fn contains(&self, name: &str) -> bool

Check if an item with the given name exists in the registry.

fn get(&self, name: &str) -> Option<&Variant>

Get an item by name.

fn len(&self) -> usize

Get the number of items in the registry.

fn clear(&mut self)

Clear all items from the registry.

fn names(&self) -> Box<dyn Iterator<Item = &String> + '_>

Get an iterator over all names in the registry.

fn is_empty(&self) -> bool

Check if the registry is empty.