Struct ImageStore 

pub struct ImageStore { /* private fields */ }

Decoded images, kept so a redraw does not re-read the file.

Implementations

impl ImageStore

pub fn with_root(images_root: PathBuf) -> Self

pub fn set_root(&mut self, images_root: PathBuf)

pub fn root(&self) -> &Path

pub fn set_attachments(&mut self, attachments: &[Attachment])

pub fn resolve(&self, reference: &str) -> PathBuf

pub fn detect() -> Self

Probe the terminal graphics protocol. Call before the alternate screen. Falls back to halfblocks if unsupported or under tmux without passthrough.

pub fn prefetch(&mut self, paths: impl IntoIterator<Item = PathBuf>)

Start decoding paths on worker threads. Safe to call repeatedly; already-cached or in-flight paths are skipped. The form can open immediately while this runs.

pub fn poll_pending(&mut self) -> bool

Pull finished background decodes into the cache. Returns true when at least one image became ready (caller should redraw).

pub fn has_pending(&self) -> bool

pub fn recheck_cell_size(&mut self) -> bool

If the terminal cell size changed, drop encodings and rebuild.

Needed when moving between displays of different DPI: the grid size is unchanged so there is no resize event, but pixel-per-cell is. Decoded bitmaps stay cached; only protocols are invalidated.

pub fn get(&mut self, path: &Path) -> ImageReady<'_>

The protocol for path, without blocking on disk I/O.

Missing files are fetched in the background; the first call returns ImageReady::Loading until a later Self::poll_pending lands them.

pub fn get_preview(&mut self, path: &Path) -> ImageReady<'_>

Full-screen preview protocol — kept separate from the body thumb so open → close → open does not thrash encode size every time.

pub fn preview_frame( &mut self, gif: &GifPlayback, ) -> Result<&mut StatefulProtocol, String>

Protocol for the current GIF frame (encode once per frame index).

pub fn clear_preview(&mut self)

pub fn clear_cache(&mut self)

Drop the body protocols (the terminal deletes those pictures) but keep the decoded pixels. The next get rebuilds from RAM — no disk.

Needed after a Clear over a graphics-protocol image, e.g. when the / menu closes.

pub fn release_form_graphics(&mut self)

Drop every placed protocol when leaving the task form.

Trait Implementations

impl Default for ImageStore

fn default() -> Self

Returns the “default value” for a type.