Struct BatchedInstanceBuffers 

pub struct BatchedInstanceBuffers<BD, BDI>
where
    BD: GpuArrayBufferable + Sync + Send + 'static,
    BDI: AtomicPod,
{
    pub current_input_buffer: InstanceInputUniformBuffer<BDI>,
    pub previous_input_buffer: PreviousInstanceInputUniformBuffer<BDI>,
    pub phase_instance_buffers: TypeIdMap<UntypedPhaseBatchedInstanceBuffers<BD>>,
}

The GPU buffers holding the data needed to render batches.

For example, in the 3D PBR pipeline this holds MeshUniforms, which are the BD type parameter in that mode.

We have a separate buffer data input type (BDI) here, which a compute shader is expected to expand to the full buffer data (BD) type. GPU uniform building is generally faster and uses less system RAM to VRAM bus bandwidth, but only implemented for some pipelines (for example, not in the 2D pipeline at present) and only when compute shader is available.

Fields

current_input_buffer: InstanceInputUniformBuffer<BDI>

The uniform data inputs for the current frame.

These are uploaded during the extraction phase.

previous_input_buffer: PreviousInstanceInputUniformBuffer<BDI>

The uniform data inputs for the previous frame.

The indices don’t generally line up between current_input_buffer and previous_input_buffer, because, among other reasons, entities can spawn or despawn between frames. Instead, each current buffer data input uniform is expected to contain the index of the corresponding buffer data input uniform in this list.

phase_instance_buffers: TypeIdMap<UntypedPhaseBatchedInstanceBuffers<BD>>

The data needed to render buffers for each phase.

The keys of this map are the type IDs of each phase: e.g. Opaque3d, AlphaMask3d, etc.

Implementations

impl<BD, BDI> BatchedInstanceBuffers<BD, BDI>

where BD: GpuArrayBufferable + Sync + Send + 'static, BDI: AtomicPod,

pub fn new() -> Self

Creates new buffers.

pub fn clear(&mut self)

Clears out the buffers in preparation for a new frame.

Trait Implementations

impl<BD, BDI> Component for BatchedInstanceBuffers<BD, BDI>

where BD: GpuArrayBufferable + Sync + Send + 'static, BDI: AtomicPod, 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<BD, BDI> Default for BatchedInstanceBuffers<BD, BDI>

where BD: GpuArrayBufferable + Sync + Send + 'static, BDI: AtomicPod,

fn default() -> Self

Returns the “default value” for a type.

impl<BD, BDI> Resource for BatchedInstanceBuffers<BD, BDI>

where BD: GpuArrayBufferable + Sync + Send + 'static, BDI: AtomicPod, Self: Send + Sync + 'static,