> modifiers

Relax

modifiers/relax·v1.5.1

IN:1 OUT:1

SUMMARY

The Relax pushes overlapping instances apart, giving each a radius from its Scale and PointScale or a fixed Point Radius Scale, and moving it away from up to Max Neighbors within Max Relax Radius. In Simple mode it relaxes once per frame from the input, while Advect (Initialize, then Start) keeps pushing frame after frame until the points settle.

Attract Position and Attract Strength pull the points toward a place, and a collider keeps them outside or inside a shape or projects them onto its surface: a POP mesh (ray traced, Windows only) or a field carrying a signed distance attribute. Do Falloff blends each point between its input and relaxed position, and the push can be output as a force attribute.

PARAMETERS

PAGERelax

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.
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.
Affect Position	Affectposition	Apply the effect to the position.
Relax Iterations	Relaxiters	Number of relax passes per frame.
Override Point Radius	Overrideradius	When on, every point uses Point Radius Scale as its radius. When off, the radius is the scale times the largest Scale axis times PointScale.
Point Radius Scale	Radiusscale	The point radius when Override Point Radius is on. When off, the multiplier on Scale or PointScale.
Display Point Radius	Displayradius	Display the point radius as circles in the viewport.
Max Relax Radius	Maxrelaxradius	Sets the distance within which the points push each other apart.
Max Neighbors	Maxneighbors	Number of closest neighbors, up to 32, that push each point.
Relax Strength	Relaxstrength	Sets the share of the overlap resolved per pass in Simple mode, or per second in Advect mode.
[+]Attract Position	Attractposition	The position the points are pulled toward.
Attract Strength	Attractstrength	Sets the strength of the pull toward Attract Position.
Output Force Attribute	Outputforceattr	Enable outputting the relax force as a point attribute.
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.
Step	Steppulse	Advance the simulation by one frame while paused.

PAGECollisions

[+]Collision Type	Collisiontype	Selects the collider: none, a POP mesh (ray traced, Windows only) or a field used as an SDF volume.
Collision POP	Collisionpop	The collider, either a mesh POP or an SDF field volume.
[+]Dist Attribute (SDF)	Distattr	For a field collider, the signed distance attribute of the Collision POP, negative inside.
Solid	Solid	When on, points inside the collider are pushed out. When off, the collider is hollow.
Keep Inside	Keepinside	When on, the collider is hollow and every outside point is pulled back in. When off, only escaping points are caught.
Project	Project	Place every point on the collider surface instead of colliding.
Collision Offset	Collisionoffset	Distance the points keep from the collider surface.
Collision Damping	Collisiondamping	Velocity lost on contact. 0 bounces and 1 stops.
[+]Transform Order	Xord	Sets the transform order of the collider.
[+]Rotate Order	Rord	Sets the order of the rotations of the collider.
[+]Translate	T	Translate the collider in the three axes.
[+]Rotate	R	Rotate the collider around the X, Y and Z axes. Angles are given in degrees.
[+]Scale	S	Scale factor for each axis of the collider.
[+]Pivot	P	The pivot point for the rotate and scale of the collider.
Uniform Scale	Scale	Specifies a uniform scale factor for the collider.
Display Geometry	Displaygeo	Enable drawing the collider, as the mesh or the field's zero surface.
[+]Display Color	Displaycolor	Sets the color of the displayed guides.

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

OUTPUTS

Output 0 POP - POPX/POP Geometry