Struct wgpu_core::resource::StagingBuffer

pub struct StagingBuffer<A: HalApi> { /* private fields */ }

A temporary buffer, consumed by the command that uses it.

A StagingBuffer is designed for one-shot uploads of data to the GPU. It is always created mapped, and the command that uses it destroys the buffer when it is done.

StagingBuffers can be created with queue_create_staging_buffer and used with queue_write_staging_buffer. They are also used internally by operations like queue_write_texture that need to upload data to the GPU, but that don’t belong to any particular wgpu command buffer.

Used StagingBuffers are accumulated in Device::pending_writes, to be freed once their associated operation’s queue submission has finished execution.

Trait Implementations

impl<A: Debug + HalApi> Debug for StagingBuffer<A>

where A::Buffer: Debug,

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

Formats the value using the given formatter.

impl<A: HalApi> Drop for StagingBuffer<A>

fn drop(&mut self)

Executes the destructor for this type.