View source for LlDetectedRot

{{LSL_Function/detected|number|rot}}{{LSL_Function
|func_id=38|func_sleep=0.0|func_energy=10.0
|sort=DetectedRot
|func=llDetectedRot|return_type=rotation|p1_type=integer|p1_name=number
|func_footnote=Returns {{LSLG|ZERO_ROTATION|<0.0, 0.0, 0.0, 1.0>}} if '''number''' is not valid sensed object.
|func_desc
|return_text=that is the rotation of detected object '''number'''.
|spec
|caveats
|constants
|examples=
<lsl>//--// get compass facing of Avatar that touches this object //--//

//-- @@ = Contains code optimizations, see the following page for details
//-- wiki.secondlife.com/wiki/User:Void_Singer/Optimizations

 //-- list of compass directions starting at North, rotated clockwise
// Below did not match up with the map.... So Thaleenin Sydney changed to the new one that does.
//
//list gLstCompassPoints = [ "North", "NorthEast", "East", "SouthEast", "South", "SouthWest", "West", "NorthWest" ];
//
list gLstCompassPoints = [ "East", "NorthEast", "North", "NorthWest", "West", "SouthWest", "South", "SouthEast" ];

 //-- convert rotation to z-axis compass direction
string CompassDirection( rotation rRotBase )
{
  integer iCountCompassPoints = llGetListLength(gLstCompassPoints);
   //-- convert rotation to a direction
  vector vDirection = <0.0, 1.0, 0.0> / rRotBase;
   //-- take the direction and determine the z rotation
  float fAngle = llAtan2(vDirection.x, vDirection.y);
   //-- take the angle and find the compass point
  integer iCompassPoint = llRound(fAngle * iCountCompassPoints / TWO_PI);
   //-- convert to string
  return llList2String( gLstCompassPoints, iCompassPoint );
}

default{
  state_entry()
  {
    llSay( 0, "Touch me to get your compass facing" );
  }

  touch_start( integer vIntTouchCount )
  {
    integer vIntCounter = 0;
    do
    {
      llSay( 0,
             llDetectedName( vIntCounter )
             + " is facing "
              //-- next line gets avatar rotation and converts to compass direction
             + CompassDirection( llDetectedRot( vIntCounter ) ) );
    } while ( ++vIntCounter < vIntTouchCount );
  }
}</lsl>
|helpers
|also_functions
|also_events
|also_articles
|notes
|permission
|cat1
|cat2
|cat3
|cat4
}}