POPX

Attribute To Index

v1.3.0
Tools

Summary

Attribute To Index creates a point attribute popxIndex that the POPX Instancer will use by default to determine what instances to place on different points when the "Indexing Mode" of the POPX Instancer is set to "Point Attribute." This operator creates this index from any existing attribute by remapping it to a given minimum and maximum integer range.

The operator is essential for creating variation in instanced geometry based on other attribute data like falloff values, noise patterns, or custom attributes. By converting continuous attribute values into discrete integer indices, you can map different geometry variations to different regions of your point cloud based on any attribute-driven pattern. The defaults remap the popxFalloff attribute to a range of index integers from 0 to 3.

You can control the number of index steps (discrete variations), the starting index value, and the input attribute range to remap from. A debug color mode is available to visualize the index distribution across your geometry. This makes it easy to see how different index values are distributed and verify that your remapping produces the desired variation pattern before connecting to an Instancer.

Parameters

GroupGroup
If there are input groups, specifying a group name in this field will cause this POPX to act only upon the group specified.
Input AttributeInputattr
Name of the attribute to read and remap to index values.
Input Attribute RangeInputattrrange
Minimum and maximum values of the input attribute range to remap from.
Index StepsIndexsteps
Number of discrete index values to generate (number of variations).
Index StartIndexstart
Starting integer value for the index range.
Output AttributeOutputattr
Name of the attribute to write index values to.
Debug ColorDebugcolor
When enabled, visualizes index values using vertex colors for debugging.
BypassBypass
Pass through the first input to the output unchanged.
Free Extra GPU MemoryFreeextragpumem
Free memory that has accumulated when output memory has grown and shrunk.
Render PrimitivesRenderprimitives
Toggles rendering of POPX Geometry or shows it as point instances only.
Convert to Point PrimitivesConverttoptprim
Converts points to primitive points when Render Primitives is toggled off.
SRT / RSTSrtrst
Sets the transform order when using POPX Geometry as built-in TouchDesigner instances.

Inputs

Input 0POP
POPX/POP Geometry

Outputs

Output 0POP
POPX_out1