Struct TexturePool 

pub struct TexturePool { /* private fields */ }

A pool of GPU textures backed by a fixed memory budget and an optional count-based capacity limit.

Implementations

impl TexturePool

pub fn new(max_gb: f64) -> Self

Create a pool with a budget of max_gb gigabytes and no count limit.

pub fn with_capacity(max: usize) -> Self

Create a pool with an explicit maximum texture count.

When the pool holds max live textures, allocate returns None. Use evict_lru or allocate_with_lru_eviction to make room. The byte budget is set to usize::MAX (effectively unlimited).

pub fn evict_lru(&mut self) -> usize

Evict all LRU textures until the pool is below its max_textures limit (or until the pool is empty).

Returns the number of textures evicted.

pub fn allocate(&mut self, desc: TextureDescriptor) -> Option<usize>

Allocate a texture in the pool

Returns Some(handle) on success, or None if the byte budget or the count capacity (max_textures) is exceeded.

pub fn allocate_with_lru_eviction( &mut self, desc: TextureDescriptor, ) -> Option<usize>

Allocate a texture, evicting the LRU slot if the budget or count limit is exceeded.

Returns Some(handle) on success, or None if eviction cannot free enough resources (e.g. a single remaining texture is larger than the requested one’s byte budget).

pub fn lru_handle(&self) -> Option<usize>

Return the handle of the least-recently-used allocated texture, or None if the pool is empty.

pub fn touch(&mut self, handle: usize)

Update the access timestamp of handle to mark it as recently used.

pub fn free(&mut self, id: usize)

Free a texture by handle

pub fn utilization(&self) -> f64

Utilisation in [0.0, 1.0]

pub fn live_count(&self) -> usize

Number of live (allocated) textures

pub fn allocated_bytes(&self) -> usize

Currently allocated bytes

pub fn max_bytes(&self) -> usize

Pool capacity in bytes