Attribute To Index

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

Page: Index

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.
Input Attribute Inputattr – Name of the attribute to read and remap to index values.
Input Attribute Range Inputattrrange – Minimum and maximum values of the input attribute range to remap from.
Index Steps Indexsteps – Number of discrete index values to generate (number of variations).
Index Start Indexstart – Starting integer value for the index range.
Output Attribute Outputattr – Name of the attribute to write index values to.
Debug Color Debugcolor – When enabled, visualizes index values using vertex colors for debugging.

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/POP Geometry

Outputs

Output 0 POP – POPX_out1