Struct BufferPool 

pub struct BufferPool { /* private fields */ }

A pool of reusable GPU-style byte buffers.

Callers acquire a buffer via acquire (receiving its ID), read/write via get_mut, then return it to the pool with release.

Implementations

impl BufferPool

pub fn new(max_pool_bytes: usize) -> Self

Create a new pool that will hold at most max_pool_bytes of backing storage before refusing new allocations.

pub fn acquire(&mut self, size_bytes: usize, alignment: usize) -> Option<u64>

Check out a buffer of at least size_bytes with at least alignment.

Strategy: find the smallest existing compatible free buffer to minimise fragmentation. If none exists, allocate a new one (provided the pool is below its byte budget).

Returns the buffer id on success, or None if no buffer is available and allocating a new one would exceed the pool’s byte budget.

pub fn release(&mut self, id: u64) -> bool

Return a buffer to the pool by id.

The buffer is kept for future reuse but marked as available. Returns true if the buffer was found and released, false otherwise.

pub fn get(&self, id: u64) -> Option<&GpuBuffer>

Borrow the buffer with the given id.

pub fn get_mut(&mut self, id: u64) -> Option<&mut GpuBuffer>

Mutably borrow the buffer with the given id.

pub fn defragment(&mut self)

Evict all free buffers that have not been used for more than 60 seconds.

In-use buffers are never evicted.

pub fn stats(&self) -> PoolStats

Snapshot of pool metrics.

pub fn total_allocated_bytes(&self) -> usize

Total bytes currently under management.

pub fn max_pool_bytes(&self) -> usize

Maximum pool capacity in bytes.

Trait Implementations

impl Debug for BufferPool

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

Formats the value using the given formatter.