Spread Falloff
v1.3.0Falloffs
Summary
The Spread Falloff creates falloff patterns that propagate outward from seed points through neighboring point connections, creating organic wave-like patterns that respect the structure of your mesh.
This operator is very similar to the Infection Falloff, but unlike Infection, it is not a simulation. The spread behavior is directly controlled by the Spread parameter. You can choose between radius or connectivity methods like the Infection Falloff.
Multiple Seed Fields: Seeds can be specified via the Seed POP parameter or Input 1, where each point defines a separate seed field - one point per seed. The attributes of the seed POP are named the same as parameter tokens in the Spread Falloff operator, and override the parameters for each seed. You need only to create a Point POP with attributes named as the Spread Falloff parameters, and then add a point per seed, and set their values. (An attribute P will override the Position parameter, and an attribute radius will override the Radius parameter.) Alternately you can generate points procedurally with attributes that match the Spread Falloff parameter names.
Parameters
Group
GroupIf there are input groups, specifying a group name in this field will cause this POPX to act only upon the group specified.
Spread By
SpreadbyDetermines how the operator identifies neighboring points for spread propagation.
Radius
radiusConnectivityconnectivityDistribution
DistributionControls how neighboring points are selected when using radius-based search.
Default
defaultUniqueuniqueClosestclosestSearch Radius
SearchradiusThe maximum distance within which points are considered neighbors for spread propagation.
Max Connections
MaxconnectionsLimits the maximum number of neighboring connections each point can have.
Falloff Width
FalloffwidthControls how quickly the falloff strength diminishes as it spreads from the seed points.
Spread
SpreadamountAdds randomization to the spread pattern, creating more organic and varied falloff.
Display Seed Selection
DisplayseedVisualize the seed selection region for infection starting points.
Threshold
SeedthresholdMinimum value required for a point to become a seed.
Use Seed Attribute
UseseedattrUse an existing point attribute to define seed values instead of spatial selection.
Seed Attribute
SeedattrName of the attribute to use for seed values (when Use Seed Attribute is enabled).
Seed POP
SeedpopReference to a POP containing points to use as seeds when no second input is connected.
Position
PositionCenter position of the seed selection region. Can be overridden per-seed using a P point attribute.
Position
PositionxPositionPositionyPositionPositionzRadius
RadiusSize of the seed selection region. Can be overridden per-seed using a radius point attribute.
Transition Range
TransitionrangeDetermines a transition range for seed fields. Can be overridden per-seed using a transitionrange point attribute.
Transition Align
TransitionalignDetermines a transition offset for seed fields. Can be overridden per-seed using a transitionalign point attribute.
Transition Type
TransitiontypeDetermines a transition function for seed fields. Can be overridden per-seed using a transitiontype point attribute.
Linear
linearSmooth StepsmoothstepEase In Ease OuteaseinoutOutput Seed Attribute
OutputseedattrWrite the seed selection values to an output attribute.
Combine Operation
CombineopMathematical operation used to combine this falloff with existing falloff values.
Add
addSubstractsubMultiplymultDividedivScreenscreenOverlayoverlayMaximummaxMinimumminSetsetCombine Falloff Attribute
CombattrscopeSpecifies which falloff attribute to combine with when Combine Operation is not set to Set.
Swap Operation Order
SwaporderReverses the order of operands in the combine operation (A op B becomes B op A).
Combine Strength
CombstrengthBlending factor for the combine operation, ranging from 0 (no effect) to 1 (full effect).
Output Falloff Attribute
OutputfalloffattrName of the attribute where the final falloff values will be stored.
Preview Falloff
PreviewfalloffWhen enabled, visualizes falloff values using a color ramp.
Falloff Ramp
FallofframpColor ramp preset used for visualizing falloff values when Preview Falloff is enabled.
Heatmap
heatmapBlackbodyblackbodyInfraredinfraredCustomcustomOpen Custom Ramp Editor
OpencustumrampeditorOpens the custom color ramp editor for defining a custom falloff visualization gradient.
Reset Custom Ramp
ResetcustomrampResets the custom color ramp to its default state.
Apply Noise
ApplynoiseWhen enabled, adds procedural noise to the falloff values for organic variation.
Combine Operation
CombineopnoiseHow noise values are combined with the base falloff (Add or Multiply).
Add
addMultiplymultType
TypeNoise algorithm type (Perlin, Simplex, etc.).
Perlin 2D (GPU)
perlin2dPerlin 3D (GPU)perlin3dPerlin 4D (GPU)perlin4dSimplex 2D (GPU)simplex2dSimplex 3D (GPU)simplex3dSimplex 4D (GPU)simplex4dSeed
SeedNumerical value that initializes the randomization.
Period
PeriodPeriod (scale) of the noise field.
Harmonics
HarmonThe number of higher frequency components to layer on top of the base frequency. 0 harmonics give the base shape.
Harmonic Spread
SpreadThe factor by which the frequency of a harmonic increases relative to the previous harmonic.
Harmonic Gain
GainAmplitude of the Harmonics layered on top of the base frequency.
Amplitude
AmpThe noise values amplitude (a scale on the values output).
Exponent
ExpSets the exponent. The internal value is raised by the power of the exponent.
Offset
OffsetAdds an offset to the resulting value.
Transform Order
XordnoiseSets the overall transform order for the transformations.
Scale Rotate Translate
srtScale Translate RotatestrRotate Scale TranslaterstRotate Translate ScalertsTranslate Scale RotatetsrTranslate Rotate ScaletrsRotate Order
RordnoiseSets the order of the rotations within the overall transform order.
Rx Ry Rz
xyzRx Rz RyxzyRy Rx RzyxzRy Rz RxyzxRz Rx RyzxyRz Ry RxzyxTranslate
TnoiseTranslate the points through the noise space.
Rotate
RnoiseRotate the points around the corresponding X, Y and Z axes. Angles are given in degrees.
Scale
SnoiseThese three fields scale the Source geometry in the three axes.
Pivot
PnoiseThe pivot point for the transform rotates and scales.
Translate 4D
T4dnoiseTranslates the points through the 4th noise dimension.
Enable Remap
RemapEnables remapping controls for adjusting falloff value range and distribution.
Clamp
ClampWhen enabled, constrains falloff values to the 0-1 range.
Fit
FitEnables remapping of falloff values from an input range to an output range.
Auto Input Min Max
AutoAutomatically determines input range from actual min/max falloff values.
Input Min
InputminMinimum value of the input range for remapping.
Input Max
InputmaxMaximum value of the input range for remapping.
Output Min
OutputminMinimum value of the output range for remapping.
Output Max
OutputmaxMaximum value of the output range for remapping.
Invert
InvertReverses the falloff values (1 - value).
Enable Ramp Remap
EnablerampremapApplies a custom curve defined by a ramp to remap the falloff values.
Open Ramp Editor
OpenrampeditorOpens the ramp editor for defining the custom remapping curve.
Reset Ramp
ResetrampResets the remap ramp editor.
Custom Ramp TOP
CustomramptopReference to an external TOP for remap control. When specified, overrides the internal ramp editor.
Bypass
BypassPass through the first input to the output unchanged.
Free Extra GPU Memory
FreeextragpumemFree memory that has accumulated when output memory has grown and shrunk.
Render Primitives
RenderprimitivesToggles rendering of POPX Geometry or shows it as point instances only.
Convert to Point Primitives
ConverttoptprimConverts points to primitive points when Render Primitives is toggled off.
SRT / RST
SrtrstSets the transform order when using POPX Geometry as built-in TouchDesigner instances.
Inputs
Input 0
POPPOPX/POP Geometry
Input 1
POPSeed
Outputs
Output 0
POPPOPX_out1