Decal

public float AlbedoMix { get; set; }

Base-color modification weight. Zero retains the original surface albedo but does not disable Normal/ORM when TextureAlbedo provides an alpha mask. Use Visible=false to disable the entire instance.

public uint CullMask { get; set; }

Receiver rendering-layer bitmask. The decal applies when it overlaps the mesh VisualInstance3D.Layers. This is not PhysicsBody3D.CollisionLayer or a single layer number. The example CullMask=2 selects floor meshes with Layers=2.

public float DistanceFadeBegin { get; set; }

Camera-to-decal-position distance after which fading begins when DistanceFadeEnabled=true. Contribution is retained before it. Use a nonnegative distance for a predictable setup.

public bool DistanceFadeEnabled { get; set; }

Enables fading by distance between the camera and decal position. Uses DistanceFadeBegin and DistanceFadeLength. This is visual decal optimization, not script suspension or Entity removal.

public float DistanceFadeLength { get; set; }

Transition length after DistanceFadeBegin. With distance fade enabled, the decal is excluded beyond Begin+Length. Use a positive value: zero length does not define a smooth transition.

public float EmissionEnergy { get; set; }

TextureEmission multiplier. Zero removes that contribution, not albedo/Normal/ORM. Decal emission does not create a Light3D or guarantee lighting of neighboring meshes.

public float LowerFade { get; set; }

Nonnegative falloff exponent toward the projection volume’s negative local-Y boundary. Zero removes this gradient; negative assignments become zero. Reducing Size.Y changes the intersection region rather than this exponent.

public Color Modulate { get; set; }

RGB multiplies albedo and emission colors. Alpha attenuates albedo and its mask-driven Normal/ORM blending; emission is not multiplied by Modulate.A. Alpha=0 therefore does not reliably disable the whole decal.

public float NormalFade { get; set; }

Attenuates projection on surfaces whose geometric normals face an unsuitable direction. A positive value enables angular falloff; this is not TextureNormal strength. The example uses 0.5; angular edge cases are not separately verified.

public Vector3 Size { get; set; }

Full projection-volume dimensions along local axes. X/Z define texture coverage and Y defines depth. The volume must intersect the surface. Assignment clamps every component to at least 0.001; these are not half-extents.

public Texture2D TextureAlbedo { get; set; }

Decal color and alpha mask. Alpha also controls Normal and ORM blending; to change only those channels, retain the Albedo texture and set AlbedoMix=0. Removing this texture is not equivalent to zero AlbedoMix.

public Texture2D TextureEmission { get; set; }

Additive emission from texture RGB, independent of TextureAlbedo and its alpha mask. Non-emitting areas must be black in RGB; transparency alone does not guarantee zero emission. Brightness is multiplied by EmissionEnergy and Modulate.RGB.

public Texture2D TextureNormal { get; set; }

Normal map modifies surface lighting within the TextureAlbedo alpha mask rather than geometry or collision. For a normal-only decal, assign both textures and AlbedoMix=0. The example does not validate imported-map orientation or authoring-tool conventions.

public Texture2D TextureOrm { get; set; }

Packed channels: R ambient occlusion, G roughness, B metallic. Blending uses TextureAlbedo alpha. The example verifies a material change with AlbedoMix=0 and removal of that influence when the Albedo texture is absent.

public float UpperFade { get; set; }

Nonnegative falloff exponent toward the projection volume’s positive local-Y boundary. Zero removes this gradient; negative assignments become zero. This is separate from camera-distance fade.

public float GetAlbedoMix();

Reads AlbedoMix from this instance. The value alone does not establish visible projection onto a surface.

public uint GetCullMask();

Reads CullMask from this instance. The value alone does not establish visible projection onto a surface.

public Color GetModulate();

Reads Modulate from this instance. The value alone does not establish visible projection onto a surface.

public Vector3 GetSize();

Reads Size from this instance. The value alone does not establish visible projection onto a surface.

public Texture2D GetTexture(Decal.DecalTexture type);

Reads the resource assigned to the selected channel. Does not capture projection output or return a surface image.

public void SetAlbedoMix(float energy);

Sets AlbedoMix. Base-color modification weight. Zero retains the original surface albedo but does not disable Normal/ORM when TextureAlbedo provides an alpha mask. Use Visible=false to disable the entire instance.

public void SetCullMask(uint mask);

Sets CullMask. Receiver rendering-layer bitmask. The decal applies when it overlaps the mesh VisualInstance3D.Layers. This is not PhysicsBody3D.CollisionLayer or a single layer number. The example CullMask=2 selects floor meshes with Layers=2.

public void SetModulate(Color color);

Sets Modulate. RGB multiplies albedo and emission colors. Alpha attenuates albedo and its mask-driven Normal/ORM blending; emission is not multiplied by Modulate.A. Alpha=0 therefore does not reliably disable the whole decal.

public void SetSize(Vector3 size);

Sets Size. Full projection-volume dimensions along local axes. X/Z define texture coverage and Y defines depth. The volume must intersect the surface. Assignment clamps every component to at least 0.001; these are not half-extents.

public void SetTexture(Decal.DecalTexture type, Texture2D texture);

Assigns a texture to the specified decal channel. null clears the channel. Normal/ORM require a separate TextureAlbedo alpha mask; Emission is processed independently.