> tools

Orient Mesh

tools/orient-mesh·v1.5.1

IN:1 OUT:1

SUMMARY

Orient Mesh writes N, Up and an Orient quaternion on every point of a mesh. Compute Method derives Up from the surrounding polygons (first edge, two edges, centroid, texture UV or an attribute gradient), from the normal with an automatic or fixed up vector, or from an existing Orient. The frame sets the direction of motion for Move Along Mesh and feeds the Instancer's mesh distribution.

For swirling motion over a surface, use N and Up with Cross Up Vector, which wraps Up around the surface. Curl noise disturbs the frame, blur smooths it over neighboring points by connectivity or proximity, and Visualize Up Vector draws a line per point to check the flow.

PARAMETERS

PAGEOrient Mesh

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.
Visualize Up Vector	Visualizeupvector	Draw the up vectors as lines. They are for display only.
Length Scale	Lengthscale	Sets the length of the guide lines.
[+]Color	Color	Sets the color of the up vector guides.
[+]Compute Method	Computemethod	Determines how the frame is computed: from the polygons, from N and Up, or from an existing Orient.
Compute Normals	Computenormals	When on, the normals are recomputed in N and Up mode. When off, the input N is used.
Auto Up	Autoup	When on, Up is derived from the normal in N and Up mode. When off, Up Vector is used.
[+]Up Vector	Upvector	Sets the up direction when Auto Up is off.
[+]Style	Style	Determines what the frame is built from: the first edge, two edges, the primitive centroid, the texture UV, the UV gradient or an attribute gradient.
Attribute Name	Attrname	The UV or other attribute used by the UV and gradient styles. When empty, Tex is used.
Make Frame Orthogonal	Makeortho	Project Up onto the tangent plane so the frame is orthogonal.
Invert N	Invertn	Enable flipping the N direction.
Invert Up	Invertup	Flip the up direction by 180 degrees.
Cross Up Vector	Crossupvector	When on, Up becomes N cross Up, wrapping around the surface in swirls.
Output Tangent	Outputtangent	Whether to also output a Tangent attribute.

PAGECurl Noise

Enable Curl Noise	Enablecurlnoise	Blend curl noise into the up vector.
Blend	Blend	Blends from the computed Up at 0 to the curl noise direction alone at 1.
[+]Type	Type	Determines the noise type.
Seed	Seed	Numerical value that initializes the randomization.
Period	Period	Period (scale) of the noise field.
Harmonics	Harmon	The number of higher frequency components to layer on top of the base frequency. 0 harmonics give the base shape.
Harmonic Spread	Spread	The factor by which the frequency of a harmonic increases relative to the previous harmonic.
Harmonic Gain	Gain	Amplitude of the Harmonics layered on top of the base frequency.
Amplitude	Amp	The noise values amplitude (a scale on the values output).
Exponent	Exp	Sets the exponent. The internal value is raised by the power of the exponent.
[+]Transform Order	Xord	Sets the overall transform order for the transformations.
[+]Rotate Order	Rord	Sets the order of the rotations within the overall transform order.
[+]Translate	T	Translate the points through the noise space.
[+]Rotate	R	Rotate the points around the corresponding X, Y and Z axes. Angles are given in degrees.
[+]Scale	S	These three fields scale the Source geometry in the three axes.
[+]Pivot	P	The pivot point for the transform rotates and scales.
Translate 4D	T4d	Translates the points through the 4th noise dimension.

PAGEBlur

Enable Blur	Enableblur	Enable averaging Up over neighboring points.
[+]Influence Type	Influencetype	Determines how neighbors are found: edge-joined (Connectivity) or with a Gaussian within Kernel Radius (Proximity).
Iterations	Iterations	Number of blur passes.
Max Neighbors	Maxneighbors	Maximum number of neighbors a point is blurred with.
Kernel Radius	Kernelradius	Sets the search radius of the proximity blur.

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.

INPUTS

Input 0 POP - Input Mesh

OUTPUTS

Output 0 POP - POPX Geometry