Struct ArrayBufferChanges 

pub struct ArrayBufferChanges<Tag> { /* private fields */ }

Main-world resource for queuing index-value changes to a fixed-size array buffer.

Tag is a zero-sized marker type that uniquely identifies this buffer, allowing multiple buffers of the same element type and length to coexist. The element type and length are specified at registration and do not appear in this type.

Changes are serialized to bytes immediately in set, then batched into contiguous write_buffer runs each frame. Indices need not be sorted or unique — duplicates use last-write-wins.

Example

struct Colors;
// registered via: app.register_array_buffer::<Colors, Vec4, 64>(0, 0, false)

fn update(mut changes: ResMut<ArrayBufferChanges<Colors>>) {
    changes.set(0, Vec4::new(1.0, 0.0, 0.0, 1.0)); // red at index 0
    changes.set_many([(1, Vec4::Y), (2, Vec4::Z)]); // green, blue
}

Implementations

impl<Tag> ArrayBufferChanges<Tag>

pub fn set<T: ShaderSize + WriteInto>(&mut self, index: usize, value: T)

Queue a change: element at index will be updated to value this frame. The value is serialized to bytes immediately.

pub fn set_many<T, I>(&mut self, pairs: I)

where T: ShaderSize + WriteInto, I: IntoIterator<Item = (usize, T)>,

Queue multiple changes at once from any iterable of (index, value) pairs.

Equivalent to calling set for each pair. Accepts arrays, vecs, iterators, or anything that implements IntoIterator<Item = (usize, T)>:

changes.set_many([(8, color_a), (9, color_a), (24, color_b), (25, color_b)]);
changes.set_many((0..4).map(|i| (i, Vec4::ONE)));

pub fn set_all<T: ShaderSize + WriteInto>(&mut self, value: T)

Queue a change to set every element in the buffer to value. The value is serialized once and the bytes are reused for each element.

Trait Implementations

impl<Tag> Component for ArrayBufferChanges<Tag>

where Self: Send + Sync + 'static,

const STORAGE_TYPE: StorageType = ::bevy::ecs::component::StorageType::SparseSet

A constant indicating the storage type used for this component.

type Mutability = Mutable

A marker type to assist Bevy with determining if this component is mutable, or immutable. Mutable components will have Component<Mutability = Mutable>, while immutable components will instead have Component<Mutability = Immutable>.

fn register_required_components( _requiree: ComponentId, required_components: &mut RequiredComponentsRegistrator<'_, '_>, )

Registers required components.

fn clone_behavior() -> ComponentCloneBehavior

Called when registering this component, allowing to override clone function (or disable cloning altogether) for this component.

fn relationship_accessor() -> Option<ComponentRelationshipAccessor<Self>>

Returns ComponentRelationshipAccessor required for working with relationships in dynamic contexts.

fn on_add() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_add ComponentHook for this Component if one is defined.

fn on_insert() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_insert ComponentHook for this Component if one is defined.

fn on_discard() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_discard ComponentHook for this Component if one is defined.

fn on_remove() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_remove ComponentHook for this Component if one is defined.

fn on_despawn() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_despawn ComponentHook for this Component if one is defined.

fn map_entities<E>(_this: &mut Self, _mapper: &mut E)

where E: EntityMapper,

Maps the entities on this component using the given EntityMapper. This is used to remap entities in contexts like scenes and entity cloning. When deriving Component, this is populated by annotating fields containing entities with #[entities]

impl<Tag> Default for ArrayBufferChanges<Tag>

fn default() -> Self

Returns the “default value” for a type.

impl<Tag> Resource for ArrayBufferChanges<Tag>

where Self: Send + Sync + 'static,