pub struct BatchedInstanceBuffers<BD, BDI>
where BD: GpuArrayBufferable + Sync + Send + 'static, BDI: Pod,
{ pub data_buffer: UninitBufferVec<BD>, pub work_item_buffers: EntityHashMap<Entity, PreprocessWorkItemBuffer>, pub current_input_buffer: RawBufferVec<BDI>, pub previous_input_buffer: RawBufferVec<BDI>, }
Expand description

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§

§data_buffer: UninitBufferVec<BD>

A storage area for the buffer data that the GPU compute shader is expected to write to.

There will be one entry for each index.

§work_item_buffers: EntityHashMap<Entity, PreprocessWorkItemBuffer>

The index of the buffer data in the current input buffer that corresponds to each instance.

This is keyed off each view. Each view has a separate buffer.

§current_input_buffer: RawBufferVec<BDI>

The uniform data inputs for the current frame.

These are uploaded during the extraction phase.

§previous_input_buffer: RawBufferVec<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.

Implementations§

source§

impl<BD, BDI> BatchedInstanceBuffers<BD, BDI>
where BD: GpuArrayBufferable + Sync + Send + 'static, BDI: Pod,

source

pub fn new() -> Self

Creates new buffers.

source

pub fn instance_data_binding(&self) -> Option<BindingResource<'_>>

Returns the binding of the buffer that contains the per-instance data.

This buffer needs to be filled in via a compute shader.

source

pub fn clear(&mut self)

Clears out the buffers in preparation for a new frame.

Trait Implementations§

source§

impl<BD, BDI> Default for BatchedInstanceBuffers<BD, BDI>
where BD: GpuArrayBufferable + Sync + Send + 'static, BDI: Pod,

source§

fn default() -> Self

Returns the “default value” for a type. Read more
source§

impl<BD, BDI> Resource for BatchedInstanceBuffers<BD, BDI>
where BD: GpuArrayBufferable + Sync + Send + 'static, BDI: Pod, Self: Send + Sync + 'static,

Auto Trait Implementations§

§

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

§

impl<BD, BDI> RefUnwindSafe for BatchedInstanceBuffers<BD, BDI>
where BD: RefUnwindSafe, BDI: RefUnwindSafe,

§

impl<BD, BDI> Send for BatchedInstanceBuffers<BD, BDI>
where BDI: Send,

§

impl<BD, BDI> Sync for BatchedInstanceBuffers<BD, BDI>
where BDI: Sync,

§

impl<BD, BDI> Unpin for BatchedInstanceBuffers<BD, BDI>
where BD: Unpin, BDI: Unpin,

§

impl<BD, BDI> UnwindSafe for BatchedInstanceBuffers<BD, BDI>
where BD: UnwindSafe, BDI: UnwindSafe,

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T, U> AsBindGroupShaderType<U> for T
where U: ShaderType, &'a T: for<'a> Into<U>,

source§

fn as_bind_group_shader_type(&self, _images: &RenderAssets<GpuImage>) -> U

Return the T ShaderType for self. When used in AsBindGroup derives, it is safe to assume that all images in self exist.
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> Downcast<T> for T

source§

fn downcast(&self) -> &T

source§

impl<T> Downcast for T
where T: Any,

source§

fn into_any(self: Box<T>) -> Box<dyn Any>

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.
source§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
source§

fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
source§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
source§

impl<T> DowncastSync for T
where T: Any + Send + Sync,

source§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Sync + Send>

Convert Arc<Trait> (where Trait: Downcast) to Arc<Any>. Arc<Any> can then be further downcast into Arc<ConcreteType> where ConcreteType implements Trait.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> FromWorld for T
where T: Default,

source§

fn from_world(_world: &mut World) -> T

Creates Self using data from the given World.
source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> Upcast<T> for T

source§

fn upcast(&self) -> Option<&T>

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

impl<T> ConditionalSend for T
where T: Send,

source§

impl<T> Settings for T
where T: 'static + Send + Sync,

source§

impl<T> WasmNotSend for T
where T: Send,

source§

impl<T> WasmNotSendSync for T

source§

impl<T> WasmNotSync for T
where T: Sync,