getDir: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (template:command argument fix)
m (Fix author)
 
(56 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


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


| Returns the object heading in the range from 0 to 360. <br><br>
|game2= ofpe
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=
|version2= 1.00
____________________________________________________________________________________________


| '''getDir''' object |SYNTAX=
|game3= arma1
|version3= 1.00


|p1= object: [[Object]] |PARAMETER1=
|game4= arma2
| [[Number]] |RETURNVALUE=
|version4= 1.00


| s2= pos1 '''getDir''' pos2 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ''Since Arma 3 v1.55.133361''|SYNTAX=
|game5= arma2oa
|version5= 1.50


|p21= pos1: [[Object]], [[Position2D]] or [[Position3D]] - from where|PARAMETER1=
|game6= tkoh
|p22= pos2: [[Object]], [[Position2D]] or [[Position3D]] - to where |PARAMETER1=
|version6= 1.00


| r2= [[Number]] |RETURNVALUE=
|game7= arma3
____________________________________________________________________________________________
|version7= 0.50
|x1 = <code>_azimuth =  [[getDir]] [[player]];</code> |EXAMPLE1=


|x2 = <code>_azimuth = [[player]] [[getDir]] tank;</code> |EXAMPLE2=
|arg= global
____________________________________________________________________________________________
| [[getDirVisual]], [[direction]], [[getRelDir]] |SEEALSO=


}}
|gr1= Object Manipulation
 
|descr= Returns the object heading in the range 0..360.
{{Feature|arma3|The alternative syntax gets heading from one object or position to another object or position, and should be used instead of [[BIS_fnc_dirTo]].}}
 
|s1= [[getDir]] object
 
|p1= object: [[Object]]
 
|r1= [[Number]]
 
|s2= pos1 [[getDir]] pos2
 
|s2since= arma3 1.56


<h3 style="display:none">Notes</h3>
|p21= pos1: [[Object]], [[Position#Introduction|Position2D]] or [[Position#Introduction|Position3D]] - from where
<dl class="command_description">
<!-- Note Section BEGIN -->


<dd class="notedate">Posted on October 23, 2013
|p22= pos2: [[Object]], [[Position#Introduction|Position2D]] or [[Position#Introduction|Position3D]] - to where
<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.
<br/>
To counter this, simply negate the output of getDir:


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


|x1= <sqf>_azimuth = getDir player;</sqf>


<!-- Note Section END -->
|x2= <sqf>_azimuth = player getDir tank;</sqf>
</dl>


<h3 style="display:none">Bottom Section</h3>
|seealso= [[getDirVisual]] [[direction]] [[getRelDir]]
[[Category:Scripting Commands|GETDIR]]
}}
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands OFP 1.96|GETDIR]]
{{Note
[[Category:Scripting Commands OFP 1.46|GETDIR]]
|user= AgentRev01
[[Category:Scripting Commands ArmA|GETDIR]]
|timestamp= 20131023103100
[[Category:Command_Group:_Object_Information|{{uc:{{PAGENAME}}}}]]
|text= Be careful when using this command in conjunction with [[BIS_fnc_rotateVector2D]], which rotates vectors counterclockwise as per trigonometric conventions, while [[getDir]] returns a clockwise angle.<br>
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
To counter this, simply negate the output of [[getDir]]:
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
<sqf>[[0,1,0], -(getDir _object)] call BIS_fnc_rotateVector2D;</sqf>
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
}}

Latest revision as of 23:14, 4 May 2024

Logo A0.png1.00ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
GAGlobal
Hover & click on the images for description

Description

Description:
Returns the object heading in the range 0..360.
Arma 3
The alternative syntax gets heading from one object or position to another object or position, and should be used instead of BIS_fnc_dirTo.
Groups:
Object Manipulation

Syntax

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

Alternative Syntax

Syntax:
pos1 getDir pos2
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:
getDirVisual direction getRelDir

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
AgentRev01 - c
Posted on Oct 23, 2013 - 10:31 (UTC)
Be careful when using this command in conjunction with BIS_fnc_rotateVector2D, which rotates vectors counterclockwise as per trigonometric conventions, while getDir returns a clockwise angle.
To counter this, simply negate the output of getDir:
[[0,1,0], -(getDir _object)] call BIS_fnc_rotateVector2D;
Retrieved from "https://community.bistudio.com/wiki?title=getDir&oldid=364132"