> tools

Reorient

tools/reorient·v1.5.1

IN:2 OUT:1

SUMMARY

Reorient replaces the rest frame of each packed point so its local frame matches a requested world-space orientation, without changing positions or transforms. Afterward, Local Space operations in the modifiers work along the new axes.

The frame is read from attributes on the points or from the nearest point of reference geometry within Max Search Distance, as a quaternion, two vectors (N and Up) or a matrix. A typical use is transferring the source mesh's normals, for example from Orient Mesh, onto Explode or Convert pieces so each piece moves along its own surface normal.

PARAMETERS

PAGEReorient

Group	Group	If there are input groups, specifying a group name in this field will cause this POP to act only upon the group specified.
[+]Orient Source	Orientsource	Determines where the orientation is read from: point attributes or reference geometry.
Reference Geometry	Referencegeo	A reference to a POP to copy the orientation from when input 2 is not wired.
Max Search Distance	Maxdistance	Maximum search distance on the reference geometry.
[+]Distribution	Distribution	Determines how neighbors are selected: Default, Unique, Closest or Random.
Max Neighbors	Maxneighbors	Number of reference points averaged. 1 uses the closest only.
[+]Attribute Type	Attrtype	Determines the type of the orientation attribute: Quaternion, Two Vectors or Matrix.
Matrix Attribute	Matrixattr	3x3 or 4x4 matrix attribute that gives the local frame.
Quaternion Attribute	Quatattr	Sets the quaternion attribute, in xyzw order, giving the local frame.
Normal Attribute	Normalattr	Sets the vector attribute used as the local +Z axis in Two Vectors mode.
Up Attribute	Upattr	Sets the vector attribute used as the local +Y axis in Two Vectors mode.

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	Whether to render the full POPX geometry. When off, only point instances are drawn.
Convert to Point Primitives	Converttoptprim	Enable converting points to point primitives when Render Primitives is off.
SRT / RST	Srtrst	Sets the transform order, SRT or RST, used when the points are rendered as TouchDesigner instances.

INPUTS

Input 0 POP - POPX/POP Geometry

Input 1 POP - Reference Geometry

OUTPUTS

Output 0 POP - POPX/POP Geometry