getDir: Difference between revisions

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