Struct SpriteManager 

pub struct SpriteManager {
    defs: Vec<SpriteDef>,
    slot_to_index: HashMap<u32, usize>,
    active: Vec<ActiveSprite>,
    cycle_cursor: usize,
}

Sprite system: definitions + active instances.

Fields

defs: Vec<SpriteDef>

Parsed MILK_IMG.INI entries indexed by load order. The public API targets entries by slot (1-based, matching the section headers); [slot_to_index] converts.

slot_to_index: HashMap<u32, usize>

Slot → defs-vector position map. Sparse, since users can author [img01] then jump to [img50].

active: Vec<ActiveSprite>

Active sprites — drawn in spawn order so later spawns paint over earlier ones.

cycle_cursor: usize

Cursor for “cycle to next” (the K keybind). Walks the slot list mod defs.len().

Implementations

impl SpriteManager

pub fn new() -> Self

pub fn load_defs(&mut self, defs: Vec<SpriteDef>)

Load a freshly-parsed set of sprite definitions, replacing any previous load. Doesn’t touch the active list — running sprites keep their def_index-back-reference until they finish naturally, even though the def is gone (we re-resolve the texture each frame in case the renderer reloaded).

pub fn def_count(&self) -> usize

Number of loaded sprite definitions (NOT the active count).

pub fn active_count(&self) -> usize

Number of sprites currently being drawn each frame.

pub fn spawn_slot(&mut self, slot: u32) -> bool

Spawn a sprite by INI slot. Returns false if the slot isn’t loaded. Multiple spawns of the same slot stack — that matches MD2 behaviour and lets users build up effects by hammering the key.

fn spawn_index(&mut self, idx: usize)

pub fn cycle_next(&mut self) -> Option<u32>

K keybind: load the next sprite slot in cyclic order.

pub fn spawn_random(&mut self, seed: u64) -> Option<u32>

Shift+K: pick a slot at random. The caller passes the RNG seed so we stay deterministic in tests.

pub fn clear(&mut self)

Ctrl+T and Delete: drop every active sprite immediately.

pub fn pop_most_recent(&mut self) -> bool

Delete variant that only removes the most recent sprite (last-in-first-out). Returns true when something was removed so the GUI can suppress redundant Delete events on an already-empty list.

pub fn tick( &mut self, time: f32, q_snapshot: &[f32; 32], ) -> Vec<SpriteRenderInstance>

Advance every active sprite by one frame. Returns the list of SpriteRenderInstances for the renderer.

time is the engine’s global clock (seconds, monotonic). q_snapshot is the preset’s q1..q32 after the preset’s per_frame block runs, exposed so sprite equations can piggyback on the preset’s audio-reactive computations.

pub fn defs(&self) -> &[SpriteDef]

Borrow the parsed defs — useful for the renderer’s texture loader (resolve img= strings against an XDG sprite dir).

pub fn resolve_img_path(root: &Path, def: &SpriteDef) -> PathBuf

Path the engine expects sprite assets to live under, relative to a sprite-bank root. Pure helper, no I/O.

Trait Implementations

impl Default for SpriteManager

fn default() -> Self

Returns the “default value” for a type.