Struct BufferBuilder 

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

Builds a Buffer — empty (via empty) or pre-populated (via with_data). Two constructors rather than one new() plus a .data()/.size() setter pair, so there’s no way to call both and have the second one silently win — the same shape as Texture’s from_file/from_data/empty.

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

let vertex_buffer = BufferBuilder::with_data(bytemuck::cast_slice(&vertices))
    .label("mesh vertices")
    .usage(BufferUsages::VERTEX)
    .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 empty(size: u64) -> Self

Allocates an empty buffer of size bytes, to be written into later via Buffer::write.

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

Pre-populates the buffer with data (its size is taken from data’s length).

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 build(self, backend: &WGPUBackend) -> Buffer