pub enum VertexStepMode {
Vertex,
Instance,
}
Expand description
Whether a vertex buffer is indexed by vertex or by instance.
Consider a call to RenderPass::draw
like this:
render_pass.draw(vertices, instances)
where vertices
is a Range<u32>
of vertex indices, and
instances
is a Range<u32>
of instance indices.
For this call, wgpu
invokes the vertex shader entry point once
for every possible (v, i)
pair, where v
is drawn from
vertices
and i
is drawn from instances
. These invocations
may happen in any order, and will usually run in parallel.
Each vertex buffer has a step mode, established by the
step_mode
field of its VertexBufferLayout
, given when the
pipeline was created. Buffers whose step mode is Vertex
use
v
as the index into their contents, whereas buffers whose step
mode is Instance
use i
. The indicated buffer element then
contributes zero or more attribute values for the (v, i)
vertex
shader invocation to use, based on the VertexBufferLayout
’s
attributes
list.
You can visualize the results from all these vertex shader
invocations as a matrix with a row for each i
from instances
,
and with a column for each v
from vertices
. In one sense, v
and i
are symmetrical: both are used to index vertex buffers and
provide attribute values. But the key difference between v
and
i
is that line and triangle primitives are built from the values
of each row, along which i
is constant and v
varies, not the
columns.
An indexed draw call works similarly:
render_pass.draw_indexed(indices, base_vertex, instances)
The only difference is that v
values are drawn from the contents
of the index buffer—specifically, the subrange of the index
buffer given by indices
—instead of simply being sequential
integers, as they are in a draw
call.
A non-instanced call, where instances
is 0..1
, is simply a
matrix with only one row.
Corresponds to WebGPU GPUVertexStepMode
.
Variants
Vertex
Vertex data is advanced every vertex.
Instance
Vertex data is advanced every instance.
Trait Implementations
impl Clone for VertexStepMode
impl Clone for VertexStepMode
fn clone(&self) -> VertexStepMode
fn clone(&self) -> VertexStepMode
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreimpl Debug for VertexStepMode
impl Debug for VertexStepMode
impl Default for VertexStepMode
impl Default for VertexStepMode
fn default() -> VertexStepMode
fn default() -> VertexStepMode
impl Hash for VertexStepMode
impl Hash for VertexStepMode
impl PartialEq<VertexStepMode> for VertexStepMode
impl PartialEq<VertexStepMode> for VertexStepMode
fn eq(&self, other: &VertexStepMode) -> bool
fn eq(&self, other: &VertexStepMode) -> bool
impl Copy for VertexStepMode
impl Eq for VertexStepMode
impl StructuralEq for VertexStepMode
impl StructuralPartialEq for VertexStepMode
Auto Trait Implementations
impl RefUnwindSafe for VertexStepMode
impl Send for VertexStepMode
impl Sync for VertexStepMode
impl Unpin for VertexStepMode
impl UnwindSafe for VertexStepMode
Blanket Implementations
sourceimpl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
sourceimpl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
sourcefn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>
fn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>
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
. Read moresourcefn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
. Read moresourcefn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s. Read moresourcefn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s. Read moresourceimpl<T> DowncastSync for Twhere
T: Any + Send + Sync,
impl<T> DowncastSync for Twhere
T: Any + Send + Sync,
sourceimpl<Q, K> Equivalent<K> for Qwhere
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
impl<Q, K> Equivalent<K> for Qwhere
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
sourcefn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.sourceimpl<T> FromWorld for Twhere
T: Default,
impl<T> FromWorld for Twhere
T: Default,
sourcefn from_world(_world: &mut World) -> T
fn from_world(_world: &mut World) -> T
Self
using data from the given World