Notch Notch
Manual 1.0 Manual 0.9.23
 Light | Dark
Colour Ramp Effector

Colour Ramp Effector

Updated: 4 Dec 2023

Modifies a cloner system with colours from an input Colour Ramp.

Method #

This node primarily modifies the colour values of connected cloner systems based on an input Colour Ramp, but can also apply transformations to the clones too based on the area of effect of the colour ramp.

Connect the output to the effector input of any cloner node to apply it to the camera system. Multiple effectors connected to the same output will stack, and order of operations chosen by position on the nodegraph.

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.

ParameterDetails
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.

ParameterDetails
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.

ParameterDetails
Blend Amount Controls the amount the resulting transforms of each clone after the effector is applied is blended with the original transform.
Space The transform space the Effector uses to influence the clones.
  • Effector - World : Use the world space transforms of the effector to influence the clones.
  • Cloner : Use the transforms in local space to the cloner to influence the clones.
  • Object : Use the transforms in object space to influence the clones.
Colour Blend Mode How the colour blends with other colour data.
Colour Blend Amount How much the colour blends with the original clones colour.
Source Channel What property of the clones in relation to the effector should be used to dictate colour.
  • Position X : Clones are coloured based on their X position.
  • Position Y : Clones are coloured based on their Y position.
  • Position Z : Clones are coloured based on their Z position.
  • Distance : Clones are coloured based on their radial distance from the effector.
  • Fractal Noise : Clones will be coloured based on a simple fractal noise function.
  • Clone Index : Clones will be coloured based on their index.
  • Random Value : Clones are coloured completely randomly with the input colour ramp.
Source Scale Scale the size of the source Colour Ramp.
Source Offset Offset the values from the source Colour Ramp.
Modulate Function The method by which the colour ramp is sampled / repeated.
  • Clamp : The sample locations are clamped from 0 to 1.
  • Repeat : The sample locations are repeated.
  • Sine : The sample locations are modulated with a sine wave.
Interpolate Colours Allow the clones to interpolate the colours passed to them, smoothing the colour changes across the clones.
Noise Scale Scale the size of the generated fractal noise. Only functions with Fractal Noise selected in the Source Channel Attribute.
Lacunarity How large the gaps between larger areas of noise are. Only functions with Fractal Noise selected in the Source Channel Attribute.
Gain The overall smoothness of the generated fractal noise. Only functions with Fractal Noise selected in the Source Channel Attribute.
Animation Rate The speed at which the fractal noise is animated. Only functions with Fractal Noise selected in the Source Channel Attribute.
Update Time Mode Change how the clone animation uses time.
  • Locked To Timecode : The effect is synchronised with the timecode, so changes in time will always yield the same results.
  • Running / Loopable : The effect is generated on a separate time to the timecode, ignoring composition loops. Useful for Real-Time exports, where content needs to play indefinitely. Not suitable for looping videos.

These properties control where an effector can affect the clones.

ParameterDetails
Falloff Mode Change how the falloff from the original object is calculated.
  • Infinite : There is no falloff, all objects will be affected equally.
  • Linear : Falloff is based on distance from an infinite plane along a chose axis.
  • Sphere : Falloff is based on distance from the plain effectors origin.
  • Procedural : Uses a connected procedural system to describe the falloff area. A procedural node must be input for this property to function.
  • Box : Falloff is based on the distance around a box based at the effectors origin.
Linear Falloff Axis The falloff axis to use when the effector is in linear mode.
  • +X : The positive x axis.
  • -X : The negative x axis.
  • +Y : The positive y axis
  • -Y : The negative y axis.
  • +Z : The positive z axis.
  • -Z : The negative z axis.
Falloff The outer radius of the falloff, where the effector no longer effects the clones.
Inner Falloff The inner radius of the falloff, where the effector effects the clones strongest.
Falloff Power Change how quickly the nodes falloff from the effector
Falloff Size The X size of the falloff when in box mode.
Invert Falloff Invert the direction of the falloff.

These properties control the selection of clones that you want the effector to influence.

ParameterDetails
Selection Mode Set the mode for Index-Based Weighting.
  • Disabled : Effector influences all clones.
  • ID : Use clone IDs to define which clones the effector influences.
  • Index : Use clone indexes to define which clones the effector influences.
Selection Operation Set how you want top define the selection.
  • Index : Select a specific clone that will be influenced by the effector.
  • Range : Select a range of clones that will be influenced by the effector.
  • Step : Select every n clone to be influenced by the effector.
  • Random In Range : Clones will be selected randomly to be influenced within a set range.
Index The first clone index in the range.
Max Index The last clone index in the range.
Index Step The increment used in “Step” mode.
Index Seed The seed used in “Random In Range” mode.
Index Falloff Range Falloff amount for Index-Based Weighting.
Index Falloff Power The curve power of the falloff for Index-Based Weighting.

These properties control how an effector transforms the clones.

ParameterDetails
Position X Offset the clones x position from the current position.
Position Y Offset the clones y position from the current position.
Position Z Offset the clones z position from the current position.
Rotation Heading Offset the clones y rotation from the current rotation.
Rotation Pitch Offset the clones z rotation from the current rotation.
Rotation Bank Offset the clones x rotation from the current rotation.
Scale X Offset the clones x scale from the current scale.
Scale Y Offset the clones y scale from the current scale.
Scale Z Offset the clones z scale from the current scale.
Uniform Scale Uniformally scale the clones by the same value along all axes.
Object Index Offset the clone’s index from the current clone index. Used to select which child object of the cloner is cloned where.
Apply To Position Apply the position changes from the effector to the clones.
Apply To Rotation Apply the rotation changes from the effector to the clones.
Apply To Scale Apply the scale changes from the effector to the clones.
Apply To Object Index Apply the object index changes from the effector to the clones.
Position Apply Mode The method by which the effectors position properties are applied to the clone. Affecting the previously applied position values.
  • Add : The effector position is weighted by the falloff and added to the clone’s previous position.
  • Multiply : The effector position is weighted by the falloff and multiplied by the clone’s previous position.
  • Replace : The effector position is weighted by the falloff and replaces the clone’s previous position.
Rotation Apply Mode The method by which the effectors rotation properties are applied to the clone. Affecting the previously applied rotation values.
  • Add : The effector rotation is weighted by the falloff and added to the clone’s previous rotation.
  • Multiply : The effector rotation is weighted by the falloff and multiplied by the clone’s previous rotation.
  • Replace : The effector rotation is weighted by the falloff and replaces the clone’s previous rotation.
Scale Apply Mode The method by which the effectors scale properties are applied to the clone. Affecting the previously applied scale values.
  • Add : The effector scale is weighted by the falloff and added to the clone’s previous scale.
  • Multiply : The effector scale is weighted by the falloff and multiplied to the clone’s previous scale.
  • Replace : The effector scale is weighted by the falloff and replaces the clone’s previous scale.
Object Index Apply Mode The method by which the effectors object index properties are applied to the clone. Affecting the previously applied object index values.
  • Add : The effector object index value is weighted by the falloff and added to the clone’s previous object index value.
  • Multiply : The effector object index value is weighted by the falloff and multiplied by the clone’s previous object index value.
  • Replace : The effector object index value is weighted by the falloff and replaces the clone’s previous object index value.

Inputs

NameDescriptionTypical Input
Colour RampControls the colours and ranges of colours used to tint the clones.Colour Ramp
Procedural FalloffUse a procedural system to generate falloff from. Useful for creating complex and unconventional falloffs from an Effector.Procedural Root
Transform ModifiersApply the transforms of another node to this node.Null
Target NodeModifiy the rotations of the node to always direct the z axis towards the input.Null
Local Transform OverrideApply the transforms of another node to this node, relative to its parent.Null

Related Videos