You are currently not logged in! Enter your authentication credentials below to log in. You need to have cookies enabled to log in.
This shows you the differences between two versions of the page.
|
functions:llasin [2014-05-15 03:38 SLT] sei created |
functions:llasin [2015-09-23 14:34 SLT] (current) sei Style |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | $nav | ||
| ===== Function: llAsin ===== | ===== Function: llAsin ===== | ||
| Line 5: | Line 6: | ||
| </code> | </code> | ||
| - | Return the inverse sine of the argument, in radians. The inverse sine is the angle whose sine is the given argument. | + | Return the inverse sine of the argument, in radians. The inverse sine (also known as arcsine) is the angle whose sine is the given argument. |
| ===== Parameters ===== | ===== Parameters ===== | ||
| Line 12: | Line 13: | ||
| Number whose inverse sine is to be found. | Number whose inverse sine is to be found. | ||
| - | ===== Result ===== | + | ===== Return value ===== |
| - | [[types/Float]] number with the inverse sine of the argument. | + | $lty[Float] number with the angle in radians that is the inverse sine of the argument. |
| ===== Notes ===== | ===== Notes ===== | ||
| - | * The range of **arg** must be between -1 and 1, because the sine of any angle can't be outside that range. | + | * The range of $prm[arg] must be between -1 and 1, because the sine of any angle can't be outside that range. |
| - | * The result is always between -[[constants/PI_BY_TWO]] and **PI_BY_TWO**, or **NaN** (Not a Number) if the argument is out of range. | + | * The result is always between -$lct[PI_BY_TWO] and $ct[PI_BY_TWO, or $nan if the argument is out of the valid range. |
| ===== Short examples ===== | ===== Short examples ===== | ||
| Line 29: | Line 30: | ||
| angle = llAsin(-1); // Sets angle to -PI_BY_TWO, because the sine of -PI_BY_TWO is -1. | angle = llAsin(-1); // Sets angle to -PI_BY_TWO, because the sine of -PI_BY_TWO is -1. | ||
| angle = llAsin(0.67); // Sets angle to approximately 0.734209 (the sine of that is 0.67) | angle = llAsin(0.67); // Sets angle to approximately 0.734209 (the sine of that is 0.67) | ||
| - | angle = llAsin(2); // Sets angle to NaN (Not a Number) because there's no number whose sine is 2. | + | |
| + | angle = llAsin(2); // Under Mono, sets angle to NaN (Not a Number) | ||
| + | // because there's no number whose sine is 2. | ||
| + | // Crashes with a math error under LSO. | ||
| </code> | </code> | ||
| ===== Complete examples ===== | ===== Complete examples ===== | ||
| - | The following example will output the pitch, roll and heading angles of a prim: | + | The following example will output the pitch and roll angles of a prim, in degrees: |
| <file lsl2 llAsin-example.lsl> | <file lsl2 llAsin-example.lsl> | ||
| Line 42: | Line 46: | ||
| { | { | ||
| rotation rot = llGetLocalRot(); | rotation rot = llGetLocalRot(); | ||
| - | vector fwd = <1,0,0>*rot; | + | vector forward = <1,0,0>*rot; |
| - | vector left = <0,1,0>*rot; | + | vector right = <0,-1,0>*rot; |
| - | float pitch = llAsin(fwd.z) * RAD_TO_DEG; | + | float pitch = llAsin(forward.z); |
| - | float roll = llAsin(left.z) * RAD_TO_DEG; | + | float roll = llAsin(right.z); |
| - | float heading = llAtan2(fwd.y, fwd.x) * RAD_TO_DEG; | + | |
| - | llOwnerSay("Pitch=" + (string)pitch + "; roll=" + (string)roll + "; heading=" + (string)heading); | + | llOwnerSay("Pitch=" + (string)(pitch * RAD_TO_DEG) + "°; roll=" + (string)(roll * RAD_TO_DEG) + "°"); |
| } | } | ||
| } | } | ||
| Line 56: | Line 59: | ||
| ===== See also ===== | ===== See also ===== | ||
| - | === Related trigonometric functions === | + | * $lfn[llSin] calculates the sine of the argument. |
| - | * [[llSin]] | + | * $lfn[llAcos] calculates the inverse cosine of the argument. |
| - | + | * $lfn[llCos] calculates the cosine of the argument. | |
| - | === Other trigonometric functions === | + | * $lfn[llAtan2] calculates the angle of a 2D vector. |
| - | * [[llAcos]] | + | * $lfn[llTan] calculates the tangent of the argument. |
| - | * [[llCos]] | + | * Other $lfn[math/] functions |
| - | * [[llAtan2]] | + | |
| - | * [[llTan]] | + | |