getDir: Difference between revisions

From Bohemia Interactive Community
m (Text replacement - "_{10,} " to "")
m (Text replacement - " *\| *([Cc]omments|COMMENTS|Game|[Gg]ame [Nn]ame|Game [Vv]ersion|Game Version \(number surrounded by NO SPACES\)|Multiplayer Arguments( \("local" or "global"\))?|Effects|Multiplayer Effects( \("local" or "global"\))?|Multiplayer Exe...)
Line 1: Line 1:
{{Command|Comments=
{{Command


| ofp |Game name=
| ofp


|1.00|Game version=
|1.00


|arg= global |Multiplayer Arguments=
|arg= global


|gr1= Object Manipulation |GROUP1=
|gr1= Object Manipulation


| Returns the object heading in the range 0..360.
| 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]].}} |DESCRIPTION=
{{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]].}}


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


|p1= object: [[Object]] |PARAMETER1=
|p1= object: [[Object]]


| [[Number]] |RETURNVALUE=
| [[Number]]


| s2= pos1 [[getDir]] pos2 {{Since|arma3|1.55.133361}} |SYNTAX2=
| s2= pos1 [[getDir]] pos2 {{Since|arma3|1.55.133361}}


|p21= pos1: [[Object]], [[Position2D]] or [[Position3D]] - from where |PARAMETER21=
|p21= pos1: [[Object]], [[Position2D]] or [[Position3D]] - from where |PARAMETER21=
Line 25: Line 25:
|p22= pos2: [[Object]], [[Position2D]] or [[Position3D]] - to where |PARAMETER22=
|p22= pos2: [[Object]], [[Position2D]] or [[Position3D]] - to where |PARAMETER22=


| r2= [[Number]] |RETURNVALUE2=
| r2= [[Number]]


|x1 = <code>_azimuth = [[getDir]] [[player]];</code> |EXAMPLE1=
|x1 = <code>_azimuth = [[getDir]] [[player]];</code>


|x2 = <code>_azimuth = [[player]] [[getDir]] tank;</code> |EXAMPLE2=
|x2 = <code>_azimuth = [[player]] [[getDir]] tank;</code>


| [[getDirVisual]], [[direction]], [[getRelDir]] |SEEALSO=
| [[getDirVisual]], [[direction]], [[getRelDir]]
}}
}}



Revision as of 00:35, 18 January 2021

Hover & click on the images for description

Description

Description:
Returns the object heading in the range 0..360.
Arma 3
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.
Groups:
Object Manipulation

Syntax

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

Alternative Syntax

Syntax:
pos1 getDir pos2 Template:Since
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, 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;

Bottom Section