> falloffs

Infection Falloff

falloffs/infection-falloff·v1.5.1

IN:2 OUT:1

SUMMARY

Infection Falloff is a simulation: after Initialize and Start, every frame each point catches the infection from its neighbors, found by Search Radius or by mesh connectivity (Infect By), at the Infection Rate and held back by Resistance. Dissipation Rate fades fully infected points, Enable Reinfection lets points that fall to the Threshold catch it again, and Play and Step control the timing.

Seeds come from a sphere (Position, Radius, Transition Range), from a point attribute with Use Seed Attribute, or from a Seed POP on Input 1 where each point is one seed and attributes named like the parameters (P, radius, transitionrange) override them per seed. Like every POPX falloff, it adds optional noise, Remap controls (clamp, fit, invert, ramp) and a Combine Operation with the falloff already on the points, and Preview Falloff colors the points by the result.

PARAMETERS

PAGEInfection

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.
[+]Infect By	Infectby	Determines which points count as neighbors: Radius uses Search Radius, Connectivity uses mesh edges.
[+]Distribution	Distribution	Determines how neighbors are selected: Default, Unique, Closest or Random.
Search Radius	Searchradius	Neighbor search radius in Radius mode.
Max Connections	Maxconnections	Maximum number of neighbor connections per point.
Infection Rate	Infectionrate	Sets the amount of infection each infecting neighbor adds per frame.
Distance Weighted Spread	Distweight	When on, the contribution of each neighbor is weighted by its distance times Weight Amount.
Weight Amount	Weightamount	Sets the multiplier on the neighbor distance for Distance Weighted Spread.
Dissipation Rate	Dissipationrate	Sets the share of the infection lost per frame once a point is fully infected.
Enable Reinfection	Enablereinfection	When on, points that fade to Threshold can be infected again. Requires a Dissipation Rate above 0.
Threshold	Threshold	Minimum infection value before a point can be reinfected.
Resistance	Resistance	Sets the minimum value a neighbor needs to infect, and the value seeds start at. Higher values hold the infection back.
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.

PAGESeed

Display Seed Selection	Displayseed	Display the seed region.
Threshold	Seedthreshold	Sets the minimum value for a point to become a seed.
Use Seed Attribute	Useseedattr	Enable seeding from a point attribute instead of the region.
Seed Attribute	Seedattr	Sets the attribute holding the seed values.
Seed POP	Seedpop	Reference to a POP of seed points, used when input 2 is empty.
[+]Position	Position	Center of the seed region. Per-seed attribute: P.
Radius	Radius	Size of the seed region. Can be overridden per seed with a radius point attribute.
Transition Range	Transitionrange	Width of the transition. Each seed can override it with a transitionrange attribute.
Transition Align	Transitionalign	Shifts the transition in or out. Per-seed attribute: transitionalign.
[+]Transition Type	Transitiontype	Determines a transition function for weights. Can be overridden per seed with a transitiontype point attribute.
Output Seed Attribute	Outputseedattr	Write the seed values to an attribute.

PAGEFalloff

[+]Combine Operation	Combineop	Specify how to combine this falloff with the existing falloff value.
Combine Falloff Attribute	Combattrscope	Sets the existing falloff attribute to combine with.
Swap Operation Order	Swaporder	Swaps the order of the operands. A operation B is changed to B operation A.
Combine Strength	Combstrength	Sets the blend of the combine operation, from 0 to 1.
Output Falloff Attribute	Outputfalloffattr	Name of the attribute the falloff is written to.
Preview Falloff	Previewfalloff	Enable coloring the points by the falloff.
[+]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.

PAGENoise

Apply Noise	Applynoise	Enable adding noise to the falloff.
[+]Combine Operation	Combineopnoise	Specify how to combine the noise with the falloff, either Add or Multiply.
[+]Type	Type	Determines the noise type.
Seed	Seed	Numerical value that initializes the randomization.
Period	Period	Period (scale) of the noise field.
Harmonics	Harmon	The number of higher frequency components to layer on top of the base frequency. 0 harmonics give the base shape.
Harmonic Spread	Spread	The factor by which the frequency of a harmonic increases relative to the previous harmonic.
Harmonic Gain	Gain	Amplitude of the Harmonics layered on top of the base frequency.
Amplitude	Amp	The noise values amplitude (a scale on the values output).
Exponent	Exp	Sets the exponent. The internal value is raised by the power of the exponent.
Offset	Offset	Adds an offset to the resulting value.
[+]Transform Order	Xordnoise	Sets the overall transform order for the transformations.
[+]Rotate Order	Rordnoise	Sets the order of the rotations within the overall transform order.
[+]Translate	Tnoise	Translate the points through the noise space.
[+]Rotate	Rnoise	Rotate the points around the corresponding X, Y and Z axes. Angles are given in degrees.
[+]Scale	Snoise	These three fields scale the Source geometry in the three axes.
[+]Pivot	Pnoise	The pivot point for the transform rotates and scales.
Translate 4D	T4dnoise	Translates the points through the 4th noise dimension.

PAGERemap

Enable Remap	Remap	Enable the remap controls.
Clamp	Clamp	Clamps the falloff values to the 0-1 range.
Fit	Fit	Enable fitting the values from the input range to the output range.
Auto Input Min Max	Auto	When on, the actual minimum and maximum values are used as the input range.
Input Min	Inputmin	Sets the minimum of the input range.
Input Max	Inputmax	Sets the maximum of the input range.
Output Min	Outputmin	Sets the minimum of the output range.
Output Max	Outputmax	Sets the maximum of the output range.
Invert	Invert	Invert the falloff, outputting 1 minus the value.
Enable Ramp Remap	Enablerampremap	Enable remapping the falloff through a ramp.
Open Ramp Editor	Openrampeditor	Opens the remap ramp editor.
Reset Ramp	Resetramp	Resets the remap ramp.
Custom Ramp TOP	Customramptop	Reference to a TOP used as the remap ramp, overriding the ramp editor.

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 - Seed

OUTPUTS

Output 0 POP - POPX/POP Geometry