Struct ThumbnailCache 

pub struct ThumbnailCache {
    api_client: Arc<ImmichApiClient>,
    memory: Mutex<SizedLruCache>,
    cache_dir: PathBuf,
    small_semaphore: Arc<Semaphore>,
    large_semaphore: Arc<Semaphore>,
    inflight: Arc<Mutex<HashMap<String, Receiver<Option<Result<Texture, String>>>>>>,
}

A combined memory (LRU) and disk-based caching manager for remote and local assets.

Fields

api_client: Arc<ImmichApiClient>

memory: Mutex<SizedLruCache>

cache_dir: PathBuf

small_semaphore: Arc<Semaphore>

large_semaphore: Arc<Semaphore>

inflight: Arc<Mutex<HashMap<String, Receiver<Option<Result<Texture, String>>>>>>

Implementations

impl ThumbnailCache

const AUTO_MIN_BYTES: usize

Floor for the auto-sized RAM budget, so very low-memory systems still hold a working set of decoded thumbnails.

const AUTO_MAX_BYTES: usize

const AUTO_FRACTION_PERCENT: usize = 20

pub fn new(api_client: Arc<ImmichApiClient>) -> Self

Construct a new thumbnail cache manager. Disk pruning is handled centrally by cache_manager at startup, not here.

pub fn get_cached(&self, asset_id: &str, size: ThumbnailSize) -> Option<Texture>

Retrieve a thumbnail texture from memory if present, updating LRU recency.

pub fn peek_cached( &self, asset_id: &str, size: ThumbnailSize, ) -> Option<Texture>

Same as get_cached but does not touch LRU order. Use for read-only per-frame paint lookups.

pub fn cache_stats(&self) -> (usize, usize, usize, usize)

(entries, current_bytes, max_bytes, evictions_since_last_call).

fn semaphore_for(&self, size: ThumbnailSize) -> Arc<Semaphore>

pub async fn load_thumbnail( &self, asset_id: &str, size: ThumbnailSize, ) -> Result<Texture, String>

Asynchronously fetch a remote thumbnail with default non-cancellable execution.

pub async fn load_thumbnail_cancellable<F>( &self, asset_id: &str, size: ThumbnailSize, is_cancelled: F, ) -> Result<Texture, String>

where F: Fn() -> bool,

Asynchronously fetch a remote thumbnail with cancellable hook support.

async fn fetch_remote_thumbnail( &self, asset_id: &str, size: ThumbnailSize, key: &str, is_cancelled: &dyn Fn() -> bool, ) -> Result<Texture, String>

Internal helper that performs the actual network request and disk backup logic.

pub async fn load_local_thumbnail_cancellable<F>( &self, asset_id: &str, path: &Path, is_cancelled: F, ) -> Result<Texture, String>

where F: Fn() -> bool,

Asynchronously generate a local file thumbnail with cancellable hook support.

async fn fetch_local_thumbnail( &self, asset_id: &str, path: &Path, key: &str, is_cancelled: &dyn Fn() -> bool, ) -> Result<Texture, String>

Internal helper that scales, saves, and loads a local folder asset thumbnail.

pub fn clear(&self) -> Result<(), String>

Purge all memory caches and completely delete the disk cache directory.

pub fn clear_memory(&self)

Drop every cached texture from RAM without touching the disk cache. Invoked when the library window closes so the texture memory is released until the user reopens it.

fn cache_file(&self, asset_id: &str, size: ThumbnailSize) -> PathBuf

Return the physical disk cache path for a remote asset thumbnail.

fn cache_file_local(&self, asset_id: &str) -> PathBuf

Return the physical disk cache path for a local folder asset thumbnail.

fn enter_inflight( &self, key: &str, ) -> Result<InflightGuard, Receiver<Option<Result<Texture, String>>>>

Register or join an ongoing in-flight loading request for a key.