> modifiers

Advect

modifiers/advect·v1.5.1

IN:2 OUT:1

SUMMARY

The Advect moves POPX or regular POP geometry along a drive vector read from a point attribute, from the same attribute on reference geometry in the second input (the closest point or a weighted average of neighbors), or from a 3D vector field sampled at each point. The vector acts as a velocity written to PartVel or as a force written to PartForce.

With Enable Time Integration the points move in a feedback loop (Initialize, then Start), with Drag, Velocity Damping and Time Scale shaping the motion and Rotate to Vector turning each instance along its path. With integration off, the operator only writes PartVel and PartForce for a downstream simulation, and Do Falloff weights the motion per point.

PARAMETERS

PAGEAdvect

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.
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.
[+]Advection Source	Advectsource	Selects the source of the driving vectors: a point attribute, the reference geometry in the second input, or a 3D vector field.
Vector Attribute	Vectorattr	Sets the vector attribute that drives the points, read from the input, or the second input for Reference and Field. Empty moves nothing.
[+]Vector Type	Vectortype	Determines what the vector drives. Velocity is written to PartVel in units per second, Force to PartForce, which accumulates into PartVel.
Max Search Distance	Maxdistance	Maximum distance to the reference points that are read.
[+]Lookup Mode	Lookupmode	Determines how reference points are read: the closest point, or the average or distance-weighted average of neighbors within Max Search Distance.
[+]Distribution	Distribution	Determines how neighbors are selected: Default, Unique, Closest or Random.
Max Points for Average	Maxptsavg	Maximum number of neighbors averaged per point in the Average modes.
Display Field Bounds	Displayfieldbounds	Draw the bounds of the field grid.
Enable Time Integration	Timeintegration	Determines whether points move each frame in a feedback loop (Initialize, then Start). When off, only PartVel and PartForce are written.
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.
Time Scale	Timescale	Speed multiplier on the time step. 0 freezes and 2 doubles.
Time Step	Timestep	The time step per frame in seconds, 1 divided by the cook rate (read-only). Time Scale multiplies it.
Drag	Drag	In Velocity mode, the fraction of the previous velocity kept per step; 0 follows the drive. In Force mode, friction per step; 1 stops.
Velocity Damping	Damping	Amount of damping applied to the velocity. 0 applies no damping.
Rotate to Vector (Forward Z)	Rotateto	Turn each point so its +Z axis follows its motion, with +Y up. Points that are still keep their rotation.
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 - Reference Geometry/Field

OUTPUTS

Output 0 POP - POPX/POP Geometry