Struct ThumbnailCache 

pub struct ThumbnailCache {
    pub config: ThumbnailCacheConfig,
    /* private fields */
}

An in-memory thumbnail request queue + LRU cache.

This type is renderer-agnostic: the application is expected to:

1. call advance_frame once per UI frame,
2. drive visibility by calling request_visible for entries that are currently visible,
3. drain requests via take_requests, decode/upload thumbnails in user code, then call fulfill,
4. destroy evicted GPU textures from take_pending_destroys.

Fields

config: ThumbnailCacheConfig

Cache configuration.

Implementations

impl ThumbnailCache

pub fn new(config: ThumbnailCacheConfig) -> Self

Create a new cache with the given config.

pub fn advance_frame(&mut self)

Advance per-frame bookkeeping.

Call this once per UI frame before issuing visibility requests.

pub fn frame_index(&self) -> u64

Returns the internal frame counter.

pub fn request_visible(&mut self, path: &Path, max_size: [u32; 2])

Request a thumbnail for a visible file.

If the thumbnail is not already cached, a request may be queued depending on the per-frame request budget.

pub fn texture_id(&self, path: &Path) -> Option<TextureId>

Returns the cached texture id for a path, if available.

pub fn take_requests(&mut self) -> Vec<ThumbnailRequest>

Drain queued thumbnail requests.

Drained requests are marked as “in flight” until fulfill is called.

pub fn fulfill( &mut self, path: &Path, result: Result<TextureId, String>, _max_size: [u32; 2], )

Complete a request with either a ready texture id or an error string.

Returns any evicted texture ids that should be destroyed by the renderer.

pub fn fulfill_request( &mut self, req: &ThumbnailRequest, result: Result<TextureId, String>, )

Complete a previously issued request.

pub fn maintain(&mut self, backend: &mut ThumbnailBackend<'_>)

Process queued requests and perform pending destroys.

This is a convenience helper for applications that want dear-file-browser to drive the request lifecycle:

• Decodes queued requests using ThumbnailProvider,
• Uploads them using ThumbnailRenderer,
• Fulfills the cache, and
• Destroys evicted/replaced GPU textures via the renderer.

If you prefer to manage decoding/upload externally, you can instead use take_requests, fulfill_request, and take_pending_destroys.

pub fn take_pending_destroys(&mut self) -> Vec<TextureId>

Drain GPU textures that should be destroyed after eviction or replacement.

pub fn stats(&self) -> ThumbnailStats

Returns a snapshot of the cache state for UI display.

Trait Implementations

impl Clone for ThumbnailCache

fn clone(&self) -> ThumbnailCache

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ThumbnailCache

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

Formats the value using the given formatter.

impl Default for ThumbnailCache

fn default() -> Self

Returns the “default value” for a type.