getDir: Difference between revisions

From Bohemia Interactive Community
m (Some wiki formatting)
m (Some wiki formatting)
Line 27: Line 27:


|descr= Returns the object heading in the range 0..360.
|descr= Returns the object heading in the range 0..360.
{{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]].}}
{{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
|s1= [[getDir]] object
Line 35: Line 35:
|r1= [[Number]]
|r1= [[Number]]


|s2= pos1 [[getDir]] pos2 {{Since|arma3|1.55.133361|y}}
|s2= pos1 [[getDir]] pos2
 
|s2since= arma3 1.56


|p21= pos1: [[Object]], [[Position2D]] or [[Position3D]] - from where
|p21= pos1: [[Object]], [[Position2D]] or [[Position3D]] - from where
Line 56: Line 58:
<dt class="note">[[User:AgentRev|AgentRev]]</dt>
<dt class="note">[[User:AgentRev|AgentRev]]</dt>
<dd class="note">
<dd class="note">
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.
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>
<br>
To counter this, simply negate the output of [[getDir]]:
To counter this, simply negate the output of [[getDir]]:
<code>[[0,1,0], '''-('''[[getDir]] _object''')'''] [[call]] [[BIS_fnc_rotateVector2D]];</code>
<code>[[0,1,0], '''-('''[[getDir]] _object''')'''] [[call]] [[BIS_fnc_rotateVector2D]];</code>
</dd>


</dl>
</dl>

Revision as of 21:47, 10 August 2021

Logo A0.png 1.00ofpe logo.png 1.00Logo A1 black.png 1.00Logo A2.png 1.00A2 OA Logo.png 1.50tkoh logo small.png 1.00Arma 3 logo black.png 0.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:
getDirVisualdirectiongetRelDir

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord.
Only post proven facts here! Add Note
Posted on October 23, 2013
AgentRev
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=292609"