Struct MaterialCache 

pub struct MaterialCache { /* private fields */ }

Content-addressable, LRU-evicting cache for PbrMaterial values.

Materials are stored by their structural hash (MaterialKey). When the cache is full the least-recently-used entry is evicted.

Implementations

impl MaterialCache

pub fn new(capacity: usize) -> Self

Create a new cache with the given maximum capacity.

pub fn insert(&mut self, material: PbrMaterial) -> MaterialKey

Insert (or refresh) a material. Returns the MaterialKey for later retrieval. If the cache is full the LRU entry is evicted first.

pub fn get(&mut self, key: MaterialKey) -> Option<&PbrMaterial>

Retrieve a previously inserted material by key.

pub fn peek(&self, key: MaterialKey) -> Option<&PbrMaterial>

Peek at a material without updating the LRU counter.

pub fn remove(&mut self, key: MaterialKey) -> bool

Remove a material from the cache.

pub fn len(&self) -> usize

Number of materials currently in the cache.

pub fn is_empty(&self) -> bool

Returns true when the cache contains no entries.

pub fn capacity(&self) -> usize

Maximum number of entries the cache can hold.

pub fn clear(&mut self)

Remove all entries from the cache.

pub fn insert_batch( &mut self, materials: impl IntoIterator<Item = PbrMaterial>, ) -> Vec<MaterialKey>

Pre-populate the cache with a slice of materials. Returns the keys.

pub fn iter(&self) -> impl Iterator<Item = (MaterialKey, &PbrMaterial)>

Iterate over all cached materials in arbitrary order.