POPX

Aim

v1.3.0
Modifiers

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

GroupGroup
If there are input groups, specifying a group name in this field will cause this POPX to act only upon the group specified.
Do FalloffDofalloff
Enables falloff-based aim intensity control.
Falloff AttributeFalloffattr
Specifies which attribute to use for falloff values that attenuate aim rotation strength.
Aim MethodAimmethod
Determines how aim targets are specified: Aim Vector, Aim at Object, or Aim at Positions.
Aim VectorvectorAim at ObjectobjectAim at Pointspoints
Aim VectorAimvector
Direction vector for aim orientation when Aim Method is set to Aim Vector.
Aim VectorAimvectorxAim VectorAimvectoryAim VectorAimvectorz
Aim PositionAimposition
Target position for aim orientation when Aim Method is set to Aim at Object.
Aim PositionAimpositionxAim PositionAimpositionyAim PositionAimpositionz
Display Aim GuideDisplayaimguide
Visualizes aim target positions in the viewport.
Guide ScaleAimguidescale
Controls the display size of aim guide visualization.
ColorAimcolor
Color of the aim guide visualization.
ColorAimcolorrColorAimcolorgColorAimcolorb
Up MethodUpmethod
Determines how up direction is specified: Up Vector, Up at Object, or Up at Positions.
Up VectorvectorUp at ObjectobjectUp at Pointspoints
Up VectorUpvector
Direction vector for up orientation when Up Method is set to Up Vector.
Up VectorUpvectorxUp VectorUpvectoryUp VectorUpvectorz
Up PositionUpposition
Target position for up orientation when Up Method is set to Up at Object.
Up PositionUppositionxUp PositionUppositionyUp PositionUppositionz
Display Up GuideDisplayupguide
Visualizes up target positions in the viewport.
Guide ScaleUpguidescale
Controls the display size of up guide visualization.
ColorUpcolor
Color of the up guide visualization.
ColorUpcolorrColorUpcolorgColorUpcolorb
Aim AxisAimaxis
Specifies which local axis should be used as the aim direction.
XxYyZz
Up AxisUpaxis
Specifies which local axis should be used as the up direction.
XxYyZz
Invert AimInvertaim
Reverses the aim direction by 180 degrees.
Invert UpInvertup
Reverses the up direction by 180 degrees.
Constrain Around UpConstrainaroundup
Limits rotation to occur only around the up axis, preventing roll.
BypassBypass
Pass through the first input to the output unchanged.
Free Extra GPU MemoryFreeextragpumem
Free memory that has accumulated when output memory has grown and shrunk.
Render PrimitivesRenderprimitives
Toggles rendering of POPX Geometry or shows it as point instances only.
Convert to Point PrimitivesConverttoptprim
Converts points to primitive points when Render Primitives is toggled off.
SRT / RSTSrtrst
Sets the transform order when using POPX Geometry as built-in TouchDesigner instances.

Inputs

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

Outputs

Output 0POP
POPX_out1