> tools

Apply Attributes

tools/apply-attributes·v1.3.0

IN:2 OUT:1

SUMMARY

Apply Attributes is the core transformation engine of POPX, taking packed primitives and applying template point attributes to drive transformations. This operator is the fundamental building block for most POPX operations, handling the application of position, rotation, scale, and pivot data from template points to geometry instances.

The operator uses the popxFalloff point attribute (or custom falloff attribute) to blend transformations smoothly. Orientations are blended using slerp (spherical linear interpolation) for natural rotation interpolation, while translations and scales are linearly interpolated. This ensures smooth, predictable motion even with complex falloff patterns.

Apply Attributes supports both absolute and relative transformations through its Local Space option, and offers flexible rotation and scale modes. The operator can also copy arbitrary point attributes from template geometry to instances, and automatically manages orient and scale attributes for downstream operators. The Create popxId Attribute option ensures each instance has a unique identifier for tracking and reference.

PARAMETERS

PAGETransformation

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.
Do Falloff	Dofalloff	When enabled, uses a falloff attribute to blend transformations smoothly.
Falloff Attribute	Falloffattr	Name of the falloff attribute to use for blending transformations (default: popxFalloff).
Do Translate	Dotranslate	Enables translation transformations from template points.
Do Rotate	Dorotate	Enables rotation transformations from template points using slerp interpolation.
Do Scale	Doscale	Enables scale transformations from template points.
Do Pivot	Dopivot	Enables pivot point transformations from template points.
Local Space	Localspace	When enabled, applies transformations relative to the instance's current transform.
[+]Rotate Mode	Rotmode	Determines how rotations are applied to instances.
[+]Rotate Order	Rord	Order in which rotation axes are applied.
[+]Scale Mode	Scalemode	Determines how scale values are applied to instances.

PAGEAttributes

Copy Attributes	Copyattrs	When enabled, copies point attributes from template geometry to instances.
Attributes To Copy	Attrstocopy	Space-separated list of attribute names to copy from template points.
Create popxId Attribute if Missing	Createid	Automatically creates unique popxId attributes for instances that don't have one.
Output Orient Attribute	Outputorientattr	Outputs orientation data as an attribute for downstream operators.
Output Scale Attribute	Outputscaleattr	Outputs scale data as an attribute for downstream operators.

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 POP – Template Points

OUTPUTS

Output 0 POP – POPX_out1