This documentation is for a prerelease version of O3DE. Click here to switch to the latest release, or select a version from the dropdown.

Version:

Decal Component

The Decal component enables an entity to project a material onto a mesh. A large number of overlapping decals can be applied to a single mesh.

Provider

Atom Gem

Limitations

There are a few limitations with the Decal component:

  • While decal textures can be any arbitrary resolution, the decal system only supports up to 5 unique texture resolutions. You can create additional decal textures, but the texture resolution must be one of the 5 sizes already in use.
  • All decal materials must specify both a base color and normal map. If any decal material is missing a normal map, then no decals will use a normal map.
  • The base color and normal textures must be the same size.
  • Opacity in decal materials is only supported in the alpha channel of the base color texture. Although materials in general support opacity in separate textures, this does not appear correctly for decals.

Properties

Decal component UI

PropertyDescriptionValuesDefault
Attenuation AngleControls how much the angle between surface and the decal projection affects the decal opacity. Higher values make the decal more transparent as the angle increases so that the decal doesn’t appear to wrap around the surface.0.0 to 1.01.0
OpacityDetermines how transparent the decal is.0.0 to 1.01.0
Sort KeySets the sort order for the decal. When multiple decals are projected onto a surface, decals with higher values display on top.0 to 25516
MaterialThe material that the decal will use.

Examples

Example of a decal with attenuation angle set to 0. Less attenuation means more wrapping around objects.

Decal component attenuation angle 0 example

Example of a decal with attenuation angle set to 1. More attenuation means less wrapping around objects.

Decal component attenuation angle 1 example

The black scorch mark decal has a larger sort key than the orange dirt decal and thus is on top.

Decal component sorting order example