> modifiers

Aim

modifiers/aim·v1.3.0

IN:3 OUT:1

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

PAGEGeneral

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.

PAGEAim

[+]Aim Method	Aimmethod	Determines how aim targets are specified: Aim Vector, Aim at Object, or Aim at Positions.
[+]Aim Vector	Aimvector	Direction vector for aim orientation when Aim Method is set to Aim Vector.
[+]Aim Position	Aimposition	Target position for aim orientation when Aim Method is set to Aim at Object.
Display Aim Guide	Displayaimguide	Visualizes aim target positions in the viewport.

PAGEUp

Guide Scale	Aimguidescale	Controls the display size of aim guide visualization.
[+]Color	Aimcolor	Color of the aim guide visualization.
[+]Up Method	Upmethod	Determines how up direction is specified: Up Vector, Up at Object, or Up at Positions.
[+]Up Vector	Upvector	Direction vector for up orientation when Up Method is set to Up Vector.
[+]Up Position	Upposition	Target position for up orientation when Up Method is set to Up at Object.
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.

PAGEOrientation

[+]Aim Axis	Aimaxis	Specifies which local axis should be used as the aim direction.
[+]Up Axis	Upaxis	Specifies which local axis should be used as the up direction.
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.

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	Toggles rendering of POPX Geometry or shows it as point instances only.
Convert to Point Primitives	Converttoptprim	Converts points to primitive points when Render Primitives is toggled off.
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