> falloffs

Infection Falloff

falloffs/infection-falloff·v1.3.0
IN:2  OUT:1

The Infection Falloff creates dynamic, simulation-based falloff patterns by propagating values across geometry using infection-style spreading algorithms. Starting from seed points or regions, the infection spreads to neighboring points based on proximity or connectivity, creating organic growth patterns.

Supports both radius-based and connectivity-based infection methods, with control over infection rate, dissipation, resistance, and reinfection behavior. Distance-weighted spreading creates natural falloff gradients, while the simulation can be played, stepped, or controlled manually for precise timing.

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 Infection Falloff operator, and override the parameters for each seed. You need only to create a Point POP with attributes named as the Infection 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 Infection Falloff parameter names.

Optional transition ranges provide smooth seed boundaries, and the result can be combined with existing falloff attributes, previewed with color ramps, and optionally enhanced with procedural noise.

PAGEInfection
GroupGroupIf there are input groups, specifying a group name in this field will cause this POPX to act only upon the group specified.
Search RadiusSearchradiusMaximum distance for finding neighboring points to infect (radius mode only).
Max ConnectionsMaxconnectionsMaximum number of connections each point can have for infection spreading.
Infection RateInfectionrateSpeed at which infection values spread from infected to uninfected points.
Distance Weighted SpreadDistweightEnable distance-based falloff for infection spreading, creating smoother gradients.
Weight AmountWeightamountStrength of distance-based weighting (when Distance Weighted Spread is enabled).
Dissipation RateDissipationrateRate at which infection values decrease over time, creating decay effects.
Enable ReinfectionEnablereinfectionAllow previously infected points to be reinfected after dissipation (requires Dissipation Rate > 0).
PAGESeed
ThresholdThresholdMinimum infection value required before a point can be reinfected (requires reinfection enabled).
PAGEInfection
ResistanceResistanceResistance to infection spreading, slowing down the infection process.
InitializeInitializepulseReset the infection simulation to initial state.
StartStartpulseStart the infection simulation from current state.
PlayPlayContinuously run the infection simulation.
StepSteppulseAdvance the infection simulation by one step.
PAGESeed
Display Seed SelectionDisplayseedVisualize the seed selection region for infection starting points.
Enable Dynamic SeedDynamicseedAllow seed points to change dynamically during simulation.
ThresholdSeedthresholdMinimum value required for a point to become a seed.
PAGESeed
Use Seed AttributeUseseedattrUse an existing point attribute to define seed values instead of spatial selection.
Seed AttributeSeedattrName of the attribute to use for seed values (when Use Seed Attribute is enabled).
Seed POPSeedpopReference to a POP containing points to use as seeds when no second input is connected.
RadiusRadiusSize of the seed selection region. Can be overridden per-seed using a radius point attribute.
Transition RangeTransitionrangeDetermines a transition range for seed fields. Can be overridden per-seed using a transitionrange point attribute.
Transition AlignTransitionalignDetermines a transition offset for seed fields. Can be overridden per-seed using a transitionalign point attribute.
Output Seed AttributeOutputseedattrWrite the seed selection values to an output attribute.
PAGENoise
PAGEFalloff
Combine Falloff AttributeCombattrscopeSpecifies which falloff attribute to combine with when Combine Operation is not set to Set.
Swap Operation OrderSwaporderReverses the order of operands in the combine operation (A op B becomes B op A).
Combine StrengthCombstrengthBlending factor for the combine operation, ranging from 0 (no effect) to 1 (full effect).
Output Falloff AttributeOutputfalloffattrName of the attribute where the final falloff values will be stored.
Preview FalloffPreviewfalloffWhen enabled, visualizes falloff values using a color ramp.
Open Custom Ramp EditorOpencustumrampeditorOpens the custom color ramp editor for defining a custom falloff visualization gradient.
Reset Custom RampResetcustomrampResets the custom color ramp to its default state.
PAGENoise
Apply NoiseApplynoiseWhen enabled, adds procedural noise to the falloff values for organic variation.
PAGENoise
SeedSeedNumerical value that initializes the randomization.
PeriodPeriodPeriod (scale) of the noise field.
HarmonicsHarmonThe number of higher frequency components to layer on top of the base frequency. 0 harmonics give the base shape.
Harmonic SpreadSpreadThe factor by which the frequency of a harmonic increases relative to the previous harmonic.
Harmonic GainGainAmplitude of the Harmonics layered on top of the base frequency.
AmplitudeAmpThe noise values amplitude (a scale on the values output).
ExponentExpSets the exponent. The internal value is raised by the power of the exponent.
OffsetOffsetAdds an offset to the resulting value.
TranslateTnoiseTranslate the points through the noise space.
RotateRnoiseRotate the points around the corresponding X, Y and Z axes. Angles are given in degrees.
ScaleSnoiseThese three fields scale the Source geometry in the three axes.
PivotPnoiseThe pivot point for the transform rotates and scales.
Translate 4DT4dnoiseTranslates the points through the 4th noise dimension.
PAGERemap
Enable RemapRemapEnables remapping controls for adjusting falloff value range and distribution.
ClampClampWhen enabled, constrains falloff values to the 0-1 range.
FitFitEnables remapping of falloff values from an input range to an output range.
Auto Input Min MaxAutoAutomatically determines input range from actual min/max falloff values.
Input MinInputminMinimum value of the input range for remapping.
Input MaxInputmaxMaximum value of the input range for remapping.
Output MinOutputminMinimum value of the output range for remapping.
Output MaxOutputmaxMaximum value of the output range for remapping.
InvertInvertReverses the falloff values (1 - value).
Enable Ramp RemapEnablerampremapApplies a custom curve defined by a ramp to remap the falloff values.
Open Ramp EditorOpenrampeditorOpens the ramp editor for defining the custom remapping curve.
Reset RampResetrampResets the remap ramp editor.
Custom Ramp TOPCustomramptopReference to an external TOP for remap control. When specified, overrides the internal ramp editor.
PAGECommon
BypassBypassPass through the first input to the output unchanged.
Free Extra GPU MemoryFreeextragpumemFree memory that has accumulated when output memory has grown and shrunk.
Render PrimitivesRenderprimitivesToggles rendering of POPX Geometry or shows it as point instances only.
Convert to Point PrimitivesConverttoptprimConverts points to primitive points when Render Primitives is toggled off.
SRT / RSTSrtrstSets the transform order when using POPX Geometry as built-in TouchDesigner instances.
Input 0 POP POPX/POP Geometry
Input 1 POP Seed
Output 0 POP POPX_out1