> modifiers

Spring Modifier

modifiers/spring-modifier·v1.5.1

IN:1 OUT:1

SUMMARY

The Spring Modifier makes instances follow their input like a damped spring, so animation upstream trails behind, overshoots and settles. Position, Rotation, Scale and one extra float attribute each have their own toggle, and the response is set by Mass, Spring Constant and Damping Coefficient.

It runs as a feedback loop: Initialize resets it to the input, Start runs it and Play pauses or resumes. A Mass Attribute can vary the response per instance, Do Falloff weights the spring force so instances outside the falloff stay put, and Preview Falloff colors the points by the Other attribute through a ramp.

PARAMETERS

PAGESpring

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.
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.
Position	Position	Enable applying the spring to the position.
Rotation	Rotation	Enable applying the spring to the rotation.
Scale	Scale	Enable applying the spring to the scale.
Other	Other	Enable applying the spring to a float attribute as well (Attribute).
Attribute (Float)	Attr	Float attribute the spring drives when Other is on.
Use Mass Attribute	Usemassattr	Use a mass attribute on each point instead of the Mass parameter.
Mass Attribute	Massattr	Sets the attribute holding the mass of each point.
Mass	Mass	The spring mass. Higher values respond slower.
Spring Constant	Springconst	Sets the spring stiffness, how strongly the points are pulled to the target.
Damping Coefficient	Dampingcoef	Sets how fast the motion dies out. Values closer to 1 oscillate less.
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.

PAGEFalloff

Preview Falloff	Previewfalloff	Enable coloring the points by the Other attribute.
[+]Falloff Ramp	Fallofframp	Selects the color ramp of the preview.
Open Custom Ramp Editor	Opencustomrampeditor	Open the editor of the custom preview ramp.
Reset Custom Ramp	Resetcustomramp	Resets the custom preview ramp.

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.

ATTRIBUTES

IORead

Pivot	point vec3	Instance pivot (passed through unchanged; used for the pivot-corrected translation).
Mass	point float	Per-instance mass used by the spring when Use Mass Attribute is on; higher mass = slower response.
popxFalloff	point float	Falloff attribute controlling where and how strongly the effect is applied (default popxFalloff; set by Falloff Attribute).

IOModified

P	point vec3	Instance position. Sprung toward the target position over time when Position is enabled.
Orient	point vec4	Instance orientation quaternion. Sprung toward the target orientation when Rotation is enabled.
Scale	point vec3	Instance scale. Sprung toward the target scale when Scale is enabled.
Other	point float	The custom float attribute (chosen by Attribute (Float)) sprung toward its target when Other is enabled.
PointScale	point float	Uniform per-instance scale; reset to 1 when scale is folded into the transform.
Transform	point mat3	Per-instance 3x3 transform, rebuilt from the sprung pose.

IOCreated

FullTransform

point mat4

Per-instance 4x4 transform with pivot-corrected translation; the matrix used for instancing.

INPUTS

Input 0 POP - POPX/POP Geometry

OUTPUTS

Output 0 POP - POPX/POP Geometry