Struct BufferBuilder 

pub struct BufferBuilder<'a> { /* private fields */ }

Builds a Buffer — empty (via size) or pre-populated (via data).

let camera_buffer = BufferBuilder::new()
    .label("camera")
    .uniform()
    .size(64)
    .build(&backend);

let vertex_buffer = BufferBuilder::new()
    .label("mesh vertices")
    .usage(BufferUsages::VERTEX)
    .data(bytemuck::cast_slice(&vertices))
    .build(&backend);

For a dynamically-offset buffer (many elements, selected via set_bind_group’s dynamic offset), use DynamicBufferBuilder instead — it returns the per-element stride alongside the buffer, which plain BufferBuilder has no way to compute.

Implementations

impl<'a> BufferBuilder<'a>

pub fn new() -> Self

pub fn label(self, label: impl Into<Option<&'a str>>) -> Self

pub fn usage(self, usage: BufferUsages) -> Self

Sets the buffer’s usage flags outright — use this for anything not covered by uniform/storage (a vertex/index buffer, a MAP_READ staging buffer, …).

pub fn uniform(self) -> Self

Shorthand for .usage(BufferUsages::UNIFORM | BufferUsages::COPY_DST).

pub fn storage(self) -> Self

Shorthand for .usage(BufferUsages::STORAGE | BufferUsages::COPY_DST).

pub fn data(self, data: &'a [u8]) -> Self

Pre-populates the buffer with data (its size is taken from data’s length). Mutually exclusive with size — whichever is called last wins.

pub fn size(self, size: u64) -> Self

Allocates an empty buffer of size bytes, to be written into later via Buffer::write. Mutually exclusive with data — whichever is called last wins.

pub fn build(self, backend: &WGPUBackend) -> Buffer

Trait Implementations

impl<'a> Default for BufferBuilder<'a>

fn default() -> Self

Returns the “default value” for a type.