Struct wgpu_core::command::allocator::CommandAllocator

pub(crate) struct CommandAllocator {
    free_encoders: Mutex<Vec<Box<dyn DynCommandEncoder>>>,
}

A pool of free wgpu_hal::CommandEncoders, owned by a Device.

Each encoder in this list is in the “closed” state.

Since a raw CommandEncoder is itself a pool for allocating raw CommandBuffers, this is a pool of pools.

Fields

free_encoders: Mutex<Vec<Box<dyn DynCommandEncoder>>>

Implementations

impl CommandAllocator

pub(crate) fn new() -> Self

pub(crate) fn acquire_encoder( &self, device: &dyn DynDevice, queue: &dyn DynQueue, ) -> Result<Box<dyn DynCommandEncoder>, DeviceError>

Return a fresh wgpu_hal::CommandEncoder in the “closed” state.

If we have free encoders in the pool, take one of those. Otherwise, create a new one on device.

pub(crate) fn release_encoder(&self, encoder: Box<dyn DynCommandEncoder>)

Add encoder back to the free pool.

pub(crate) fn dispose(&self, device: &dyn DynDevice)

Free the pool of command encoders.

This is only called when the Device is dropped.