Notch Notch Manual 0.9.23
 Light | Dark
Clone To Image

Clone To Image

Generates Clones from an input image.

image

image

Method #

The Clone to Image node is used to clone 3D objects using pixels from an input image or video, where the colours are used to scale, offset or colour the clones.

The clones are first placed in a regular 2D grid, and automatically scaled so that a unit cube would fill one cell exactly. The cell locations are then used to sample pixels of the input image or video, where the brightness and colour values can then be used to modify the clones.

Nodes that are to be cloned should be connected to the output of this node. Any geometry node including 3D Objects, Shape 3Ds, and Image Planes may be connected, as well as other Cloner systems.

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 XMove along the local x-axis.
Position YMove along the local y-axis.
Position ZMove along the local z-axis.
Rotation HeadingRotate around the local y-axis.
Rotation PitchRotate around the local x-axis.
Rotation BankRotate around the local z-axis.
Scale XScale along the local x-axis.
Scale YScale along the local y-axis.
Scale ZScale along the local z-axis.

Toggle which transform channels should be inherited from the parent node. By default, all transforms will be inherited.

ParameterDetails
Position XToggle inheritance of the X Position from the parent.
Position YToggle inheritance of the Y Position from the parent.
Position ZToggle inheritance of the Z Position from the parent.
Rotation HeadingToggle inheritance of the Rotation Heading from the parent.
Rotation PitchToggle inheritance of the Rotation Pitch from the parent.
Rotation BankToggle inheritance of the Rotation Bank from the parent.
Scale XToggle inheritance of the X Scale from the parent.
Scale YToggle inheritance of the Y Scale from the parent.
Scale ZToggle inheritance of the Z Scale from the parent.
World Position OnlyInherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties.
Inherit TimeToggle inheritance of time from the parent.

These properties control the core behaviours of the node.

ParameterDetails
ImageSelect a source Image for the clones to be spawned from. Can be overwritten by adding an image input.
Node Spawn ModeChange the order in which the cloned objects are assigned to clone instances.
  • All : All of the connected objects are generate at every clone position.
  • Iterate : The objects are generated sequentially per clone position, based on their heriarchy. For example, the first clone renders the first object, the second clone renders the second object and so on.
  • Random : The objects are randomly selected to generate at clone positions.
Num Clones XNumber of clones created along the X axis.
Num Clones YNumber of clones created along the Y axis.
First Clone XOffset the first clone spawned along the X axis.
First Clone YOffset the first clone spawned along the Y axis.
Image Scale XScale the image along the X axis.
Image Scale YScale the image along the Y axis.
Scale Image By AspectScale the image based on its aspect ratio.
Scale Image By Pixel SizeScale the image based on the relative size of a pixel in the cloned image.
Brightness Channel ModeChange how the brightness threshold property is used to limit where the clones can be spawned.
  • Luminance : Use the luminance values of the image.
  • Alpha : Use the alpha values of the image.
  • Luminance * Alpha : Use the luminance values multiplied by the alpha values.
Brightness ThresholdControl which areas of the image will be used to spawn clones, based on the Brightness Channel Mode property.
Clone Scale BrightnessScale the individual clones based on the luminance of the image.
Clone Scale By Brightness Affects XToggle whether the clone scaling affects the X axis.
Clone Scale By Brightness Affects YToggle whether the clone scaling affects the Y axis.
Clone Scale By Brightness Affects ZToggle whether the clone scaling affects the Z axis.
Clone Offset By BrightnessOffset the individual clones based on the luminance of the image.
Clone ScaleScale the size of all the clones uniformally.
Filter ImageApplies a Bilinear filter to the image, smoothing out some of the values where the image is scaled.
Colour ClonesToggle whether the clones are coloured based on the image, or retain their material values.
Output ShapeSelect what kind of shape to create the clones in.
  • Plane : Generates clones on a flat square plane.
  • 360 Spherical : Generates clones on to a 360 degree sphere about its center.

These properties apply iterative offsets to the UV Offset, UV Scale, and Crop parameters of the materials for each rendered clone. Typically used with a tile sheet so that each clone picks up a different texture.

ParameterDetails
UV ModeChange how the cloned objects UV chanel and material inputs are affected by the cloner.
  • Linear (Using Clone Index) : Each clone keeps unique UV’s.
  • Use Texture Page (Using Clone Index) : Speads the UV’s over a number of clones defined by the Texture Num Frames Attribute, and repeats it along the clone index.
  • Use Texture Page (Using Random Index) : Randomises the UV’s over the range of clones in the Texture Num Frames Property, and repeats it.
  • Use Texture Page (Using Luminance) : Spits up the UVs, and uses different sections depending on the brightness of the Image driving the cloner.
  • Clone UV : Cumulatively changes the clone scale and position using the offset and scale delta properties.
Texture Num Frames XHow many columns to split the UV by.
Texture Num Frames YHow many rows to split the UV by.
UV Scale X DeltaRelative change to the uv scale along the x of the clone’s material, per clone.
UV Scale Y DeltaRelative change to the uv scale along the y of the clone’s material, per clone.
UV Offset X DeltaRelative change to the uv offset along the x axis of the clone’s material, per clone.
UV Offset Y DeltaRelative change to the uv offset along the y axis of the clone’s material, per clone.
Crop LeftRelative change to the crop on the left of the clone’s uvs, per clone.
Crop Right DeltaRelative change to the crop on the right of the clone’s uvs, per clone.
Crop Top DeltaRelative change to the crop on the top of the clone’s uvs, per clone.
Crop Bottom DeltaRelative change to the crop on the bottom of the clone’s uvs, per clone.

Inputs

NameDescriptionTypical Input
Image NodeSource image to generate clones from. A mesh must be connected for the cloner to generate clones.Video Loader
EffectorsControl how the clones behave once spawned. See Effectors.Plain Effector
Depth Image NodeOverwrite the image brightness with a different image to control Clone Offset By Brightness and Clone Scale Brightness.Video Loader
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