llRot2Angle

Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

Rot2Angle

llRot2Angle

Summary

Function: float llRot2Angle( rotation rot );

0.0	Forced Delay
10.0	Energy

Returns a float that is the rotation angle represented by rot

• rotation

rot

Use in conjunction with llRot2Axis.
To undo use llAxisAngle2Rot.

Caveats

This always returns a positive angle <= PI radians, that is, it is the unsigned minimum angle. A rotation of 3/2 PI radians (270 degrees) will return an angle of PI / 2 radians, not -PI / 2.

Examples

See Also

Functions

•	llAxisAngle2Rot
•	llRot2Axis
•	llRot2Up
•	llRot2Fwd
•	llRot2Left
•	llAngleBetween	–	Similar functionality.

Deep Notes

Reference Implementation

<lsl>float Rot2Angle(rotation a) {

   return 2.0 * llAcos(llSqrt((a.s * a.s) / (a.x * a.x + a.y * a.y + a.z * a.z + a.s * a.s));

}</lsl>

<lsl>float Rot2Angle(rotation r)//more complex implementation but more accurate, and reasonably fast. {

   float s2 = r.s * r.s; // square of the s-element
   float v2 = r.x * r.x + r.y * r.y + r.z * r.z; // sum of the squares of the v-elements

   if (s2 < v2) // compare the s-component to the v-component
       return 2.0 * llAcos(llSqrt(s2 / (s2 + v2))); // use arccos if the v-component is dominant
   else if (v2) // make sure the v-component is non-zero
       return 2.0 * llAsin(llSqrt(v2 / (s2 + v2))); // use arcsin if the s-component is dominant

   return 0.0; // argument is scaled too small to be meaningful, or it is a zero rotation, so return zero

}//Written by Moon Metty & Miranda Umino. Minor optimizations by Strife Onizuka</lsl>

Signature
function float llRot2Angle( rotation rot );