Image Effector
Modifies a cloner system using an input image or video.
Image Effector
Method #
This node changes the transformation and colour properties of a clone system based on an input image. Similar to the Clone to Image node, except this node can be applied to any cloner system and does not generate clones of its own.
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.
Parameter Details Position X Move along the local x-axis.
Position Y Move along the local y-axis.
Position Z Move along the local z-axis.
Rotation Heading Rotate around the local y-axis.
Rotation Pitch Rotate around the local x-axis.
Rotation Bank Rotate around the local z-axis.
Scale X Scale along the local x-axis.
Scale Y Scale along the local y-axis.
Scale Z 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 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.
Colour Blend Amount How much the clones colours are blended with the image’s colour.
Interpolate Colours Allow the clones to interpolate the colours passed to them, smoothing the colour changes across the clones.
These properties control where an effector can affect the clones.
Parameter Details 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 how an effector transforms the clones.
Parameter Details 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.
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.
Position Apply Mode The method by which the effectors position properties are applied to the clone.
- Add : The effector position is weighted by the falloff and added to the clone position.
- Multiply : The effector position is weighted by the falloff and mutliplied to the clones rotation.
- Replace : The effector position is weighted by the falloff and replaces the clones rotation.
Rotation Apply Mode The method by which the effectors rotation properties are applied to the clone.
- Add : The effector rotation is weighted by the falloff and added to the clone rotation.
- Multiply : The effector rotation is weighted by the falloff and mutliplied to the clones rotation.
- Replace : The effector rotation is weighted by the falloff and replaces the clones rotation.
Scale Apply Mode The method by which the effectors scale properties are applied to the clone.
- Add : The effector scale is weighted by the falloff and added to the clone scale.
- Multiply : The effector scale is weighted by the falloff and mutliplied to the clones rotation.
- Replace : The effector scale is weighted by the falloff and replaces the clones rotation.
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 | Move along the local x-axis. |
| Position Y | Move along the local y-axis. |
| Position Z | Move along the local z-axis. |
| Rotation Heading | Rotate around the local y-axis. |
| Rotation Pitch | Rotate around the local x-axis. |
| Rotation Bank | Rotate around the local z-axis. |
| Scale X | Scale along the local x-axis. |
| Scale Y | Scale along the local y-axis. |
| Scale Z | 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 | 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.
|
| Colour Blend Amount | How much the clones colours are blended with the image’s colour. |
| Interpolate Colours | Allow the clones to interpolate the colours passed to them, smoothing the colour changes across the clones. |
These properties control where an effector can affect the clones.
| Parameter | Details |
|---|---|
| Falloff Mode | Change how the falloff from the original object is calculated.
|
| Linear Falloff Axis | The falloff axis to use when the effector is in linear mode.
|
| 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 how an effector transforms the clones.
| Parameter | Details |
|---|---|
| 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. |
| 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. |
| Position Apply Mode | The method by which the effectors position properties are applied to the clone.
|
| Rotation Apply Mode | The method by which the effectors rotation properties are applied to the clone.
|
| Scale Apply Mode | The method by which the effectors scale properties are applied to the clone.
|
| Name | Description | Typical Input |
|---|---|---|
| Image Node | Use an input image or video to manipulate the clones. An video node must be connected for the effector to function. | Image Plane |
| Mapping | Changes How the image is mapped to the effected clones. | Mapping |
| Procedural Falloff | Use a procedural system to generate falloff from. Useful for creating complex and unconventional falloffs from an Effector. | Procedural Root |
| 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 |
