getDir: Difference between revisions

From Bohemia Interactive Community
m (global args)
(alt syntax)
Line 7: Line 7:
____________________________________________________________________________________________
____________________________________________________________________________________________


| Returns the unit heading in the range from 0 to 360. |= Description
| Returns the object heading in the range from 0 to 360. <br><br>
Since Arma 3 v1.55.133361, an alternative syntax is added that allows to get heading from one object or position to another object or position, the equivalent of [[BIS_fnc_dirTo]] |= Description
____________________________________________________________________________________________
____________________________________________________________________________________________


| [[Number]] <nowiki>=</nowiki> '''getDir''' object |= Syntax
| '''getDir''' object |= Syntax


|p1= object: [[Object]] |=Parameter 1
|p1= object: [[Object]] |=Parameter 1
| [[Number]] |= Return value
| [[Number]] |= Return value
| s2= pos1 '''getDir''' pos2 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ''Since Arma 3 v1.55.133361''|= Syntax
|p21= pos1: [[Object]], [[Position2D]] or [[Position3D]] - from where|=Parameter 1
|p22= pos2: [[Object]], [[Position2D]] or [[Position3D]] - to where |=Parameter 1
| r2= [[Number]] |= Return value
____________________________________________________________________________________________
____________________________________________________________________________________________
|x1 = <code>_degrees <nowiki>=</nowiki> '''getDir''' [[player]] </code> |= Example 1
|x1 = <code>_azimuth =  [[getDir]] [[player]];</code> |= Example 1
 
|x2 = <code>_azimuth = [[player]] [[getDir]] tank;</code> |= Example 2
____________________________________________________________________________________________
____________________________________________________________________________________________
| [[getDirVisual]], [[direction]] |= See also
| [[getDirVisual]], [[direction]] |= See also

Revision as of 16:11, 13 November 2015

Hover & click on the images for description

Description

Description:
Returns the object heading in the range from 0 to 360.

Since Arma 3 v1.55.133361, an alternative syntax is added that allows to get heading from one object or position to another object or position, the equivalent of BIS_fnc_dirTo
Groups:
Uncategorised

Syntax

Syntax:
getDir object
Parameters:
object: Object
Return Value:
Number

Alternative Syntax

Syntax:
pos1 getDir pos2         Since Arma 3 v1.55.133361
Parameters:
pos1: Object, Position2D or Position3D - from where
pos2: Object, Position2D or Position3D - to where
Return Value:
Number

Examples

Example 1:
_azimuth = getDir player;
Example 2:
_azimuth = player getDir tank;

Additional Information

See also:
getDirVisualdirection

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord.
Only post proven facts here! Add Note

Notes

Posted on October 23, 2013
AgentRev
Be careful when using this command in conjunction with BIS_fnc_rotateVector2D; the latter rotates vectors counterclockwise (mathematically correct), while getDir returns a clockwise angle.
To counter this, simply negate the output of getDir: [[0,1,0], -(getDir _object)] call BIS_fnc_rotateVector2D;

Bottom Section