Struct GpuBuffer 

pub struct GpuBuffer<T: Pod> { /* private fields */ }

GPU buffer wrapper with type safety.

This struct wraps a WGPU buffer and provides type-safe operations for uploading and downloading data to/from the GPU.

Implementations

impl<T: Pod> GpuBuffer<T>

pub fn new( context: &GpuContext, len: usize, usage: BufferUsages, ) -> GpuResult<Self>

Create a new GPU buffer with the specified size and usage.

Errors

Returns an error if buffer creation fails or size is invalid.

pub fn from_data( context: &GpuContext, data: &[T], usage: BufferUsages, ) -> GpuResult<Self>

Create a GPU buffer from existing data.

Errors

Returns an error if buffer creation or upload fails.

pub fn staging(context: &GpuContext, len: usize) -> GpuResult<Self>

Create a staging buffer for CPU-GPU transfers.

Errors

Returns an error if buffer creation fails.

pub fn write(&mut self, data: &[T]) -> GpuResult<()>

Write data to the GPU buffer.

Errors

Returns an error if the buffer doesn’t support writes or data size doesn’t match buffer size.

pub async fn read(&self) -> GpuResult<Vec<T>>

Read data from the GPU buffer asynchronously.

Errors

Returns an error if the buffer doesn’t support reads or mapping fails.

pub async fn read_async(&self) -> GpuResult<Vec<T>>

Read data from the GPU buffer asynchronously using a Future.

This is the primary async entry-point for GPU→CPU readback. It uses a futures::channel::oneshot channel so the mapping callback resolves the returned Future without blocking any thread.

Equivalent to calling .read().await, but named explicitly so downstream code can refer to the async path by a stable, unambiguous name when both read_blocking and the async variant need to co-exist in the same scope.

Errors

Returns an error if the buffer doesn’t support reads (MAP_READ usage must be set), if the oneshot channel is dropped before resolution (GpuError::BufferMapping("Channel closed")), or if wgpu reports a mapping failure.

pub fn read_blocking(&self) -> GpuResult<Vec<T>>

Read data from the GPU buffer synchronously (blocking).

Errors

Returns an error if the buffer doesn’t support reads or mapping fails.

pub fn copy_from(&mut self, source: &GpuBuffer<T>) -> GpuResult<()>

Copy data from another GPU buffer.

Errors

Returns an error if buffer sizes don’t match or copy is not supported.

pub fn len(&self) -> usize

Get the number of elements in the buffer.

pub fn is_empty(&self) -> bool

Check if the buffer is empty.

pub fn size_bytes(&self) -> u64

Get the buffer size in bytes.

pub fn buffer(&self) -> &Buffer

Get the underlying WGPU buffer.

pub fn usage(&self) -> BufferUsages

Get buffer usage flags.

Trait Implementations

impl<T: Pod> Clone for GpuBuffer<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Pod> Debug for GpuBuffer<T>

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

Formats the value using the given formatter.