Struct StagingBufferPool 

pub struct StagingBufferPool { /* private fields */ }

Device-local staging buffer pool keyed by (size, usage).

Hot dispatch paths (e.g. GpuBufferHandle::readback_until) acquire readback staging buffers from this pool instead of creating a fresh wgpu::Buffer on every call. Each (size, usage) class is capped at [STAGING_BUFFER_POOL_CLASS_CAP] entries; evictions drop the least-recently-used buffer.

Implementations

impl StagingBufferPool

pub fn new() -> Self

Create an empty staging buffer pool.

pub fn stats(&self) -> StagingBufferPoolStats

Return allocation and hit counters.

pub fn acquire(&self, device: &Device, size: u64, usage: BufferUsages) -> Buffer

Acquire a staging buffer with exactly size bytes and usage.

Reuses a free buffer when one is available; otherwise creates a fresh GPU allocation and increments the allocation counter.

pub fn release(&self, buffer: Buffer, size: u64, usage: BufferUsages)

Release a staging buffer back to the pool.

The buffer is pushed to the MRU position of its (size, usage) class. If the class already holds 16 buffers, the LRU entry is dropped.

Trait Implementations

impl Clone for StagingBufferPool

fn clone(&self) -> StagingBufferPool

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StagingBufferPool

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

Formats the value using the given formatter.

impl Default for StagingBufferPool

fn default() -> StagingBufferPool

Returns the “default value” for a type.