> tools

Reorient

tools/reorient·v1.3.0
IN:2  OUT:1

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.

PAGEReorient
GroupGroupIf there are input groups, specifying a group name in this field will cause this POPX to act only upon the group specified.
Reference GeometryReferencegeoPOP geometry to use as reference for transferring orientation. Used when Input 1 is not connected.
Max Search DistanceMaxdistanceMaximum distance to search for nearest neighbor points on reference geometry.
Quaternion AttributeQuatattrName of the quaternion attribute to read when Attribute Type is Quaternion.
Normal AttributeNormalattrName of the normal vector attribute when Attribute Type is Two Vectors.
Up AttributeUpattrName of the up vector attribute when Attribute Type is Two Vectors.
Matrix AttributeMatrixattrName of the matrix attribute to read when Attribute Type is Matrix.
PAGECommon
BypassBypassPass through the first input to the output unchanged.
Free Extra GPU MemoryFreeextragpumemFree memory that has accumulated when output memory has grown and shrunk.
Render PrimitivesRenderprimitivesToggles rendering of POPX Geometry or shows it as point instances only.
Convert to Point PrimitivesConverttoptprimConverts points to primitive points when Render Primitives is toggled off.
SRT / RSTSrtrstSets the transform order when using POPX Geometry as built-in TouchDesigner instances.
Input 0 POP POPX/POP Geometry
Input 1 POP Reference Geometry
Output 0 POP POPX_out1
Reorient · Docs