Struct Decal 

pub struct Decal {
    pub asset_id: AssetId,
    pub texture: Option<TextureHandle>,
    pub position: [f32; 3],
    pub rotation_deg: [f32; 3],
    pub size: [f32; 3],
    pub tint: [f32; 4],
    pub visible: bool,
}

A projected texture stamped onto whatever scene geometry sits inside the decal’s oriented box.

The decal is a box volume positioned by position/rotation_deg/size in world space. The texture is projected down the box’s local +Y axis onto the local X-Z plane and stamped onto the surfaces inside the box; anything outside the box is unaffected. Surfaces near the box’s top and bottom faces fade out so the stamp doesn’t show a hard edge on a curved surface.

The defaults orient the decal as a ground stamp: a flat 1×1 m square laid on the world X-Z plane, projecting down from +Y. To stamp a wall, rotate so local +Y points into the surface (e.g. rotation_deg:[0,0,90] for a +X wall).

Decals blend over the lit image without affecting depth, so they layer on top of the surfaces they stamp.

Decal {
    position: [2.0, 0.01, -1.5],
    size: [1.5, 0.5, 1.5],
    ..Default::default()
};

Fields

asset_id: AssetId

Asset identity; injected via inject_name. Not part of args.

texture: Option<TextureHandle>

The Texture asset projected onto the scene.

position: [f32; 3]

World-space position of the decal box’s centre.

rotation_deg: [f32; 3]

Euler rotation in degrees [pitch, yaw, roll], YXZ order, same as Prop.

size: [f32; 3]

Local-space box extents. Local +Y is the projection axis; the texture is sampled on the local X-Z plane. A non-positive component disables the decal.

tint: [f32; 4]

Linear-space RGBA tint multiplied with the sampled texture. The alpha channel scales the final blend, so [1,1,1,0] hides the decal.

visible: bool

When false the decal is skipped each frame.

Trait Implementations

impl Clone for Decal

fn clone(&self) -> Decal

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Component for Decal

const NAME: &'static str = "Decal"

The registry name a world authors this component under.

fn inject_name(&mut self, id: AssetId)

Called after construction to inject the asset’s identity from the blob def. Only meaningful for components that look themselves up by id at runtime. The default implementation does nothing.

fn from_baked(bytes: &[u8]) -> Result<Self, CnResult>

Reconstruct this component from a blob record, whose bytes are the serialized runtime component (cook already ran the asset -> component translation). The default rejects: runtime-only components are never stored in a blob, so only loadable types provide an implementation.

fn inject_locator(&mut self, _locator: PayloadLocator)

Called after construction to inject the payload locator from the blob def. Only meaningful for components with a compiled payload. The default implementation does nothing (correct for most components).

impl ComponentSlot for Decal

const DISCRIMINANT: u8

The component type’s stable id, used as its ComponentId.

fn slot(s: &ComponentStorage) -> &Column<Self>

Borrow this type’s column out of the storage.

fn slot_mut(s: &mut ComponentStorage) -> &mut Column<Self>

Mutably borrow this type’s column out of the storage.

impl Debug for Decal

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

Formats the value using the given formatter.

impl Default for Decal

fn default() -> Decal

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Decal

where Decal: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Decal> for ComponentAsset

fn from(c: Decal) -> Self

Converts to this type from the input type.

impl RuntimeComponent for Decal

impl Serialize for Decal

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.