Struct wgpu_core::device::queue::PendingWrites

pub(crate) struct PendingWrites {
    pub command_encoder: Box<dyn DynCommandEncoder>,
    pub is_recording: bool,
    temp_resources: Vec<TempResource>,
    dst_buffers: HashMap<TrackerIndex, Arc<Buffer>, BuildHasherDefault<FxHasher>>,
    dst_textures: HashMap<TrackerIndex, Arc<Texture>, BuildHasherDefault<FxHasher>>,
}

A private command encoder for writes made directly on the device or queue.

Operations like buffer_unmap, queue_write_buffer, and queue_write_texture need to copy data to the GPU. At the hal level, this must be done by encoding and submitting commands, but these operations are not associated with any specific wgpu command buffer.

Instead, Device::pending_writes owns one of these values, which has its own hal command encoder and resource lists. The commands accumulated here are automatically submitted to the queue the next time the user submits a wgpu command buffer, ahead of the user’s commands.

Important: When locking pending_writes be sure that tracker is not locked and try to lock trackers for the minimum timespan possible

All uses of StagingBuffers end up here.

Fields

command_encoder: Box<dyn DynCommandEncoder>

is_recording: bool

True if command_encoder is in the “recording” state, as described in the docs for the wgpu_hal::CommandEncoder trait.

temp_resources: Vec<TempResource>

dst_buffers: HashMap<TrackerIndex, Arc<Buffer>, BuildHasherDefault<FxHasher>>

dst_textures: HashMap<TrackerIndex, Arc<Texture>, BuildHasherDefault<FxHasher>>

Implementations

impl PendingWrites

pub fn new(command_encoder: Box<dyn DynCommandEncoder>) -> Self

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

pub fn insert_buffer(&mut self, buffer: &Arc<Buffer>)

pub fn insert_texture(&mut self, texture: &Arc<Texture>)

pub fn contains_buffer(&self, buffer: &Arc<Buffer>) -> bool

pub fn contains_texture(&self, texture: &Arc<Texture>) -> bool

pub fn consume_temp(&mut self, resource: TempResource)

pub fn consume(&mut self, buffer: FlushedStagingBuffer)

fn pre_submit( &mut self, command_allocator: &CommandAllocator, device: &Device, queue: &Queue, ) -> Result<Option<EncoderInFlight>, DeviceError>

pub fn activate(&mut self) -> &mut dyn DynCommandEncoder

pub fn deactivate(&mut self)

Trait Implementations

impl Debug for PendingWrites

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

Formats the value using the given formatter.