Enum vulkano::pipeline::graphics::input_assembly::PrimitiveTopology

#[non_exhaustive]
#[repr(i32)]
pub enum PrimitiveTopology {
    PointList = 0,
    LineList = 1,
    LineStrip = 2,
    TriangleList = 3,
    TriangleStrip = 4,
    TriangleFan = 5,
    LineListWithAdjacency = 6,
    LineStripWithAdjacency = 7,
    TriangleListWithAdjacency = 8,
    TriangleStripWithAdjacency = 9,
    PatchList = 10,
}

Describes how vertices must be grouped together to form primitives.

When DynamicState::PrimitiveTopology is used, if the dynamic_primitive_topology_unrestricted device property is false, then the dynamically set primitive topology must belong to the same topology class as what was set during pipeline creation. In practice, this is simply the first word in the name of the topology.

When enabling primitive restart, “list” topologies require a feature to be enabled on the device:

• The PatchList topology requires the primitive_topology_patch_list_restart feature.
• All other “list” topologies require the primitive_topology_list_restart feature.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

PointList = 0

A series of separate point primitives.

Topology class: Point

LineList = 1

A series of separate line primitives.

Topology class: Line

LineStrip = 2

A series of consecutive line primitives, with consecutive lines sharing a vertex.

Topology class: Line

TriangleList = 3

A series of separate triangle primitives.

Topology class: Triangle

TriangleStrip = 4

A series of consecutive triangle primitives, with consecutive triangles sharing an edge (two vertices).

Topology class: Triangle

TriangleFan = 5

A series of consecutive triangle primitives, with all triangles sharing a common vertex (the first).

On portability subset devices, the triangle_fans feature must be enabled on the device.

Topology class: Triangle

LineListWithAdjacency = 6

As LineList, but with adjacency, used in combination with geometry shaders. Requires the [geometry_shader`](crate::device::Features::geometry_shader) feature.

Topology class: Line

LineStripWithAdjacency = 7

As LineStrip, but with adjacency, used in combination with geometry shaders. Requires the geometry_shader feature.

Topology class: Line

TriangleListWithAdjacency = 8

As TriangleList, but with adjacency, used in combination with geometry shaders. Requires the geometry_shader feature.

Topology class: Triangle

TriangleStripWithAdjacency = 9

As TriangleStrip, but with adjacency, used in combination with geometry shaders. Requires the geometry_shader feature.

Topology class: Triangle

PatchList = 10

Separate patch primitives, used in combination with tessellation shaders. Requires the tessellation_shader feature.

Topology class: Patch

Trait Implementations

impl Clone for PrimitiveTopology

fn clone(&self) -> PrimitiveTopology

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PrimitiveTopology

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PrimitiveTopology

fn default() -> Self

Returns the “default value” for a type.

impl From<PrimitiveTopology> for PrimitiveTopology

fn from(val: PrimitiveTopology) -> Self

Converts to this type from the input type.

impl Hash for PrimitiveTopology

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for PrimitiveTopology

fn eq(&self, other: &PrimitiveTopology) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TryFrom<PrimitiveTopology> for PrimitiveTopology

type Error = ()

The type returned in the event of a conversion error.

fn try_from(val: PrimitiveTopology) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for PrimitiveTopology

impl Eq for PrimitiveTopology

impl StructuralEq for PrimitiveTopology

impl StructuralPartialEq for PrimitiveTopology