> modifiers

Aim

modifiers/aim·v1.5.1

IN:3 OUT:1

SUMMARY

The Aim rotates each instance so its Aim Axis points at a target and its Up Axis turns toward an up reference, leaving position, scale and pivot unchanged and keeping the instances on their current P. The aim and the up direction can each be a fixed vector, an object (a position or the centroid of the POP on the second or third input), the closest point of that POP per instance, or a vector attribute on the instance itself, such as PartVel so particles face their motion.

Invert Aim and Invert Up flip either direction, and Constrain Around Up limits the turn to a rotation around the up axis with no tilt. Do Falloff blends the new rotation from the incoming one per instance, instances whose aim attribute is zero keep their rotation, and viewport guides show the aim and up targets.

PARAMETERS

PAGEGeneral

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.
Do Falloff	Dofalloff	Weight the effect on each point by the Falloff Attribute.
Falloff Attribute	Falloffattr	The point attribute, 0 to 1, that weights the effect.

PAGEAim

[+]Aim Method	Aimmethod	Determines the aim target: a direction (Aim Vector), an object's centroid (Aim at Object), the closest point (Aim at Points) or a point attribute (Aim Along Attribute).
Aim Attribute	Aimattr	The vector attribute each point aims along, such as PartVel. Points where it is zero keep their rotation.
Aim Vector	Aimvector	The direction to aim along.
Aim Position	Aimposition	The target position for Aim at Object when nothing is connected to the second input.
Display Aim Guide	Displayaimguide	Display the aim targets in the viewport.
Guide Scale	Aimguidescale	Sets the size of the aim guide.
[+]Color	Aimcolor	Sets the color of the aim guide.

PAGEUp

[+]Up Method	Upmethod	Determines the up target: Up Vector uses a direction, Up at Object its centroid, Up at Points the closest point, Up Along Attribute a point attribute.
Up Attribute	Upattr	The vector attribute each point uses as its up direction. Points where it is zero use the Up Vector.
Up Vector	Upvector	Up direction when Up Method is Up Vector.
Up Position	Upposition	In Up at Object mode, the target position used when nothing is connected to the up input.
Display Up Guide	Displayupguide	Display the up targets in the viewport.
Guide Scale	Upguidescale	Sets the size of the up guide.
[+]Color	Upcolor	Sets the color of the up guide.

PAGEOrientation

[+]Aim Axis	Aimaxis	Selects the local axis that points at the aim target.
[+]Up Axis	Upaxis	Specifies which local axis is used as the up direction.
Invert Aim	Invertaim	Flip the aim direction by 180 degrees.
Invert Up	Invertup	Flip the up direction by 180 degrees.
Constrain Around Up	Constrainaroundup	Rotate only around the up axis, with no roll or tilt.

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.

ATTRIBUTES

IORead

popxFalloff

point float

Falloff attribute controlling where and how strongly the effect is applied (default popxFalloff; set by Falloff Attribute).

IOModified

P	point vec3	Instance position - the aim origin, carried through to the output transform.
Orient	point vec4	Instance orientation. Set so the chosen axis aims at the target, blended toward the original by the falloff.
Scale	point vec3	Instance scale, carried into the output transform.
PointScale	point float	Uniform per-instance scale, folded into the transform.
Pivot	point vec3	Per-instance pivot used when building the transform.
Transform	point mat3	Per-instance 3x3 transform rebuilt from the aimed orientation.

IOCreated

FullTransform

point mat4

Per-instance 4x4 transform including pivot-corrected translation.

INPUTS

Input 0 POP - POPX/POP Geometry

Input 1 POP - Aim Target

Input 2 POP - Up Target

OUTPUTS

Output 0 POP - POPX/POP Geometry