atan2: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "Category:Scripting Commands ArmA2" to "Category:Scripting Commands Arma 2")
m (Some wiki formatting)
 
(77 intermediate revisions by 4 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
<br><br>
|version3= 1.00
{{Informative | This command can handle ''y'' being 0, unlike when using [[atan]], and will return 90 }}
<br>
{{Important | Even though this command is a binary operator just like [[select]] command, it has [[SQF_syntax#Rules_of_Precedence | higher precedence]] than [[select]] command, therefore the following expression: <br><tt>_pos select 0 [[atan2]] (_pos select 1)</tt><br> will produce an error. The correct usage in this case will be: <br><tt>(_pos select 0) [[atan2]] (_pos select 1)</tt>}}|DESCRIPTION=
____________________________________________________________________________________________


| x '''atan2''' y |SYNTAX=
|game4= arma2
|version4= 1.00


|p1= x: [[Number]] |PARAMETER1=
|game5= arma2oa
|version5= 1.50


|p2= y: [[Number]] |PARAMETER2=
|game6= tkoh
|version6= 1.00


|game7= arma3
|version7= 0.50


| [[Number]]
|gr1= Math - Geometry


<br><br>[[Image:atan.jpg|200px]]|RETURNVALUE=
|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|
|x1= <code>_xy = [5,3];
This command has [[SQF Syntax#Rules of Precedence|higher precedence]] than the [[select]] command, therefore beware of the case below:
_degrees = (_xy [[select]] 0) [[atan2]] (_xy [[select]] 1); //59.0362</code>|EXAMPLE1=
<sqf notrim>
_pos select 0  atan2 (_pos select 1) // error
(_pos select 0) atan2 (_pos select 1) // OK
</sqf>


|x2= Get direction from _obj1 to _obj2:<code>_vd = [[getPosASL]] _obj2 [[vectorDiff]] [[getPosASL]] _obj1;
Alternatively, consider using the [[a hash b|#]] operator: <sqf inline>_pos # 0 atan2 _pos # 1</sqf>
_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>|EXAMPLE2=


|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>|EXAMPLE3=
____________________________________________________________________________________________


|p1= y: [[Number]]


|p2= x: [[Number]]


| [[atan]], [[tan]], [[sin]], [[cos]], [[asin]], [[acos]], [[rad]], [[pi]], [[vectorCos]], [[getPos]], [[getRelPos]], [[Math Commands]] |SEEALSO=
|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 Arma 2|{{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

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
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
Retrieved from "https://community.bistudio.com/wiki?title=atan2&oldid=363173"