Colour Ramp Deformer
Updated: 3 Feb 2025
Colours a mesh based on an input Colour Ramp
Colour Ramp Deformer
Method #
This node applies the colour from an input Colour Ramp to the vertex colours of a mesh.
Parameters
These properties control the 3D transforms of the node. Transforms will generally be inherited by child nodes, although they can be ignored through the Inherit Transform Channels attributes.
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 Blend Amount Global override for how much the deformer affects the mesh.
Apply Mode Choose whether the deformer applies to the individual vertices or the mesh chunks.
- Vertex Positions : ERROR: Variable not found: {att-node-deformers-vertex-source-mode-vertex-positions}
- Chunks : ERROR: Variable not found: {att-node-deformers-vertex-source-mode-mesh-chunks}
Transform Space Choose which transform space the deformer uses for deformation. Does not affect falloffs.
- Local : Deformations are calculated in the Local Space of the object, so transformations of the parent mesh will not affect the deformation.
- World : Deformations are calculated in the World Space of the scene, so transformations of the parent mesh will apply the deformer differently depending on the mesh position.
Time Mode How the deformer updates with relation to the timecode.
- Locked To Timecode : The deformer deformations are locked to the timecode and the same time will always yield the same deformations.
- Running / Looping : The deformer deformations are disconnected from the timecode and will run seamlessly at the end of the composition.
Source Channel Change how the colour ramp is applied to the parent mesh.
- Texture Coordinate U : Apply the colour ramp to the UV map of the mesh along the U axis.
- Texture Coordinate V : Apply the colour ramp to the UV map of the mesh along the V axis.
- Position X : Apply the colour ramp to the mesh dependant on the position of the deformer along the X axis.
- Position Y : Apply the colour ramp to the mesh dependant on the position of the deformer along the Y axis.
- Position Z : Apply the colour ramp to the mesh dependant on the position of the deformer along the Z axis.
- Distance : Apply the colour outwardly from position of the deformer, fading away with distance.
- Fractal Noise : Give each vertex a random weight based on 3D fractal noise and apply the colour ramp based on those weights.
- Vertex Index : Apply the colour ramp along the vertex index.
- Weightmap Channel : Apply the colour ramp using an input weightmap on the object.
Source Scale Scale the size of the input colour ramp.
Source Offset Offset the start of the colour ramp.
Modulation Function How colour should be applied at the end of the ramp.
- Clamp : The final colour in the colour ramp is used to infinity.
- Repeat : The ramp is repeated to infinity.
- Sine : The ramp goes back to the beginning and starts again.
Noise Scale Scale the size of the generated fractal noise. Only functions with Fractal Noise set in the Source Channel.
Lacunarity How large the gaps between larger areas of noise are. Only functions with Fractal Noise set in the Source Channel.
Gain The overall smoothness of the generated fractal noise. Only functions with Fractal Noise set in the Source Channel.
Animation Rate The speed at which the fractal noise is animated. Only functions with Fractal Noise set in the Source Channel.
These properties control where the deformer affects the geometry.
Parameter Details Use Falloff Enable falloff from the position of the deformer.
Falloff Shape Select which shape to use to draw falloff from.
- Sphere : How quickly the falloff drops to 0 at the outer falloff.
- Cylinder - X : Falloff is drawn radially outward from a line along the x axis, forming a cylindrical falloff.
- Cylinder - Y : Falloff is drawn radially outward from a line along the y axis, forming a cylindrical falloff.
- Cylinder - Z : Falloff is drawn radially outward from a line along the z axis, forming a cylindrical falloff.
- Plane - X : Falloff is drawn outward from a plane formed on the YZ axis.
- Plane - Y : Falloff is drawn outward from a plane formed on the XZ axis.
- Plane - Z : Falloff is drawn outward from a plane formed on the XY axis.
Falloff Range Limits the range the deformer is effective at.
Falloff Inner Range The inner range from which the falloff is calculated from.
Falloff Curve Power How quickly the falloff drops to 0 at the outer falloff.
Invert Falloff Invert the direction of the falloff.
Falloff Curve Visualises the falloff curve, from being completely in effect to no longer effective.
Inputs
These properties control the 3D transforms of the node. Transforms will generally be inherited by child nodes, although they can be ignored through the Inherit Transform Channels attributes.
| 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 |
|---|---|
| Blend Amount | Global override for how much the deformer affects the mesh. |
| Apply Mode | Choose whether the deformer applies to the individual vertices or the mesh chunks.
|
| Transform Space | Choose which transform space the deformer uses for deformation. Does not affect falloffs.
|
| Time Mode | How the deformer updates with relation to the timecode.
|
| Source Channel | Change how the colour ramp is applied to the parent mesh.
|
| Source Scale | Scale the size of the input colour ramp. |
| Source Offset | Offset the start of the colour ramp. |
| Modulation Function | How colour should be applied at the end of the ramp.
|
| Noise Scale | Scale the size of the generated fractal noise. Only functions with Fractal Noise set in the Source Channel. |
| Lacunarity | How large the gaps between larger areas of noise are. Only functions with Fractal Noise set in the Source Channel. |
| Gain | The overall smoothness of the generated fractal noise. Only functions with Fractal Noise set in the Source Channel. |
| Animation Rate | The speed at which the fractal noise is animated. Only functions with Fractal Noise set in the Source Channel. |
These properties control where the deformer affects the geometry.
| Parameter | Details |
|---|---|
| Use Falloff | Enable falloff from the position of the deformer. |
| Falloff Shape | Select which shape to use to draw falloff from.
|
| Falloff Range | Limits the range the deformer is effective at. |
| Falloff Inner Range | The inner range from which the falloff is calculated from. |
| Falloff Curve Power | How quickly the falloff drops to 0 at the outer falloff. |
| Invert Falloff | Invert the direction of the falloff. |
| Falloff Curve | Visualises the falloff curve, from being completely in effect to no longer effective. |
| Name | Description | Typical Input |
|---|---|---|
| Colour Ramp | Select a colour ramp to be the source for the colours. | Colour Ramp |
| Mask Image | Use an image to mask out areas for the deformer to not function. | Loader |
| Falloff Node | Use an input node to control the transformation values of the falloff. | Null |
| Generated Weightmap | Add a weightmap to vary the strength of the deformer across the surface. | Generate Weightmap |
| 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 |
