getDir: Difference between revisions

From Bohemia Interactive Community
m (Text replacement - "|SYNTAX= |p21=" to "|SYNTAX2= |p21=")
Line 3: Line 3:


| ofp |Game name=
| ofp |Game name=
|1.00|Game version=
|1.00|Game version=
|arg= global|Multiplayer Arguments=
|arg= global|Multiplayer Arguments=
____________________________________________________________________________________________
____________________________________________________________________________________________


| Returns the object heading in the range from 0 to 360. <br><br>
| Returns the object heading in the range 0..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 engine equivalent of [[BIS_fnc_dirTo]]. |DESCRIPTION=
____________________________________________________________________________________________
____________________________________________________________________________________________


| '''getDir''' object |SYNTAX=
| [[getDir]] object |SYNTAX=


|p1= object: [[Object]] |PARAMETER1=
|p1= object: [[Object]] |PARAMETER1=
| [[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 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ''Since Arma 3 v1.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 |PARAMETER1=


| r2= [[Number]] |RETURNVALUE=
|p22= pos2: [[Object]], [[Position2D]] or [[Position3D]] - to where |PARAMETER22=
 
| r2= [[Number]] |RETURNVALUE2=
____________________________________________________________________________________________
____________________________________________________________________________________________
|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=
____________________________________________________________________________________________
____________________________________________________________________________________________
| [[getDirVisual]], [[direction]], [[getRelDir]] |SEEALSO=
| [[getDirVisual]], [[direction]], [[getRelDir]] |SEEALSO=
}}
}}


Line 36: Line 41:


<dd class="notedate">Posted on October 23, 2013
<dd class="notedate">Posted on October 23, 2013
<dt class="note">[[User:AgentRev01|AgentRev]]<dd class="note">
<dt class="note">[[User:AgentRev01|AgentRev]]
<dd class="note">
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.
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.
<br/>
<br/>
Line 48: Line 54:


<h3 style="display:none">Bottom Section</h3>
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands|GETDIR]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.46|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.96|GETDIR]]
[[Category:Scripting Commands ArmA|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.46|GETDIR]]
[[Category:Scripting Commands ArmA|GETDIR]]
[[Category:Command_Group:_Object_Information|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Object_Information|{{uc:{{PAGENAME}}}}]]

Revision as of 01:21, 3 September 2019

Hover & click on the images for description

Description

Description:
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.
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