Struct PrimitiveState

#[repr(C)]
pub struct PrimitiveState {
    pub topology: PrimitiveTopology,
    pub strip_index_format: Option<IndexFormat>,
    pub front_face: FrontFace,
    pub cull_mode: Option<Face>,
    pub unclipped_depth: bool,
    pub polygon_mode: PolygonMode,
    pub conservative: bool,
}

Describes the state of primitive assembly and rasterization in a render pipeline.

Corresponds to WebGPU GPUPrimitiveState.

Fields

topology: PrimitiveTopology

The primitive topology used to interpret vertices.

strip_index_format: Option<IndexFormat>

When drawing strip topologies with indices, this is the required format for the index buffer. This has no effect on non-indexed or non-strip draws.

Specifying this value enables primitive restart, allowing individual strips to be separated with the index value 0xFFFF when using Uint16, or 0xFFFFFFFF when using Uint32.

front_face: FrontFace

The face to consider the front for the purpose of culling and stencil operations.

cull_mode: Option<Face>

The face culling mode.

unclipped_depth: bool

If set to true, the polygon depth is not clipped to 0-1 before rasterization.

Enabling this requires Features::DEPTH_CLIP_CONTROL to be enabled.

polygon_mode: PolygonMode

Controls the way each polygon is rasterized. Can be either Fill (default), Line or Point

Setting this to Line requires Features::POLYGON_MODE_LINE to be enabled.

Setting this to Point requires Features::POLYGON_MODE_POINT to be enabled.

conservative: bool

If set to true, the primitives are rendered with conservative overestimation. I.e. any rastered pixel touched by it is filled. Only valid for [PolygonMode::Fill]!

Enabling this requires Features::CONSERVATIVE_RASTERIZATION to be enabled.

Trait Implementations

impl Clone for PrimitiveState

fn clone(&self) -> PrimitiveState

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PrimitiveState

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

Formats the value using the given formatter.

impl Default for PrimitiveState

fn default() -> PrimitiveState

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PrimitiveState

fn deserialize<__D>( __deserializer: __D, ) -> Result<PrimitiveState, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for PrimitiveState

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

where __H: Hasher,

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 PrimitiveState

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Serialize for PrimitiveState

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for PrimitiveState

impl Eq for PrimitiveState

impl StructuralPartialEq for PrimitiveState