getDir: Difference between revisions

From Bohemia Interactive Community
(see also)
m (template:command argument fix)
Line 8: Line 8:


| Returns the object heading in the range from 0 to 360. <br><br>
| 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
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=
____________________________________________________________________________________________
____________________________________________________________________________________________


| '''getDir''' object |= Syntax
| '''getDir''' object |SYNTAX=


|p1= object: [[Object]] |=Parameter 1
|p1= object: [[Object]] |PARAMETER1=
| [[Number]] |= Return value
| [[Number]] |RETURNVALUE=


| s2= pos1 '''getDir''' pos2 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ''Since Arma 3 v1.55.133361''|= Syntax
| 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
|p21= pos1: [[Object]], [[Position2D]] or [[Position3D]] - from where|PARAMETER1=
|p22= pos2: [[Object]], [[Position2D]] or [[Position3D]] - to where |=Parameter 1
|p22= pos2: [[Object]], [[Position2D]] or [[Position3D]] - to where |PARAMETER1=


| r2= [[Number]] |= Return value
| r2= [[Number]] |RETURNVALUE=
____________________________________________________________________________________________
____________________________________________________________________________________________
|x1 = <code>_azimuth =  [[getDir]] [[player]];</code> |= Example 1
|x1 = <code>_azimuth =  [[getDir]] [[player]];</code> |EXAMPLE1=


|x2 = <code>_azimuth = [[player]] [[getDir]] tank;</code> |= Example 2
|x2 = <code>_azimuth = [[player]] [[getDir]] tank;</code> |EXAMPLE2=
____________________________________________________________________________________________
____________________________________________________________________________________________
| [[getDirVisual]], [[direction]], [[getRelDir]] |= See also
| [[getDirVisual]], [[direction]], [[getRelDir]] |SEEALSO=


}}
}}

Revision as of 14:40, 7 April 2019

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:
getDirVisualdirectiongetRelDir

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