Struct ImageManager 

pub struct ImageManager { /* private fields */ }

Implementations

impl ImageManager

pub fn debug_live_image_memory_stats(&self) -> ImageMemoryStats

Count live decoded pixels, deduplicating albums and shared frame images. This excludes allocator metadata and temporary decode buffers.

pub fn new(project_dir: PathBuf) -> Self

pub fn release_recent_albums(&mut self)

Lets the recently used albums go once nothing else holds them.

pub fn project_dir(&self) -> &Path

pub fn current_append_dir(&self) -> &str

pub fn set_current_append_dir(&mut self, append_dir: impl Into<String>)

pub fn set_current_append_dir_ref(&mut self, append_dir: &str)

pub fn get(&self, id: &ImageHandle) -> Option<Arc<RgbaImage>>

Borrow the resource handle and share its current pixel buffer. The returned pixels can outlive a later in-place image update.

pub fn get_entry(&self, id: &ImageHandle) -> Option<(Arc<RgbaImage>, u64)>

pub fn album_len(&self, id: &ImageHandle) -> usize

Script-visible canvas size, independent of the cropped GPU texture. The number of cuts in the album an image belongs to (a G00’s pattern count).

pub fn original_size(&self, id: &ImageHandle) -> Option<(u32, u32)>

pub fn image_handle(&self, index: ImageKey) -> Option<ImageHandle>

Upgrade a non-owning key while the resource is still alive. Returns None after the last handle is dropped; a key cannot resurrect it.

pub fn contains(&self, index: ImageKey) -> bool

pub fn solid_rgba(&mut self, rgba: (u8, u8, u8, u8)) -> ImageHandle

Create a 1x1 solid RGBA image and return its image id.

This is used for UI placeholders (e.g. message window background) until full UI skinning is implemented.

pub fn load_bg(&mut self, name: &str) -> Result<ImageHandle>

Load a BG resource by name (Siglus policy: g00/ then bg/, with extension fallback).

BG is not animated in our current bring-up, so frame index is always 0.

pub fn load_bg_frame( &mut self, name: &str, frame_index: usize, ) -> Result<ImageHandle>

Load a BG resource with an explicit frame index (kept for compatibility).

pub fn load_g00(&mut self, name: &str, frame_index: u32) -> Result<ImageHandle>

Load an image restricted to the g00/ directory (with extension fallback).

Used for CHR / sprite image loading.

pub fn load_g00_composed(&mut self, descriptor: &str) -> Result<ImageHandle>

Load Siglus/Tona3’s composed-G00 descriptor syntax: base(x,y,cut,blend=n)|overlay(x,y,cut,blend=n)|....

Tona3 creates one texture from the first cut and draws every later cut into that fixed-size texture. Coordinates are anchor-relative: each overlay is shifted by the base cut center minus the overlay cut center.

pub fn load_file( &mut self, path: &Path, frame_index: usize, ) -> Result<ImageHandle>

Load an image from an explicit path (relative to project_dir if not absolute).

pub fn insert_image(&mut self, img: RgbaImage) -> ImageHandle

Insert an already-decoded image into the manager and return a new ImageHandle.

pub fn insert_image_arc(&mut self, img: Arc<RgbaImage>) -> ImageHandle

pub fn replace_image(&mut self, id: &ImageHandle, img: RgbaImage) -> Result<()>

Replace an existing image in-place and bump its version.

This allows the renderer to update the GPU texture without changing the ImageHandle.

pub fn replace_image_arc( &mut self, id: &ImageHandle, img: Arc<RgbaImage>, ) -> Result<()>

pub fn debug_image_info(&self, id: &ImageHandle) -> Option<DebugImageInfo>

pub fn resident_bytes(&self) -> usize

pub fn organize(&mut self)

Like C_tnm_d3d_resource_manager::organize(), remove expired weak registrations. Pixel storage is already freed when its last owner drops.

Trait Implementations

impl Debug for ImageManager

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

Formats the value using the given formatter.