Difference between revisions of "LlAsin"

From Second Life Wiki
Jump to navigation Jump to search
 
(same caveats as for llPow/etc. with out of range parameters)
 
(22 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{LSLFunctionAll|func_id=173|func_sleep=0.0|func_energy=10.0|func=llAsin|return_type=float|p1_type=float|p1_name=val|func_footnote=Returns the arcsine in radians of val|return_text|spec|caveats|examples|helpers|related|also|notes}}[[Category:LSL_Functions]][[Category:LSL_Stub]]
{{LSL Function
|func_id=173
|func_sleep=0.0
|func_energy=10.0
|func=llAsin
|sort=Asin
|return_type=float
|p1_type=float|p1_name=val|p1_desc=must fall in the range {{Interval|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 arcsine in [[radians]] of {{LSLP|val}}
|func_footnote=The returned value is in the range {{Interval|gte=-[[PI_BY_TWO]]|gteh=-PI_BY_TWO|center=val|lte=PI_BY_TWO}}{{Interval/Footnote}}, or {{abbr|NaN|not a number}} signifying a complex result when the parameter is out of range.
|spec|caveats=*Triggers a {{LSLGC|Error/Math|Math Error}} for complex results if not compiled in Mono.
|examples=<source lang="lsl2">// Touch the object with this script in it to see the arcsine of random numbers!
default
{
    touch_start(integer num)
    {
        float r = llFrand(2) - 1.0;
        llOwnerSay("The arcsine of " + (string)r + " is " + (string)llAsin(r));
    }
}</source>
|helpers|related
|also_functions=
{{LSL DefineRow|[[llSin]]||sine}}
{{LSL DefineRow|[[llCos]]|[[llAcos]]|cosine & inverse cosine}}
{{LSL DefineRow|[[llTan]]|[[llAtan2]]|tangent & inverse tangent}}
|also_articles={{LSL DefineRow||{{wikipedia|Inverse trigonometric function}}|}}
|notes
|cat1=Math/Trigonometry
|cat2
|cat3
|cat4
}}

Latest revision as of 11:25, 21 May 2024

Summary

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

Returns a float that is the arcsine in radians of val

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

The returned value is in the range [-PI_BY_TWO, PI_BY_TWO][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

// Touch the object with this script in it to see the arcsine of random numbers!
default
{
    touch_start(integer num)
    {
        float r = llFrand(2) - 1.0;
        llOwnerSay("The arcsine of " + (string)r + " is " + (string)llAsin(r));
    }
}

See Also

Functions

• llSin sine
• llCos llAcos cosine & inverse 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 llAsin( float val );