Notch Notch Manual 0.9.23
 Light | Dark
Image Affector

Image Affector

Attract or repel particles from an image.



Method #

This node is used to attract or repel particles from pixels in an image. This is typically used to make particles form into a given image. The image can be set directly using the Image attribute or connected from a video node via the Video Nodes input.

The image is pre-processed to determine which pixels should be used to attract or repel from by thresholding either the alpha value or luminance value.

This node requires a video node to be connected via the video nodes input.

All nodes connected to this node are treated as if flowing to the parent node, and inherits any transformation changes along the chain.


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.

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.

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.

ImageOverride the input image with an image selected from the drop down menu.
Flip ImageHow much the particle colours adapt to the image colours.
Velocity ScaleScale the strength of the affectors velocity on the particles.
RadiusAlter the outer radius at which the affector is no longer effective.
Inner RadiusThe radius up until which the affector is fully effective.
ModeChoose how the image affector affects the particles.
  • Repel : Particles move away from the node.
  • Attract : Particles are moved toward the image affector, and generate an image by colliding with the image plane.
  • Collision : Particles collide with image pixels.
Image Search ModeChoose how the particles find a place in the image.
  • Pixels : The particles spread to the positions of individual pixels in the image.
  • Closest : All the particles move toward the closest pixel in the image.
Life Effect CoeffsHow much the particles are affected by the affector at different stages of the particles life cycle. Values 1 and 2 are control points used to control a bezier curve between values 0 and 3.
RandomnessHow much randomness is added in the particles movement.
Use ThicknessToggle whether to emit the particles on a 2d plane, or in three dimensions.
ThicknessChange the thickness of the three dimensional area the particles can spawn in. Only functions if ‘Use Thickness’ is on.
Pixel Cull/Thickness ModeChange how the depth of the particle generation is calculated and which pixels are used by the affector.
  • Alpha Channel : Higher alpha values will have greater depth.
  • Luminescence : Brighter parts of the image will have greater depth.
Alpha ThresholdManage the threshold on where the particles will emit based on the alpha or luminance.
Image Colour AdaptionHow much the particle colours adapt to the image colours.
Avi FPSChange the frames per second the video is played at.
Time OffsetOffset the time the effect is running.
Luminance Offset ScaleOffsets the points on the image in the depth axis by their luminance.

How the image colours should blend with the particle colours.

Blend ModeChoose how the particle colours blend to the source colours
Blend WeightControls how much the result of the affector is blended with results from preceding affectors.


NameDescriptionTypical Input
Video NodesThe image nodeERROR: Variable not found: {input-node-particles-transform-node-typical-input}
Affected EmittersChoose which particle emitters can be affected by the affector.Primitive Emitter
Procedural FalloffUse the distance field from a procedural system to vary how strong the affector is.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