Decal
Updated: 4 Nov 2024
Add decals to surfaces in the scene
Decal
Method #
This node projects images directly onto surfaces within a 3D environment. Instead of altering the original texture, the decal “layers” over it, allowing you to add visual effects like dirt marks, graffiti, impact marks, or other details. This approach makes adding visual details more flexible and resource-efficient, as it avoids the need to recreate or overload the original textures for each new visual addition.
All nodes connected to this node are treated as if flowing to the parent node, and inherits any transformation changes along the chain.
Parameters
Parameter Details Position X
The objects position along the local x-axis.
Position Y
The objects position along the local y-axis.
Position Z
The objects position along the local z-axis.
Rotation Heading
The objects rotation around the local y-axis.
Rotation Pitch
The objects rotation around the local x-axis.
Rotation Bank
The objects rotation around the local z-axis.
Scale X
The objects scale along the local x-axis.
Scale Y
The objects scale along the local y-axis.
Scale Z
The objects scale along the local z-axis.
Control the inheritance of the transforms from the parent.
Parameter Details Position
Toggle inheritance of the Position from the parent.
Rotation
Toggle inheritance of the Rotation from the parent.
Scale
Toggle inheritance of the Scale from the parent.
World Position Only
Inherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties.
Inherit Time
Toggle inheritance of time from the parent.
These properties control the core behaviours of the node.
Parameter Details Mapping Type
Controls how the texture is applied to the surface.
- Planar : Applies the texture in a flat, 2D manner.
- Perspective : Applies the texture with perspective distortion.
Colour
Controls the base color of the material.
Blend Mode
Controls how the Decal blends with the existing object material.
- Linear Straight : Blends the decal linearly without any additional effects.
- Linear Pre Mul : Blends the decal with pre-multiplied alpha.
- Add : Blends the decal by adding its color to the underlying surface.
- Subtract : Blends the decal by subtracting its color from the underlying surface.
- Multiply : Blends the decal by multiplying its color with the underlying surface.
Blend Amount
Controls the strength of the blend effect.
Double Sided
Controls whether the Decal is applied to both sides of the mesh.
Normal Angle Threshold
Uses normals to determine the max angle at which the decal is applied.
Normal Angle Fade
Controls the softness of the edge of the decal based on the angle of the surface normal.
Texture Filter Mode
Controls the filtering method used for the texture.
- Point : Each pixel is mapped to the nearest texel.
- Bilinear : Uses linear interpolation between adjacent texels.
- Anisotropic : Samples multiple texels along the direction of the surface.
Texture Wrap Mode U
Controls the wrapping mode for the texture in the U direction.
- Repeat : Repeats the texture in the U direction.
- Clamp : Clamps the texture coordinates to the [0,1] range in the U direction.
Texture Wrap Mode V
Controls the wrapping mode for the texture in the V direction.
- Repeat : Repeats the texture in the V direction.
- Clamp : Clamps the texture coordinates to the [0,1] range in the V direction.
Show Guides
Displays guides for lining up the decal.
Show Projection Bounds
Displays the projection bounds of the decal.
These properties control the decal output mapping in UV space.
Parameter Details Use Image Aspect Ratio
Uses the input image aspect ratio.
Flip X
Flips the texture on the ‘X’ axis.
Flip Y
Flips the texture on the ‘Y’ axis.
UV Scale X
Scale the mesh UV along the X axis.
UV Scale Y
Scale the mesh UV along the Y axis.
UV Offset X
Move the mesh UV along the X axis.
UV Offset Y
Move the mesh UV along the Y axis.
These properties control where the deformer affects the geometry.
Parameter Details Enabled
Enable falloff from the position of the deformer.
Shape
Select which shape to use to draw falloff from.
- Sphere : Falloff is drawn outward from a central point, forming a spherical falloff.
- Cylinder : Falloff is drawn outward from a line, forming a cylindrical falloff.
- Plane : Falloff is drawn outward from a plane.
Shape Orientation
Along which axis the shape should be drawn.
Outer Range
The outer range from which the falloff is calculated from.
Inner Range
The inner range from which the falloff is calculated from.
Curve Power
How quickly the falloff drops to 0 at the outer falloff.
Invert
Invert the direction of the falloff.
Inputs
| Parameter | Details |
|---|---|
| Position X | The objects position along the local x-axis. |
| Position Y | The objects position along the local y-axis. |
| Position Z | The objects position along the local z-axis. |
| Rotation Heading | The objects rotation around the local y-axis. |
| Rotation Pitch | The objects rotation around the local x-axis. |
| Rotation Bank | The objects rotation around the local z-axis. |
| Scale X | The objects scale along the local x-axis. |
| Scale Y | The objects scale along the local y-axis. |
| Scale Z | The objects scale along the local z-axis. |
Control the inheritance of the transforms from the parent.
| Parameter | Details |
|---|---|
| Position | Toggle inheritance of the Position from the parent. |
| Rotation | Toggle inheritance of the Rotation from the parent. |
| Scale | Toggle inheritance of the Scale from the parent. |
| World Position Only | Inherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties. |
| Inherit Time | Toggle inheritance of time from the parent. |
These properties control the core behaviours of the node.
| Parameter | Details |
|---|---|
| Mapping Type |
Controls how the texture is applied to the surface.
|
| Colour | Controls the base color of the material. |
| Blend Mode |
Controls how the Decal blends with the existing object material.
|
| Blend Amount | Controls the strength of the blend effect. |
| Double Sided | Controls whether the Decal is applied to both sides of the mesh. |
| Normal Angle Threshold | Uses normals to determine the max angle at which the decal is applied. |
| Normal Angle Fade | Controls the softness of the edge of the decal based on the angle of the surface normal. |
| Texture Filter Mode |
Controls the filtering method used for the texture.
|
| Texture Wrap Mode U |
Controls the wrapping mode for the texture in the U direction.
|
| Texture Wrap Mode V |
Controls the wrapping mode for the texture in the V direction.
|
| Show Guides | Displays guides for lining up the decal. |
| Show Projection Bounds | Displays the projection bounds of the decal. |
These properties control the decal output mapping in UV space.
| Parameter | Details |
|---|---|
| Use Image Aspect Ratio | Uses the input image aspect ratio. |
| Flip X | Flips the texture on the ‘X’ axis. |
| Flip Y | Flips the texture on the ‘Y’ axis. |
| UV Scale X | Scale the mesh UV along the X axis. |
| UV Scale Y | Scale the mesh UV along the Y axis. |
| UV Offset X | Move the mesh UV along the X axis. |
| UV Offset Y | Move the mesh UV along the Y axis. |
These properties control where the deformer affects the geometry.
| Parameter | Details |
|---|---|
| Enabled | Enable falloff from the position of the deformer. |
| Shape |
Select which shape to use to draw falloff from.
|
| Shape Orientation | Along which axis the shape should be drawn. |
| Outer Range | The outer range from which the falloff is calculated from. |
| Inner Range | The inner range from which the falloff is calculated from. |
| Curve Power | How quickly the falloff drops to 0 at the outer falloff. |
| Invert | Invert the direction of the falloff. |
| Name | Description | Typical Input |
|---|---|---|
| Image | Input image to be used as a Decal. | Video Loader |
| Affected Object Nodes | Applies the Decal to the specified object nodes. | 3D Primitive |
| Excluded Object Nodes | Prevents the Decal from being applied to the specified object nodes. | 3D Primitive |
| Falloff Node | Use an input node to control the transformation values of the falloff. | Null |
| Projection Transform | Copies the transform of the input node, and uses it to project the Decal onto the surface. | Null |
| Transform Modifiers | Apply the transforms of another node to this node. | Null |
| Target Node | Modifiy the rotations of the node to always direct the z axis towards the input. | Null |
| Local Transform Override | Apply the transforms of another node to this node, relative to its parent. | Null |