Difference between revisions of "LlAtan2"
Jump to navigation
Jump to search
/Compass QA
m |
(Adding a haiku) |
||
| (6 intermediate revisions by 2 users not shown) | |||
| Line 7: | Line 7: | ||
|return_text=that is the {{wikipedia|Atan2|arctangent2}} of {{LSLP|y}}, {{LSLP|x}}. | |return_text=that is the {{wikipedia|Atan2|arctangent2}} of {{LSLP|y}}, {{LSLP|x}}. | ||
|func_footnote=Similar to the <span class="plainlinks">{{wikipedia|Inverse_trigonometric_functions|arctangent}}</span>({{LSLP|y}}/{{LSLP|x}}) except it utilizes the signs of {{LSLP|x}} & {{LSLP|y}} to determine the quadrant and avoids division by zero. <br /> | |func_footnote=Similar to the <span class="plainlinks">{{wikipedia|Inverse_trigonometric_functions|arctangent}}</span>({{LSLP|y}}/{{LSLP|x}}) except it utilizes the signs of {{LSLP|x}} & {{LSLP|y}} to determine the quadrant and avoids division by zero. <br /> | ||
If {{LSLP|x}} is zero and... | |spec= | ||
If {{LSLP|x}} is positive zero and... | |||
* {{LSLP|y}} is zero, '''zero''' is returned. | * {{LSLP|y}} is zero, '''zero''' is returned. | ||
* {{LSLP|y}} is positive, '''PI/2''' is returned. | * {{LSLP|y}} is positive, '''PI/2''' is returned. | ||
* {{LSLP|y}} is negative, '''-PI/2''' is returned. | * {{LSLP|y}} is negative, '''-PI/2''' is returned. | ||
If {{LSLP|x}} is negative zero and... | |||
* {{LSLP|y}} is positive zero, '''PI''' is returned. | |||
* {{LSLP|y}} is negative zero, '''-PI''' is returned. | |||
* {{LSLP|y}} is positive, '''PI/2''' is returned. | |||
* {{LSLP|y}} is negative, '''-PI/2''' is returned. | |||
Or | |||
<source lang="lsl2"> | |||
if((string)x != (string)0.0 && y == 0.0)//negative zero | |||
return PI * ~-2*((string)y != (string)0.0)); | |||
return ((y > 0) - (y < 0)) * PI_BY_TWO; | |||
</source> | |||
The returned value is in the range {{Interval|gte=-[[PI]]|gteh=-PI|lte=PI|center=return}}{{Interval/Footnote}}. | The returned value is in the range {{Interval|gte=-[[PI]]|gteh=-PI|lte=PI|center=return}}{{Interval/Footnote}}. | ||
|caveats | |caveats | ||
|constants | |constants | ||
|examples=< | |examples=<source lang="lsl2">default | ||
{ | { | ||
state_entry() | state_entry() | ||
| Line 28: | Line 39: | ||
llOwnerSay("The arctangent of y divided by x is " + (string)llAtan2(num1, num2)); | llOwnerSay("The arctangent of y divided by x is " + (string)llAtan2(num1, num2)); | ||
} | } | ||
}</ | }</source><source lang="lsl2">//Function with input of a vector determining the position of a target and returning | ||
//a string with the literal compass-direction of that target towards your position | //a string with the literal compass-direction of that target towards your position | ||
//by Ramana Sweetwater 2009/01, any use allowed license :-) | //by Ramana Sweetwater 2009/01, any use allowed license :-) | ||
| Line 39: | Line 50: | ||
integer index = llCeil(3.5 - (4 * llAtan2(target.y - source.y, target.x - source.x) / PI)); | integer index = llCeil(3.5 - (4 * llAtan2(target.y - source.y, target.x - source.x) / PI)); | ||
return llList2String(DIRS, index); | return llList2String(DIRS, index); | ||
}</ | }</source> | ||
[[/Compass QA]] | [[/Compass QA]] | ||
|helpers | |helpers | ||
| Line 50: | Line 61: | ||
{{LSL DefineRow||{{wikipedia|Inverse trigonometric function}}|}} | {{LSL DefineRow||{{wikipedia|Inverse trigonometric function}}|}} | ||
|notes | |notes | ||
|haiku= | |||
{{Haiku|An analog clock|passes through infinity|twice every single hour}} | |||
|cat1=Math/Trigonometry | |cat1=Math/Trigonometry | ||
|cat2 | |cat2 | ||
Latest revision as of 07:32, 15 June 2016
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: float llAtan2( float y, float x );| 0.0 | Forced Delay |
| 10.0 | Energy |
Returns a float that is the 
arctangent2 of y, x.
| • float | y | |||
| • float | x |
Similar to the arctangent(y/x) except it utilizes the signs of x & y to determine the quadrant and avoids division by zero.
Specification
If x is positive zero and...
- y is zero, zero is returned.
- y is positive, PI/2 is returned.
- y is negative, -PI/2 is returned.
If x is negative zero and...
- y is positive zero, PI is returned.
- y is negative zero, -PI is returned.
- y is positive, PI/2 is returned.
- y is negative, -PI/2 is returned.
Or
if((string)x != (string)0.0 && y == 0.0)//negative zero
return PI * ~-2*((string)y != (string)0.0));
return ((y > 0) - (y < 0)) * PI_BY_TWO;
Examples
default
{
state_entry()
{
float num1 = llFrand(100.0);
float num2 = llFrand(100.0);
llOwnerSay("y = " + (string)num1);
llOwnerSay("x = " + (string)num2);
llOwnerSay("The arctangent of y divided by x is " + (string)llAtan2(num1, num2));
}
}
//Function with input of a vector determining the position of a target and returning
//a string with the literal compass-direction of that target towards your position
//by Ramana Sweetwater 2009/01, any use allowed license :-)
//corrected by Patrick Muggins
string compass (vector target)
{
vector source = llGetPos();
list DIRS =["W","NW","N","NE","E","SE","S","SW","W"];
integer index = llCeil(3.5 - (4 * llAtan2(target.y - source.y, target.x - source.x) / PI));
return llList2String(DIRS, index);
}
See Also
Deep Notes
Footnotes
- ^ The ranges in this article are written in Interval Notation.
Signature |
|---|
function float llAtan2( float y, float x ); |
Haiku |
|---|
|
An analog clock
|