Enum DecalProjection 

#[non_exhaustive]
pub enum DecalProjection {
    Planar,
    TriPlanar {
        blend_sharpness: f32,
    },
    Cylindrical {
        facing: CylindricalFacing,
    },
}

How a decal texture is projected onto the receiver surface.

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.

Planar

Standard projection: the decal texture is mapped using the XY axes of the decal’s local space. Works well on flat or gently curved surfaces aligned with the projection direction.

TriPlanar

Tri-planar projection: the texture is sampled three times (from the X, Y, and Z axes of decal local space) and blended by the surface normal. Avoids UV stretching on corners and non-planar surfaces. blend_sharpness controls how quickly the blend transitions at edges between faces: higher values produce a sharper transition, lower values a wider blend zone. Three texture samples per pixel; the bandwidth cost is documented in the field.

Fields

blend_sharpness: f32

Exponent applied to the absolute normal components before normalising blend weights. Range 1.0-16.0; 4.0 is a good starting value.

Cylindrical

Cylindrical projection: wraps the texture around a cylinder whose axis is the decal’s local Z axis. UV.x is the angle around the axis (0 at local +X, wrapping at 360 degrees back to the start); UV.y is position along the axis (0 at local -Z, 1 at local +Z). The decal volume is a cylinder of radius 0.5 and height 1.0 in local space.

Use this for labels on pipes, warning bands on columns, or any decal that wraps continuously around a curved surface.

Fields

facing: CylindricalFacing

Which side of the cylinder surface to project onto.

Trait Implementations

impl Clone for DecalProjection

fn clone(&self) -> DecalProjection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DecalProjection

impl Debug for DecalProjection

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

Formats the value using the given formatter.

impl Default for DecalProjection

fn default() -> DecalProjection

Returns the “default value” for a type.

impl PartialEq for DecalProjection

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