POPX

Reorient

v1.3.0
Tools

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

GroupGroup
If there are input groups, specifying a group name in this field will cause this POPX to act only upon the group specified.
Orient SourceOrientsource
Determines whether to read orientation from point attributes or reference geometry.
Point AttributeptattrReference Geometryrefgeo
Reference GeometryReferencegeo
POP geometry to use as reference for transferring orientation. Used when Input 1 is not connected.
Max Search DistanceMaxdistance
Maximum distance to search for nearest neighbor points on reference geometry.
DistributionDistribution
Method for selecting neighbor points when using reference geometry.
DefaultdefaultUniqueuniqueClosestclosest
Attribute TypeAttrtype
Type of orientation data to read from point attributes.
QuaternionquatTwo VectorsvectorsMatrixmatrix
Quaternion AttributeQuatattr
Name of the quaternion attribute to read when Attribute Type is Quaternion.
Normal AttributeNormalattr
Name of the normal vector attribute when Attribute Type is Two Vectors.
Up AttributeUpattr
Name of the up vector attribute when Attribute Type is Two Vectors.
Matrix AttributeMatrixattr
Name of the matrix attribute to read when Attribute Type is Matrix.
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
Input 1POP
Reference Geometry

Outputs

Output 0POP
POPX_out1