> falloffs

Texture Falloff

falloffs/texture-falloff·v1.3.0

IN:2 OUT:1

SUMMARY

The Texture Falloff applies falloff values by sampling 2D or 3D textures (TOP) using point positions or custom attributes as UVW coordinates. This allows for highly customizable falloff patterns driven by images, procedural textures, or animated content.

Supports various lookup channels (luminance, RGB, alpha), multiple extend modes (repeat, mirror, hold, zero), and interpolation options. Transform controls allow you to translate, rotate, and scale the sampling space, with optional normalization for consistent results regardless of geometry bounds.

The resulting falloff values can be combined with existing falloff attributes, enhanced with procedural noise, remapped with custom curves, and previewed with color ramps. This makes Texture Falloff ideal for creating complex, art-directable patterns by painting falloff maps in external tools or using TouchDesigner's procedural generation capabilities.

PARAMETERS

PAGETexture

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.
Texture (TOP)	Top	TOP to use for lookup.
Use Custom UVW	Usecustomuvw	When enabled, uses custom attributes for texture coordinate lookup instead of world position.
Lookup Index Attribute U	Lookupindexattr0	Attribute to use as the index for the U coordinate of the lookup. Only active when Use Custom UVW is enabled.
Lookup Index Attribute V	Lookupindexattr1	Attribute to use as the index for the V coordinate of the lookup. Only active when Use Custom UVW is enabled.
Lookup Index Attribute W	Lookupindexattr2	Attribute to use as the index for the W coordinate of the lookup. Only active when Use Custom UVW is enabled.
[+]Lookup Index Offset	Lookupindexoffset	Offset applied to custom UVW coordinates before sampling. Only active when Use Custom UVW is enabled.
[+]Lookup Index Units	Indexunit	Units for lookup index attribute. Only active when Use Custom UVW is enabled.
[+]Lookup Channel	Lookupchannel	Which channel or combination of channels to use for falloff values.
[+]Pixel Centered Sampling Location	Pixelcentered	Enable input remapping to sample pixels centers.
[+]Cyclic Lookup	Cyclic	When enabled, the index wraps so the end connects back to the start, letting the full range map evenly across the cycle.
[+]Input Extend Mode	Inputextend	What happens when the lookup index attribute is outside of the valid range.
Interpolate	Interpolate	When on, the TOP can be interpolated between pixels. When off, the nearest pixel used.
Use Depth Offset	Usedepthoffset	Enable using the texture's depth offset for Texture 3D TOPs.
Normalize Sampling Position	Normalizesamplepos	Normalizes point positions to 0-1 range based on bounding box before sampling.

PAGENoise

[+]Translate	T	Translation offset for texture sampling coordinates.
[+]Rotate	R	Rotation of texture sampling space in degrees.
[+]Scale	S	Scale factor for texture sampling coordinates.
[+]Pivot	P	Pivot point for texture space transformations.

PAGETexture

Uniform Scale

Scale

Uniform scaling factor applied to all axes equally.

PAGENoise

Combine Operation

Combineop

Mathematical operation used to combine this falloff with existing falloff values.

PAGEFalloff

Combine Falloff Attribute	Combattrscope	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	Combstrength	Blending factor for the combine operation, ranging from 0 (no effect) to 1 (full effect).
Output Falloff Attribute	Outputfalloffattr	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.
Open Custom Ramp Editor	Opencustumrampeditor	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.

PAGENoise

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).

PAGENoise

[+]Type	Type	Noise algorithm type (Perlin, Simplex, etc.).
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.

PAGENoise

Translate 4D

T4dnoise

Translates the points through the 4th noise dimension.

PAGERemap

Enable Remap	Remap	Enables remapping controls for adjusting falloff value range and distribution.
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 Ramp Remap	Enablerampremap	Applies a custom curve defined by a ramp to remap the falloff values.
Open Ramp Editor	Openrampeditor	Opens the ramp editor for defining the custom remapping curve.
Reset Ramp	Resetramp	Resets the remap ramp editor.
Custom Ramp TOP	Customramptop	Reference to an external TOP for remap control. When specified, overrides the internal 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	Toggles rendering of POPX Geometry or shows it as point instances only.
Convert to Point Primitives	Converttoptprim	Converts points to primitive points when Render Primitives is toggled off.
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 TOP – Texture

OUTPUTS

Output 0 POP – POPX_out1