Difference between revisions of "LlAcos"

From Second Life Wiki
Jump to navigation Jump to search
m (Replaced <source> with <syntaxhighlight>)
(same caveats as for llPow/etc. with out of range parameters)
 
Line 6: Line 6:
|p1_hover=must fall in the range {{Interval/Text2|gte=-1.0|center=val|lte=1.0}}
|p1_hover=must fall in the range {{Interval/Text2|gte=-1.0|center=val|lte=1.0}}
|return_text=that is the arccosine in radians of {{LSLP|val}}
|return_text=that is the arccosine in radians of {{LSLP|val}}
|func_footnote=The returned value is in the range {{Interval|gte=0.0|center=return|lte=[[PI]]|lteh=PI}}{{Interval/Footnote}}
|func_footnote=The returned value is in the range {{Interval|gte=0.0|center=return|lte=[[PI]]|lteh=PI}}{{Interval/Footnote}}, or {{abbr|NaN|not a number}} signifying a complex result when the parameter is out of range.
|spec
|spec
|caveats
|caveats=*Triggers a {{LSLGC|Error/Math|Math Error}} for complex results if not compiled in Mono.
|examples=
|examples=
<syntaxhighlight lang="lsl2">
<syntaxhighlight lang="lsl2">

Latest revision as of 11:24, 21 May 2024

Summary

Function: float llAcos( float val );
0.0 Forced Delay
10.0 Energy

Returns a float that is the arccosine in radians of val

• float val must fall in the range [-1.0, 1.0]

The returned value is in the range [0.0, PI][1], or NaN signifying a complex result when the parameter is out of range.

Caveats

  • Triggers a Math Error for complex results if not compiled in Mono.

Examples

//  This example exercises the full valid range of argument from -1.0 to +1.0

default
{
    touch_start(integer num_detected)
    {
        float random = llFrand(2.0) - 1.0;

        llOwnerSay("The arccosine of " + (string)random + " is " + (string)llAcos(random));
    }
}
//An example for the Law of Cosines to calculate any angle of a triangle from 3 known side lengths.

default
{
    touch_start(integer num_detected)
    {        
        vector t=< llFrand(9.0)+1.0 , llFrand(9.0)+1.0 , llFrand(9.0)+1.0 >; //the 3 values of this vector are used to set the lengths of 3 sides of a triangle.

        float anglexy=llAcos( (t.x*t.x+t.y*t.y-(t.z*t.z)) / ( 2*t.x*t.y) ) //Law Of Cosines

        llOwnerSay("Using the Law Of Cosines, the angle of a triangle between side a="+(string)t.x+"and side b="+(string)t.y+"is = "+(string)anglexy+" radians="+(string)(anglexy*RAD_TO_DEG)+"° and that angle is not on side c="+(string)t.z);
    }
}

See Also

Functions

• llSin llAsin sine & inverse Sine
• llCos cosine
• llTan llAtan2 tangent & inverse tangent

Articles

•  "Wikipedia logo"Inverse trigonometric function

Deep Notes

Footnotes

  1. ^ The ranges in this article are written in Interval Notation.

Signature

function float llAcos( float val );