getDir: Difference between revisions

From Bohemia Interactive Community
m (Use since template and fix description)
Line 6: Line 6:
|1.00|Game version=
|1.00|Game version=


|arg= global|Multiplayer Arguments=
|arg= global |Multiplayer Arguments=
____________________________________________________________________________________________
____________________________________________________________________________________________


| Returns the object heading in the range 0..360.<br><br>
| Returns the object heading in the range 0..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 engine equivalent of [[BIS_fnc_dirTo]]. |DESCRIPTION=
 
{{Feature arma3 | An alternative syntax was added that gets heading from one object or position to another object or position, the engine equivalent of [[BIS_fnc_dirTo]].}} |DESCRIPTION=
____________________________________________________________________________________________
____________________________________________________________________________________________


Line 18: Line 19:


| [[Number]] |RETURNVALUE=
| [[Number]] |RETURNVALUE=
____________________________________________________________________________________________


| s2= pos1 [[getDir]] pos2 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ''Since Arma 3 v1.55.133361'' |SYNTAX2=
| s2= pos1 [[getDir]] pos2 {{since|arma3|1.55.133361}} |SYNTAX2=


|p21= pos1: [[Object]], [[Position2D]] or [[Position3D]] - from where|PARAMETER21=
|p21= pos1: [[Object]], [[Position2D]] or [[Position3D]] - from where |PARAMETER21=


|p22= pos2: [[Object]], [[Position2D]] or [[Position3D]] - to where |PARAMETER22=
|p22= pos2: [[Object]], [[Position2D]] or [[Position3D]] - to where |PARAMETER22=
Line 28: Line 30:
____________________________________________________________________________________________
____________________________________________________________________________________________


|x1 = <code>_azimuth = [[getDir]] [[player]];</code> |EXAMPLE1=
|x1 = <code>_azimuth = [[getDir]] [[player]];</code> |EXAMPLE1=


|x2 = <code>_azimuth = [[player]] [[getDir]] tank;</code> |EXAMPLE2=
|x2 = <code>_azimuth = [[player]] [[getDir]] tank;</code> |EXAMPLE2=
Line 48: Line 50:


<code>[[0,1,0], '''-('''[[getDir]] _object''')'''] [[call]] [[BIS_fnc_rotateVector2D]];</code>
<code>[[0,1,0], '''-('''[[getDir]] _object''')'''] [[call]] [[BIS_fnc_rotateVector2D]];</code>


<!-- Note Section END -->
<!-- Note Section END -->

Revision as of 00:36, 2 November 2019

Logo A0.png 1.00
GAGlobal
Hover & click on the images for description

Description

Description:
Returns the object heading in the range 0..360.
Arma 3
An alternative syntax was added that gets heading from one object or position to another object or position, the engine equivalent of BIS_fnc_dirTo.
Groups:
Uncategorised

Syntax

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

Alternative Syntax

Syntax:
pos1 getDir pos2 Template:since
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

Retrieved from "https://community.bistudio.com/wiki?title=getDir&oldid=138350"