Advect

Summary

The Advect operator moves instances along vector fields. It reads velocity or direction data from point attributes or reference geometry and applies continuous movement based on the sampled vectors.

The operator includes options for rotation alignment, allowing instances to automatically orient themselves in the direction of motion.

Parameters

Page: Advect

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.
Do Falloff Dofalloff – Enables falloff-based advection intensity control.
Falloff Attribute Falloffattr – Specifies which attribute to use for falloff values that attenuate advection strength.
Advect Source Advectsource – – Determines whether to read advection vectors from point attributes or reference geometry.
Point Attribute ptattr
Reference Geometry refgeo
Advect Attribute Advectattr – Name of the vector attribute to use for advection direction and speed.
Max Search Distance Maxdistance – Maximum distance to search for nearest neighbor points on reference geometry.
Lookup Mode Lookupmode – – Determines how advection vectors are sampled from reference geometry.
Closest Point closest
Average avg
Distribution Distribution – – Method for selecting neighbor points when using reference geometry.
Default default
Unique unique
Closest closest
Max Points for Average Maxptsavg – Maximum number of points to include when averaging vectors in Average lookup mode.
Time Step Timestep – Controls the integration step size for advection movement. Higher values result in faster movement.
Rotate to Vector (Forward Direction) Rotateto – Enables automatic rotation of instances to align with the advection vector direction.
Feedback POP Feedbackpop – Reference to the feedback POP that drives the advection simulation.
Passthrough Attributes Passthroughattrs – Attributes to pass through from the initial POP connected to the feedback POP.
Enable Life Enablelife – Enables lifespan-based particle death when using feedback loop advection.
Seed Lifeseed – Numerical value that initializes the randomization for life variance.
Life Span Lifespan – Base duration in seconds that particles exist before being removed.
Life Variance Lifevariance – Random variation added to the life span for each particle.

Page: Common

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.
SRT / RST Srtrst – Sets the transform order when using POPX Geometry as built-in TouchDesigner instances.

Inputs

Input 0 POP – POPX/POP Geometry
Input 1 POP – Reference Geometry

Outputs

Output 0 POP – POPX_out1