> modifiers

Relax

modifiers/relax·v1.3.0

IN:1 OUT:1

SUMMARY

The Relax applies a relaxation algorithm to spread instances apart and prevent overlaps. It uses iterative solving to push overlapping instances away from each other, creating more evenly distributed spacing.

Optionally provide constraint geometry (surface) or a constraint volume (3D texture) to keep instances from flying off into space. Supports two solver modes: Simple for immediate single-frame relaxation, and Advect for progressive time-dependent solving.

Supports two methods: Neighbor (searches for nearby instances within a radius) and Field (uses a voxel-based field approach). Considers the PointScale attribute of each instance as its radius for overlap detection. If there is no PointScale attribute, the radius defaults to half of the search radius. Optional falloff-based modulation enables spatially varying relaxation effects.

PARAMETERS

PAGERelax

Group	Group	If there are input groups, specifying a group name in this field will cause this POPX to act only upon the group specified.
[+]Solver Mode	Solvermode	Switches between Simple and Advect modes.
[+]Relax Method	Relaxmethod	Determines the relaxation algorithm: Neighbor (proximity-based search) or Field (voxel-based volume approach).
Target Points Update POP	Pointsupdatepop	Reference to a POP node downstream in the network when Solver Mode is set to Advect. This reference will cause a feedback loop and re-injects the points next frame.
Do Falloff	Dofalloff	Enables falloff-based modulation of the relaxation effect.
Falloff Attribute	Falloffattr	Specifies which attribute to use for falloff values that modulate the relaxation strength.
Affect Position	Affectposition	Enables relaxation forces to affect instance positions.
Relax Iterations	Relaxiters	Number of relaxation passes to perform per frame. Higher values produce more thorough relaxation but increase computation time.
Override Point Radius	Overrideradius	Overrides the point radius used for overlap detection with a uniform value.
[+]Point Radius Axis	Radiusaxis	Selects which axis of the PointScale attribute to use as the point radius.
Point Radius Scale	Radiusscale	Scale factor applied to the point radius for overlap detection.
Display Point Radius	Displayradius	Displays the point radius as circles in the viewport.
Max Relax Radius	Maxrelaxradius	Maximum search distance for finding neighboring instances. Instances beyond this radius will not affect each other.
Distribution	Distribution	Determines the distribution method for neighbor point selection.
Num Hash Buckets	Numhashbuckets	Number of hash buckets used for spatial hashing in neighbor search.
Max Neighbors	Maxneighbors	Maximum number of neighboring instances to consider when using Neighbor method.
Max Axis Resolution	Maxaxisres	Maximum voxel resolution along the longest axis when using Field method.
Kernel Size	Kernelsize	Size of the convolution kernel used for field-based relaxation.

PAGECollisions

[+]Lower Bounds	Fieldlowerbounds	Lower bounds of the field volume when using Field method.
[+]Upper Bounds	Fieldupperbounds	Upper bounds of the field volume when using Field method.

PAGERelax

Relax Strength	Relaxstrength	Overall intensity of the relaxation effect. Higher values push instances apart more aggressively.
[+]Attract Position	Attractposition	Position in 3D space that instances are attracted toward.
Attract Strength	Attractstrength	Strength of the attraction force toward the Attract Position.
Output Force Attribute	Outputforceattribute	Outputs the relaxation force vector as a point attribute.
Initialize	Initializepulse	Resets the Advect solver to initial state.
Start	Startpulse	Begins Advect solver simulation from the current state.
Play	Play	Toggles playback of the Advect solver simulation.
Step	Steppulse	Advances the Advect solver by one frame.

PAGECollisions

[+]Collision Type	Collisiontype	Selects the collision geometry type for constraining instance movement.
Collision Damping	Collisiondamping	Amount of velocity dampening applied when instances collide with the collision geometry.
Solid	Solid	Treats the collision geometry as a solid volume, preventing instances from passing through.
Project	Project	Projects instances onto the surface of the collision geometry.
Collision POP	Collisionpop	Reference to a POP containing the collision geometry when using POP collision type.
Collision Offset	Collisionoffset	Offset distance from the collision surface to prevent z-fighting artifacts.
[+]Size	Size	Size of the box collision geometry.
[+]Radius	Radius	Radius of the collision geometry per axis.
Corner Radius	Cornerradius	Radius of rounded corners on the box collision geometry.
Collison TOP	Collisontop	Reference to a TOP texture used as the collision field for SDF and texture collision types.
Use Custom Bounds	Usecustombounds	Enables custom bounding box for the collision texture instead of using the texture's native bounds.

[+]Lower Bounds	Lowerbounds	Lower bounds of the collision volume in world space.
[+]Upper Bounds	Upperbounds	Upper bounds of the collision volume in world space.

PAGECollisions

[+]Transform Order	Xord	Sets the order of scale, rotate, and translate operations for the collision geometry transform.
[+]Rotate Order	Rord	Sets the order of rotation operations for the collision geometry transform.
[+]Translate	T	Translation of the collision geometry in world space.
[+]Rotate	R	Rotation of the collision geometry in degrees.
[+]Scale	S	Scale of the collision geometry per axis.
[+]Pivot	P	Pivot point for the collision geometry transform.
Uniform Scale	Scale	Uniform scale factor applied to the collision geometry.
Display Geometry	Displaygeo	Shows the collision geometry in the viewport for visualization.
[+]Display Color	Displaycolor	Display color for the collision geometry visualization.

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	Toggles rendering of POPX Geometry or shows it as point instances only.
Convert to Point Primitives	Converttoptprim	Converts points to primitive points when Render Primitives is toggled off.
SRT / RST	Srtrst	Sets the transform order when using POPX Geometry as built-in TouchDesigner instances.

INPUTS

Input 0 POP – POPX/POP Geometry

OUTPUTS

Output 0 POP – POPX_out1