Struct LargeImageManager 

pub struct LargeImageManager {
    decoding_images: HashSet<PathBuf>,
    decoded_images: HashMap<PathBuf, Handle>,
    decoded_display_sizes: HashMap<PathBuf, (u32, u32)>,
    decode_errors: HashMap<PathBuf, String>,
    decode_generations: HashMap<PathBuf, u64>,
}

Manages state and operations for large image decoding in gallery mode

Fields

decoding_images: HashSet<PathBuf>

Paths of images currently being decoded

decoded_images: HashMap<PathBuf, Handle>

Cache of decoded image handles

decoded_display_sizes: HashMap<PathBuf, (u32, u32)>

Display dimensions used for each decoded image (for resize detection)

decode_errors: HashMap<PathBuf, String>

Errors encountered during decoding

decode_generations: HashMap<PathBuf, u64>

Generation counter for each decode to support cancellation. When a new decode is started for the same path, the generation is incremented. Only decodes matching the current generation are accepted when they complete.

Implementations

impl LargeImageManager

pub fn new() -> Self

pub fn is_decoding(&self, path: &Path) -> bool

pub fn get_decoded(&self, path: &Path) -> Option<&Handle>

pub fn get_error(&self, path: &Path) -> Option<&String>

pub fn store_decoded_with_generation( &mut self, path: PathBuf, handle: Handle, display_size: Option<(u32, u32)>, generation: u64, ) -> bool

Store a decoded image if the generation matches (not superseded by newer decode). Returns true if stored, false if rejected due to generation mismatch.

pub fn store_error(&mut self, path: PathBuf, error: String)

pub fn clear_error(&mut self, path: &Path)

pub fn clear_cache(&mut self)

pub fn cache_size(&self) -> usize

pub fn cache_is_empty(&self) -> bool

pub fn needs_redecode_for_size( &self, path: &Path, new_display_size: Option<(u32, u32)>, ) -> bool

Check if an image should be re-decoded due to display size increase. Returns true only if the display size has INCREASED by more than 20% in either dimension. Does NOT re-decode for smaller sizes (GPU can efficiently downscale).

pub fn try_decode( &mut self, path: &PathBuf, display_dimensions: Option<(u32, u32)>, ) -> (bool, Option<(u32, u32)>, u64)

Attempt to decode a large image, checking memory availability first. Returns (should_decode, target_dimensions, generation) tuple.

fn ensure_memory_available( &mut self, path: &Path, width: u32, height: u32, ) -> bool

Check if sufficient memory is available, clearing cache if needed. Returns true if memory is available, false otherwise.

Trait Implementations

impl Debug for LargeImageManager

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

Formats the value using the given formatter.

impl Default for LargeImageManager

fn default() -> LargeImageManager

Returns the “default value” for a type.