Aim

Summary

The Aim orients instances towards a particular position in space, towards an object's position, or towards individual positions per-instance. Instances will have their aim axis aligned to point directly at the target position, with rotation controlled by a specified up vector or up position.

You can define aim targets using three methods: Aim Vector, Aim at Object, or Aim at Positions. Similarly, the up direction can be defined using Up Vector, Up at Object, or Up at Positions. Optional falloff-based attenuation enables spatially varying aim effects.

Parameters

Page: General

Group Group If there are input groups, specifying a group name in this field will cause this POPX to act only upon the group specified.
Do Falloff Dofalloff Enables falloff-based aim intensity control.
Falloff Attribute Falloffattr Specifies which attribute to use for falloff values that attenuate aim rotation strength.

Page: Aim

Aim Method Aimmethod Determines how aim targets are specified: Aim Vector, Aim at Object, or Aim at Positions.
Aim Vector vector
Aim at Object object
Aim at Points points
Aim Vector Aimvector Direction vector for aim orientation when Aim Method is set to Aim Vector.
Aim Vector Aimvectorx
Aim Vector Aimvectory
Aim Vector Aimvectorz
Aim Position Aimposition Target position for aim orientation when Aim Method is set to Aim at Object.
Aim Position Aimpositionx
Aim Position Aimpositiony
Aim Position Aimpositionz
Display Aim Guide Displayaimguide Visualizes aim target positions in the viewport.
Guide Scale Aimguidescale Controls the display size of aim guide visualization.
Color Aimcolor Color of the aim guide visualization.
Color Aimcolorr
Color Aimcolorg
Color Aimcolorb

Page: Up

Up Method Upmethod Determines how up direction is specified: Up Vector, Up at Object, or Up at Positions.
Up Vector vector
Up at Object object
Up at Points points
Up Vector Upvector Direction vector for up orientation when Up Method is set to Up Vector.
Up Vector Upvectorx
Up Vector Upvectory
Up Vector Upvectorz
Up Position Upposition Target position for up orientation when Up Method is set to Up at Object.
Up Position Uppositionx
Up Position Uppositiony
Up Position Uppositionz
Display Up Guide Displayupguide Visualizes up target positions in the viewport.
Guide Scale Upguidescale Controls the display size of up guide visualization.
Color Upcolor Color of the up guide visualization.
Color Upcolorr
Color Upcolorg
Color Upcolorb

Page: Orientation

Aim Axis Aimaxis Specifies which local axis should be used as the aim direction.
X x
Y y
Z z
Up Axis Upaxis Specifies which local axis should be used as the up direction.
X x
Y y
Z z
Invert Aim Invertaim Reverses the aim direction by 180 degrees.
Invert Up Invertup Reverses the up direction by 180 degrees.
Constrain Around Up Constrainaroundup Limits rotation to occur only around the up axis, preventing roll.

Page: Common

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 Toggles rendering of POPX Geometry or shows it as point instances only.
SRT / RST Srtrst Sets the transform order when using POPX Geometry as built-in TouchDesigner instances.

Inputs

Input 0 POP POPX/POP Geometry
Input 1 POP Aim Target
Input 2 POP Up Target

Outputs

Output 0 POP POPX_out1