Reorient

Summary

Reorient creates a quaternion point attribute, popxOrient, that acts as a replacement for a POPX Geometry instance's existing local orientation frame without modifying the underlying transforms at all. In plainer terms, this resets the rotation axes of the POPX Geometry instances without visibly moving anything, providing more accurate orientation for subsequent transformations.

The operator is particularly useful after using operations like Explode, where you want pieces to move outward along their local axes rather than in a uniform direction. Normally when you convert or explode geometry, the local orientations of each POPX Geometry instance are left at default, causing all pieces to move in the same direction when transformed. Reorient solves this by transferring orientation from reference geometry or point attributes to your POPX Geometry instances.

You can source orientation data from point attributes (quaternion, two vectors, or matrix) or from reference geometry using proximity-based neighbor matching. When using reference geometry, the operator finds the closest points on the reference mesh and transfers their orientation to your instances. This makes it easy to reorient exploded pieces based on the original mesh surface normals, or to apply custom orientation patterns from template geometry.

Parameters

Page: Reorient

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.
Orient Source Orientsource Determines whether to read orientation from point attributes or reference geometry.
Point Attribute ptattr
Reference Geometry refgeo
Reference Geometry Referencegeo POP geometry to use as reference for transferring orientation. Used when Input 1 is not connected.
Max Search Distance Maxdistance Maximum distance to search for nearest neighbor points on reference geometry.
Distribution Distribution Method for selecting neighbor points when using reference geometry.
Default default
Unique unique
Closest closest
Attribute Type Attrtype Type of orientation data to read from point attributes.
Quaternion quat
Two Vectors vectors
Matrix matrix
Quaternion Attribute Quatattr Name of the quaternion attribute to read when Attribute Type is Quaternion.
Normal Attribute Normalattr Name of the normal vector attribute when Attribute Type is Two Vectors.
Up Attribute Upattr Name of the up vector attribute when Attribute Type is Two Vectors.
Matrix Attribute Matrixattr Name of the matrix attribute to read when Attribute Type is Matrix.

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
Input 1 POP Reference Geometry

Outputs

Output 0 POP POPX_out1