getDir: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
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 01:36, 2 November 2019

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