getDir: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
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 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