Struct TextureCache 

pub struct TextureCache { /* private fields */ }

Implementations

impl TextureCache

pub fn new(asset_dir: PathBuf, palette: Option<Palette>) -> Self

Builds a texture cache by indexing TEXBSI.* files under asset_dir.

pub fn new_for_edition( asset_dir: PathBuf, palette: Option<Palette>, software: bool, ) -> Self

Selects software TEXTURE banks or Glide TEXBSI banks explicitly.

pub fn from_data( texbsi_data: HashMap<u16, Vec<u8>>, palette: Option<Palette>, ) -> Self

Builds a texture cache from pre-loaded TEXBSI data (no filesystem access).

texbsi_data maps TEXBSI IDs (e.g. 302) to raw file bytes. Used by the FFI layer where the caller provides all data in memory.

pub fn from_software_data( data: HashMap<u16, Vec<u8>>, palette: Option<Palette>, ) -> Result<Self>

Builds a software cache from bank bytes without filesystem access.

pub const fn palette(&self) -> Option<&Palette>

pub const fn missing_requests(&self) -> &BTreeMap<(u16, u8), String>

Referenced texture/image failures retained by the existing fallback path.

pub fn resolve_texture_id( texture_id: u16, contains: impl Fn(u16) -> bool, ) -> u16

Resolves an authored texture bank against available IDs using the exporter’s remapping rules.

pub fn ensure_bsi_available(&mut self, texture_id: u16)

pub fn image_count(&self, texture_id: u16) -> Option<usize>

pub fn get_image_rgba( &mut self, texture_id: u16, image_id: u8, ) -> Option<(Vec<u8>, u16, u16)>

pub fn get_image_rgba_with_frame_count( &mut self, texture_id: u16, image_id: u8, ) -> Option<(Vec<u8>, u16, u16, u16)>

pub fn get_all_frames_by_image_id( &mut self, texture_id: u16, image_id: u8, ) -> Option<AllFramesInfo>

pub fn get_image_dimensions( &mut self, texture_id: u16, image_id: u8, ) -> Option<(u16, u16)>

Returns dimensions for a texture/image pair without decoding PNG bytes.

pub fn get_image_tex_scale( &mut self, texture_id: u16, image_id: u8, ) -> Option<f32>

Returns the effective tex_scale factor for a texture/image pair. The raw BHDR tex_scale is 8.8 fixed-point; 0 is treated as 0x0100 (1.0).

pub fn get_image_png( &mut self, texture_id: u16, image_id: u8, compress: bool, ) -> Option<(Vec<u8>, u16, u16, bool)>

Returns PNG-encoded image bytes, dimensions, and whether the image contains any transparent pixels (palette index 0) for a texture/image pair.