Struct TypedBuffer 

pub struct TypedBuffer<T: Copy> { /* private fields */ }

A strongly-typed GPU Shader Storage Buffer Object.

T must be Copy so that we can safely transmute slices to byte slices for upload/download. In a real engine, T would also be bytemuck::Pod.

This buffer holds the GL name, current element count, capacity, usage hint, and a reference to the shared memory tracker.

Implementations

impl<T: Copy> TypedBuffer<T>

pub fn create( gl: &Context, capacity: usize, usage: BufferUsage, binding_index: u32, tracker: Arc<MemoryTracker>, ) -> Self

Create a new typed buffer with given capacity (number of T elements).

The gl parameter is the glow context. binding_index is the SSBO binding point. The buffer is allocated but not filled.

pub fn upload(&mut self, gl: &Context, data: &[T])

Upload a slice of data into the buffer starting at element offset 0. The buffer is resized if necessary.

pub fn upload_range(&mut self, gl: &Context, offset: usize, data: &[T])

Upload data at a specific element offset (partial update).

pub fn download(&self, gl: &Context) -> Vec<T>

Download the entire buffer contents back to the CPU.

pub fn download_range( &self, gl: &Context, offset: usize, count: usize, ) -> Vec<T>

Download a sub-range [offset..offset+count) of elements.

pub fn resize(&mut self, gl: &Context, new_capacity: usize)

Resize the buffer to a new capacity. Existing data is lost.

pub fn resize_preserve(&mut self, gl: &Context, new_capacity: usize)

Resize the buffer, preserving existing data up to min(old_len, new_capacity).

pub fn bind(&self, gl: &Context)

Bind this buffer to its SSBO binding index.

pub fn unbind(&self, gl: &Context)

Unbind SSBO at this buffer’s binding index.

pub fn barrier(&self, gl: &Context, barrier_type: BufferBarrierType)

Issue a memory barrier for this buffer.

pub fn clear(&mut self, gl: &Context)

Clear the buffer contents to zero.

pub fn destroy(self, gl: &Context)

Delete the underlying GL buffer.

pub fn len(&self) -> usize

Number of elements currently stored.

pub fn is_empty(&self) -> bool

Whether the buffer is empty.

pub fn capacity(&self) -> usize

Current capacity in number of elements.

pub fn byte_size(&self) -> usize

Size in bytes currently allocated.

pub fn handle(&self) -> BufferHandle

Raw buffer handle.

pub fn binding(&self) -> u32

SSBO binding index.