> modifiers

Magnetize

modifiers/magnetize·v1.5.1

IN:2 OUT:1

SUMMARY

The Magnetize pushes, pulls or spins instances around magnets: the points of the POP on the second input or the Magnets POP, or a single magnet at the Position parameter. Each magnet acts within its Effect Radius with a Force Strength and Exponent, and point attributes on the magnets named like the parameters (radius, mode, strength, spindir, exponent, contain) let every magnet differ.

Solver Mode Simple offsets each instance from its input every frame, while Advect runs a feedback loop (Initialize, then Start) where instances keep moving, Containment eases them back inside a magnet's radius, and they relax back to their input when no magnet acts. Affect Rotation turns instances along their motion by Aim Weight, Do Falloff scales the force per instance, and the force and weight can be output as attributes.

PARAMETERS

PAGEMagnetize

Group	Group	If there are input groups, specifying a group name in this field will cause this POP to act only upon the group specified.
[+]Solver Mode	Solvermode	Simple is stateless and recomputed from the input each frame. Advect runs a feedback loop, started with Initialize then Start.
Target Feedback Loop POP	Targetpop	A reference to a POP node downstream in the network whose data is retrieved one frame later. Only P is read back.
Magnets POP	Magnetspop	Reference to a POP whose points are the magnets when the second input is empty. Per-magnet attributes: radius, mode, strength, spindir, exponent, contain.
Display Magnets	Displaymagnets	Display the magnets as wire spheres of their radius.
Do Falloff	Dofalloff	Weight the effect on each point by the Falloff Attribute.
Falloff Attribute	Falloffattr	The point attribute, 0 to 1, that weights the effect.
Search Radius	Searchradius	Sets the search radius for magnets.
Max Magnets per Point	Maxmagnets	Maximum number of magnets, the closest within Search Radius, whose forces each point sums. 0 uses all magnets.
Relaxation Factor	Relaxfactor	In Advect mode, how fast a point returns to the input, and its aim fades, once no magnet acts on it.
[+]Force Mode	Mode	Determines what the magnets do: Repulse, Attract or Spin. A per-magnet mode attribute (0, 1, 2) overrides it.
[+]Position	Position	Position of the single magnet, used when there is no Magnets POP or second input.
Effect Radius	Radius	Reach of a magnet, where the force fades to 0. Can be set per magnet with a radius point attribute.
Force Strength	Strength	Force of the magnets. Per-magnet attribute: strength.
Exponent	Exponent	Sets the exponent of the force falloff over the radius. Each magnet can set its own exponent.
[+]Spin Direction	Spindir	The axis the points turn around in Spin mode. A per-magnet spindir attribute overrides it.
Containment	Contain	In Advect mode, how strongly points outside the magnet radius are eased back in. 0 leaves them free. Per-magnet attribute: contain.
Affect Position	Affectpos	Whether the magnet forces move the points.
Move Weight	Moveweight	Scales the movement caused by the forces.
Affect Rotation	Affectrot	Whether to turn each point so its +Z axis follows its motion.
Aim Weight	Aimweight	Sets the fraction of the turn that is applied, from 0 to 1.
Output Force Attribute	Outputforceattr	Enable keeping the summed Force attribute on the output.
Output Weight Attribute	Outputweightattr	Enable keeping the Weight attribute, the summed magnet influence, on the output. 0 means no influence.
Initialize	Initializepulse	Initializes the POP from its input and parameters.
Start	Startpulse	Start the simulation from the initialized state.
Play	Play	Pause or play the feedback loop.

PAGECommon

Bypass	Bypass	Pass through the first input to the output unchanged.
Free Extra GPU Memory	Freeextragpumem	Free memory that has accumulated when output memory has grown and shrunk.
Render Primitives	Renderprimitives	Whether to render the full POPX geometry. When off, only point instances are drawn.
Convert to Point Primitives	Converttoptprim	Enable converting points to point primitives when Render Primitives is off.
SRT / RST	Srtrst	Sets the transform order, SRT or RST, used when the points are rendered as TouchDesigner instances.

INPUTS

Input 0 POP - POPX/POP Geometry

Input 1 POP - Magnets

OUTPUTS

Output 0 POP - POPX/POP Geometry