Struct TileCache 

pub struct TileCache { /* private fields */ }

A byte-budgeted LRU cache of graph intermediates.

Shared across scheduler threads; all methods take &self.

Implementations

impl TileCache

pub const DEFAULT_BUDGET: usize

The default retention budget: 64 MiB.

pub fn new(budget: usize) -> Self

A cache retaining at most budget bytes of tiles.

A budget of zero disables retention entirely: every lookup misses, which is a useful way to test that a pipeline is correct without any caching at all.

pub const fn budget(&self) -> usize

The retention budget in bytes.

pub fn get(&self, key: &TileKey) -> Option<Arc<TileBuf>>

Look up a tile, marking it most-recently-used on a hit.

The returned Arc keeps the tile alive regardless of later eviction.

pub fn insert(&self, key: TileKey, tile: Arc<TileBuf>) -> Arc<TileBuf>

Offer a tile to the cache, evicting as needed to stay within budget.

Returns the tile, so a caller can insert and use it in one step. A tile larger than the entire budget is returned without being retained rather than evicting everything to make room for something that cannot fit.

pub fn bytes_used(&self) -> usize

Bytes currently retained.

pub fn len(&self) -> usize

Number of tiles currently retained.

pub fn is_empty(&self) -> bool

Whether the cache retains nothing.

pub fn stats(&self) -> CacheStats

A snapshot of the cache counters.

pub fn clear(&self)

Drop every retained tile, keeping the accumulated statistics.

Trait Implementations

impl Debug for TileCache

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

Formats the value using the given formatter.

impl Default for TileCache

fn default() -> Self

Returns the “default value” for a type.