Shape Falloff

Summary

The Shape Falloff generates a Falloff Attribute based on signed distance fields (SDFs) computed from various geometric primitives. Internally, it uses the Field POP to calculate distance-based influence regions with smooth gradients and precise transitions.

It provides accurate control over falloff distribution using mathematical shape definitions such as spheres, boxes, cylinders, and planes, with adjustable parameters for size, radius, height, and roundness.

This approach ensures continuous, easily controllable falloff values that can be refined through transition ranges and remapping options.

Parameters

Page: Shape

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.
Specification POP Specpop – Reference POP operator to use for falloff specification and spatial transformation.
Shape Type Shapetype – – Selects the geometric primitive used to generate the signed distance field.
Sphere sphere
Box box
Torus torus
Cylinder Infinite cylinderinfinite
Cylinder Capped cylindercapped
Cylinder Rounded cylinderrounded
Capsule capsule
X-Plane xplane
Y-Plane yplane
Z-Plane zplane
Parabola parabola
Line Projection lineprojection
Display Shape Displayshape – When enabled, renders a visual representation of the shape in the viewport for reference.
Shape Color Shapecolor – – Color used to display the shape when Display Shape is enabled.
Shape Color Shapecolorr
Shape Color Shapecolorg
Shape Color Shapecolorb
Size Size – – Dimensions of the box shape (available when Shape Type is set to Box).
Size Sizex
Size Sizey
Size Sizez
Radius Rad – – Radius parameters for the selected shape type.
Radius Radx
Radius Rady
Radius Radz
Height Height – Height parameter for Cylinder Rounded shape type.
Roundness Roundness – Controls edge rounding for Box and Cylinder Rounded shape types.
Point A Pointa – – First endpoint for Cylinder Capped, Capsule, and Line Projection shapes.
Point A Pointax
Point A Pointay
Point A Pointaz
Point B Pointb – – Second endpoint for Cylinder Capped, Capsule, and Line Projection shapes.
Point B Pointbx
Point B Pointby
Point B Pointbz
Exponent Exponent – Exponential power for the Parabola shape type, controlling the curvature steepness.
Strength Strength – – Strength parameters for the Parabola shape type.
Strength Strengthx
Strength Strengthy
Transition Range Transitionrange – Defines the distance over which the falloff transitions from full strength to zero, creating smooth gradients.
Transition Align Transitionalign – Controls the alignment of the transition range relative to the shape boundary (inward, centered, or outward).
Transition Type Transitiontype – – Interpolation curve used for the transition range (Linear, Smooth, Ease In, Ease Out, etc.).
Linear linear
Smooth Step smoothstep
Ease In Ease Out easeinout

Page: Transform

Transform Order Xord – – Order in which Scale, Rotate, and Translate operations are applied to the shape.
Scale Rotate Translate srt
Scale Translate Rotate str
Rotate Scale Translate rst
Rotate Translate Scale rts
Translate Scale Rotate tsr
Translate Rotate Scale trs
Rotate Order Rord – – Order in which rotations around the X, Y, and Z axes are applied.
Rx Ry Rz xyz
Rx Rz Ry xzy
Ry Rx Rz yxz
Ry Rz Rx yzx
Rz Rx Ry zxy
Rz Ry Rx zyx
Translate T – – Translation offset applied to the shape in world space.
Translate Tx
Translate Ty
Translate Tz
Rotate R – – Rotation angles in degrees around the X, Y, and Z axes.
Rotate Rx
Rotate Ry
Rotate Rz
Scale S – – Scale factors applied to the shape along each axis.
Scale Sx
Scale Sy
Scale Sz
Pivot P – – Pivot point around which rotations and scaling are performed.
Pivot Px
Pivot Py
Pivot Pz

Page: Falloff

Combine Operation Combineop – – Mathematical operation used to combine this falloff with existing falloff values.
Add add
Substract sub
Multiply mult
Divide div
Screen screen
Overlay overlay
Maximum max
Minimum min
Set set
Combine Falloff Attribute Combineattributescope – Specifies which falloff attribute to combine with when Combine Operation is not set to Set.
Swap Operation Order Swaporder – Reverses the order of operands in the combine operation (A op B becomes B op A).
Combine Strength Combinestrength – Blending factor for the combine operation, ranging from 0 (no effect) to 1 (full effect).
Output Falloff Attribute Outputfalloffattribute – Name of the attribute where the final falloff values will be stored.
Preview Falloff Previewfalloff – When enabled, visualizes falloff values using a color ramp.
Falloff Ramp Fallofframp – – Color ramp preset used for visualizing falloff values when Preview Falloff is enabled.
Heatmap heatmap
Blackbody blackbody
Infrared infrared
Custom custom
Open Custom Ramp Opencustumramp – Opens the custom color ramp editor for defining a custom falloff visualization gradient.
Reset Custom Ramp Resetcustomramp – Resets the custom color ramp to its default state.

Page: Noise

Apply Noise Applynoise – When enabled, adds procedural noise to the falloff values for organic variation.
Combine Operation Combineopnoise – – How noise values are combined with the base falloff (Add or Multiply).
Add add
Multiply mult
Type Type – – Noise algorithm type (Perlin, Simplex, etc.).
Perlin 2D (GPU) perlin2d
Perlin 3D (GPU) perlin3d
Perlin 4D (GPU) perlin4d
Simplex 2D (GPU) simplex2d
Simplex 3D (GPU) simplex3d
Simplex 4D (GPU) simplex4d
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.
Scale Rotate Translate srt
Scale Translate Rotate str
Rotate Scale Translate rst
Rotate Translate Scale rts
Translate Scale Rotate tsr
Translate Rotate Scale trs
Rotate Order Rordnoise – – Sets the order of the rotations within the overall transform order.
Rx Ry Rz xyz
Rx Rz Ry xzy
Ry Rx Rz yxz
Ry Rz Rx yzx
Rz Rx Ry zxy
Rz Ry Rx zyx
Translate Tnoise – – Translate the points through the noise space.
Translate Tnoisex
Translate Tnoisey
Translate Tnoisez
Rotate Rnoise – – Rotate the points around the corresponding X, Y and Z axes. Angles are given in degrees.
Rotate Rnoisex
Rotate Rnoisey
Rotate Rnoisez
Scale Snoise – – These three fields scale the Source geometry in the three axes.
Scale Snoisex
Scale Snoisey
Scale Snoisez
Pivot Pnoise – – The pivot point for the transform rotates and scales.
Pivot Pnoisex
Pivot Pnoisey
Pivot Pnoisez
Translate 4D T4dnoise – Translates the points through the 4th noise dimension.

Page: Remap

Clamp Clamp – When enabled, constrains falloff values to the 0-1 range.
Fit Fit – Enables remapping of falloff values from an input range to an output range.
Auto Input Min Max Auto – Automatically determines input range from actual min/max falloff values.
Input Min Inputmin – Minimum value of the input range for remapping.
Input Max Inputmax – Maximum value of the input range for remapping.
Output Min Outputmin – Minimum value of the output range for remapping.
Output Max Outputmax – Maximum value of the output range for remapping.
Invert Invert – Reverses the falloff values (1 - value).
Enable Remap Ramp Enableremapramp – Applies a custom curve to remap falloff values non-linearly.
Open Remap Ramp Remapramp – Opens the ramp editor for defining the custom remapping curve.
Reset Remap Ramp Resetremapramp – Resets the remapping curve to a linear ramp.
Ramp TOP Ramptop – External TOP containing a custom remap curve texture.

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 Geometry or regular geometry to apply falloff to

Outputs

Output 0 – POP – Geometry with falloff attribute applied