Enum naga::Binding

pub enum Binding {
    BuiltIn(BuiltIn),
    Location {
        location: u32,
        second_blend_source: bool,
        interpolation: Option<Interpolation>,
        sampling: Option<Sampling>,
    },
}

Describes how an input/output variable is to be bound.

Variants

BuiltIn(BuiltIn)

Built-in shader variable.

Location

Fields

location: u32

second_blend_source: bool

Indicates the 2nd input to the blender when dual-source blending.

interpolation: Option<Interpolation>

sampling: Option<Sampling>

Indexed location.

Values passed from the Vertex stage to the Fragment stage must have their interpolation defaulted (i.e. not None) by the front end as appropriate for that language.

For other stages, we permit interpolations even though they’re ignored. When a front end is parsing a struct type, it usually doesn’t know what stages will be using it for IO, so it’s easiest if it can apply the defaults to anything with a Location binding, just in case.

For anything other than floating-point scalars and vectors, the interpolation must be Flat.

Implementations

impl Binding

pub fn apply_default_interpolation(&mut self, ty: &TypeInner)

Apply the usual default interpolation for ty to binding.

This function is a utility front ends may use to satisfy the Naga IR’s requirement, meant to ensure that input languages’ policies have been applied appropriately, that all I/O Bindings from the vertex shader to the fragment shader must have non-None interpolation values.

All the shader languages Naga supports have similar rules: perspective-correct, center-sampled interpolation is the default for any binding that can vary, and everything else either defaults to flat, or requires an explicit flat qualifier/attribute/what-have-you.

If binding is not a Location binding, or if its interpolation is already set, then make no changes. Otherwise, set binding’s interpolation and sampling to reasonable defaults depending on ty, the type of the value being interpolated:

• If ty is a floating-point scalar, vector, or matrix type, then default to Perspective interpolation and Center sampling.

• If ty is an integral scalar or vector, then default to Flat interpolation, which has no associated sampling.

• For any other types, make no change. Such types are not permitted as user-defined IO values, and will probably be flagged by the verifier

When structs appear in input or output types, each member ought to have its own Binding, so structs are simply covered by the third case.

impl Binding

pub const fn to_built_in(&self) -> Option<BuiltIn>

Trait Implementations

impl<'arbitrary> Arbitrary<'arbitrary> for Binding

fn arbitrary(u: &mut Unstructured<'arbitrary>) -> Result<Self>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest(u: Unstructured<'arbitrary>) -> Result<Self>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl Clone for Binding

fn clone(&self) -> Binding

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Binding

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Binding

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for Binding

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 Binding

fn eq(&self, other: &Binding) -> 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 Serialize for Binding

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Binding

impl StructuralEq for Binding

impl StructuralPartialEq for Binding