getDir: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(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 or on the Forums.
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