atan2: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Result bounds)
m (Some wiki formatting)
 
(91 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| ofp |= Game name
|game1= ofp
|version1= 1.00


|1.00|= Game version
|game2= ofpe
____________________________________________________________________________________________
|version2= 1.00


| ArcTangent of ''x/y''. Used to determine the angle of a vector ''[x,y]''. Result in [[Number#Degrees|Degrees]] between -180 and 180.
|game3= arma1
|version3= 1.00


<br>Note that this command can handle ''y'' being 0, unlike when using [[atan]], and will return 90 |= Description
|game4= arma2
____________________________________________________________________________________________
|version4= 1.00


| [[Number]] <nowiki>=</nowiki> x '''atan2''' y |= Syntax
|game5= arma2oa
|version5= 1.50


|p1= x: [[Number]] |= Parameter 1
|game6= tkoh
|version6= 1.00


|p2= y: [[Number]] |= Parameter 2
|game7= arma3
|version7= 0.50


|gr1= Math - Geometry


| [[Number]]  
|descr= [[File:atan.jpg|right|300px]] ArcTangent of ''y/x''. Used to determine the angle of a vector ''[y,x]''. Result in [[Number#Degrees|Degrees]] between -180 and 180.
{{Feature|informative|This command can handle ''x'' being 0, unlike when using [[atan]], and will return 90}}
{{Feature|important|
This command has [[SQF Syntax#Rules of Precedence|higher precedence]] than the [[select]] command, therefore beware of the case below:
<sqf notrim>
_pos select 0  atan2 (_pos select 1) // error
(_pos select 0) atan2 (_pos select 1) // OK
</sqf>


<br><br>[[Image:atan.jpg|200px]]|= Return value
Alternatively, consider using the [[a hash b|#]] operator: <sqf inline>_pos # 0 atan2 _pos # 1</sqf>
____________________________________________________________________________________________
}}
 
|x1= <code>_xy = [5,3];
_degrees = (_xy [[select]] 0) [[atan2]] (_xy [[select]] 1); //59.0362</code>|= Example 1
 
|x2= Get direction from _obj1 to _obj2:<code>_vd = [[getPosASL]] _obj2 [[vectorDiff]] [[getPosASL]] _obj1;
_dir = (_vd [[select]] 0) [[atan2]] (_vd [[select]] 1); //_dir range from -180 to +180
[[if]] (_dir < 0) [[then]] {_dir = 360 + _dir}; //_dir range from 0 to 360</code>|= Example 2


|x3= Get relative direction from _obj1 to _obj2:<code>_xy = _obj1 [[worldToModel]] [[getPosASL]] _obj2;
|s1= y [[atan2]] x
_dir = (_xy [[select]] 0) [[atan2]] (_xy [[select]] 1); //_dir range from -180 to +180
[[if]] (_dir < 0) [[then]] {_dir = 360 + _dir}; //_dir range from 0 to 360</code>|= Example 3
____________________________________________________________________________________________


|p1= y: [[Number]]


|p2= x: [[Number]]


| [[atan]], [[Math Commands]] |= See also
|r1= [[Number]]


}}
|x1= <sqf>
_yx = [5,3];
_degrees = (_yx select 0) atan2 (_yx select 1); // 59.0362
</sqf>


<h3 style="display:none">Notes</h3>
|x2= Get direction from _obj1 to _obj2:
<dl class="command_description">
<sqf>
<!-- Note Section BEGIN -->
_vd = getPosASL _obj2 vectorDiff getPosASL _obj1;
<dd class="notedate">Posted on 08:00, 18 November 2009
_dir = (_vd select 0) atan2 (_vd select 1); // _dir range from -180 to +180
<dt class="note">'''[[User:KeV|KeV]]'''<dd class="note">
_dir = (_dir + 360) % 360; // _dir range from 0 to 360
To get the direction of an object from the player:  
</sqf>
<code>
_dir = (([[getPos]] _obj [[select]] 0) - ([[getPos]] [[player]] [[select]] 0)) [[atan2]] (([[getPos]] _obj [[select]] 1) - ([[getPos]] [[player]] [[select]] 1));  
//_dir will be from -180 to 180.
</code>
If positive values are needed then use:
<code>
[[if]] (_dir < 0) [[then]] {_dir = _dir + 360};
</code>
Or just use [[BIS_fnc_dirTo]] directly.
<!-- Note Section END -->
</dl>


<h3 style="display:none">Bottom Section</h3>
|x3= Get relative direction from _obj1 to _obj2:
<sqf>
_yx = _obj1 worldToModel getPosASL _obj2;
_dir = (_yx select 0) atan2 (_yx select 1); // _dir range from -180 to +180
_dir = (_dir + 360) % 360; // _dir range from 0 to 360
</sqf>


[[Category:Scripting Commands|ATAN2]]
|seealso= [[atan]] [[tan]] [[sin]] [[cos]] [[asin]] [[acos]] [[rad]] [[pi]] [[vectorCos]] [[BIS_fnc_dirTo]] [[getRelPos]] [[getRelDir]]
[[Category:Scripting Commands OFP 1.99|ATAN2]]
}}
[[Category:Scripting Commands OFP 1.96|ATAN2]]
[[Category:Scripting Commands OFP 1.46|ATAN2]]
[[Category:Scripting Commands ArmA|ATAN2]]
[[Category:Command_Group:_Math|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]

Latest revision as of 09:38, 25 March 2024

Hover & click on the images for description

Description

Description:
atan.jpg
ArcTangent of y/x. Used to determine the angle of a vector [y,x]. Result in Degrees between -180 and 180.
This command can handle x being 0, unlike when using atan, and will return 90
This command has higher precedence than the select command, therefore beware of the case below:

_pos select 0 atan2 (_pos select 1) // error (_pos select 0) atan2 (_pos select 1) // OK

Alternatively, consider using the # operator: _pos # 0 atan2 _pos # 1
Groups:
Math - Geometry

Syntax

Syntax:
y atan2 x
Parameters:
y: Number
x: Number
Return Value:
Number

Examples

Example 1:
_yx = [5,3]; _degrees = (_yx select 0) atan2 (_yx select 1); // 59.0362
Example 2:
Get direction from _obj1 to _obj2:
_vd = getPosASL _obj2 vectorDiff getPosASL _obj1; _dir = (_vd select 0) atan2 (_vd select 1); // _dir range from -180 to +180 _dir = (_dir + 360) % 360; // _dir range from 0 to 360
Example 3:
Get relative direction from _obj1 to _obj2:
_yx = _obj1 worldToModel getPosASL _obj2; _dir = (_yx select 0) atan2 (_yx select 1); // _dir range from -180 to +180 _dir = (_dir + 360) % 360; // _dir range from 0 to 360

Additional Information

See also:
atan tan sin cos asin acos rad pi vectorCos BIS_fnc_dirTo getRelPos 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