> tools

Attribute To Index

tools/attribute-to-index·v1.3.0

IN:1 OUT:1

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

PAGEIndex

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.

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

OUTPUTS

Output 0 POP – POPX_out1