Struct InstanceBuffer 

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

GPU instance buffer with partial update support.

Maintains a CPU-side buffer and GPU buffer, tracking which ranges have been modified and need uploading. Supports efficient partial writes for retained-mode rendering where only dirty instances change.

Implementations

impl<T: Pod> InstanceBuffer<T>

pub fn new(device: &Device, label: Option<&str>, capacity: usize) -> Self

Create a new instance buffer with the specified capacity.

pub fn buffer(&self) -> &Buffer

Get the GPU buffer.

pub fn instances(&self) -> &[T]

Get the current instance data.

pub fn len(&self) -> usize

Get the number of instances.

pub fn is_empty(&self) -> bool

Check if the buffer is empty.

pub fn capacity(&self) -> usize

Get the capacity.

pub fn clear(&mut self)

Clear all instances.

pub fn set_instances(&mut self, device: &Device, instances: Vec<T>)

Set instances, replacing all existing data.

Marks the entire buffer as dirty for GPU upload. Reallocates GPU buffer if capacity is exceeded.

pub fn update_range(&mut self, start: usize, new_data: &[T])

Update a specific range of instances.

Replaces instances[start..end] with the provided data. Marks the range as dirty for GPU upload.

pub fn update_instance(&mut self, index: usize, instance: T)

Update a single instance.

pub fn append(&mut self, device: &Device, new_instances: &[T])

Append instances to the buffer.

Reallocates if capacity is exceeded.

pub fn upload_dirty(&mut self, queue: &Queue)

Upload all dirty ranges to the GPU.

This performs partial buffer writes for each dirty range, minimizing GPU bandwidth usage for retained rendering.

pub fn upload_all(&mut self, queue: &Queue)

Force upload of the entire buffer, ignoring dirty tracking.

pub fn dirty_ranges(&self) -> &DirtyRanges

Get dirty ranges for inspection.

pub fn write_count(&self) -> u64

Get write statistics.

pub fn stats(&self) -> InstanceBufferStats

Get buffer statistics.