Difference between revisions of "LlSensorRepeat"

From Second Life Wiki
Jump to navigation Jump to search
m
m (prettify)
Line 68: Line 68:
//-------------------------------------------------------------------------------------
//-------------------------------------------------------------------------------------


// Channel
integer RESPONSE_CHANNEL = -100;
integer RESPONSE_CHANNEL = -100;
float  SCAN_RANGE      = 10.0;
float  SCAN_INTERVAL    = 0.1;
list    VISITOR_LIST;


// Variables
list VISITOR_LIST;
float SCAN_RANGE = 10.0;
float SCAN_INTERVAL = 0.1;
//Program
default
default
{
{
     state_entry ( )
     state_entry()
     {
     {
         llSensorRepeat ( "", NULL_KEY, AGENT_BY_LEGACY_NAME, SCAN_RANGE, PI, SCAN_INTERVAL );
         llSensorRepeat("", NULL_KEY, AGENT_BY_LEGACY_NAME, SCAN_RANGE, PI, SCAN_INTERVAL);
     }
     }
   
 
     sensor ( integer number_detected )
     sensor(integer number_detected)
     {
     {
         integer agent_number;
         integer agent_number;
       
 
         for ( agent_number = 0; agent_number < number_detected; agent_number ++ ) // Iterates through all Agents detected.
//      iterate through all detected agents
         for (; agent_number < number_detected; agent_number++)
         {
         {
             string this_agent_name = llDetectedName ( agent_number ); // Working Agent Name
             string this_agent_name = llDetectedName(agent_number);
             key this_agent_key = llDetectedKey ( agent_number ); // Working Agent Key
             key     this_agent_key = llDetectedKey(agent_number);
                       
             integer index           = llListFindList(VISITOR_LIST, [this_agent_name]);
             integer index = llListFindList ( VISITOR_LIST, [ this_agent_name ] );
 
           
//         if the agent is not found on the list
            if ( index == -1 )  // If the Agent is not on the list.
            if (index == ERR_GENERIC)
             {
             {
                 VISITOR_LIST = [this_agent_name] + llList2List( VISITOR_LIST, 0, 198 ); // Appends the Agent to the Visitor List
//              add her/him and make the list hold the last 200 visitors
               
                 VISITOR_LIST = [this_agent_name] + llList2List(VISITOR_LIST, 0, 198);
                llDialog ( this_agent_key, "Welcome!", ["Ok"], RESPONSE_CHANNEL );


                 llOwnerSay ( this_agent_name );
                llDialog(this_agent_key, "Welcome!", ["Ok"], RESPONSE_CHANNEL);
               
 
                 llOwnerSay(this_agent_name);
             }
             }
           
//         else agent is already on the list
            else // If the Agent is already on the list.
            {
            }
         }
         }
       
 
    }
   
    no_sensor (  )
    {
     }
     }
}
}
</lsl>
</lsl>
|helpers
|helpers

Revision as of 12:27, 12 December 2013

Summary

Function: llSensorRepeat( string name, key id, integer type, float range, float arc, float rate );
0.0 Forced Delay
10.0 Energy

Performs a single scan for name and id with type within range meters and arc radians of forward vector and repeats every rate seconds. It does not perform the first scan until rate seconds have passed.

• string name – Object or avatar name!
• key id – group, avatar or object UUID
• integer type – mask (AGENT_BY_LEGACY_NAME, AGENT_BY_USERNAME, ACTIVE, PASSIVE, and/or SCRIPTED)
• float range – range in meters, [0.0, 96.0]
• float arc – the max angle between the local x-axis of the prim and detectable objects, range [0.0, PI]
• float rate – How often a sensor/no_sensor will be queued.

If name, id, and/or type are empty or 0, they are ignored.
If id is an invalid key or NULL_KEY it is treated as empty.
Depending upon which AGENT* flag is used determines the format requirements for name

See: llSensor for an excellent explanation of arc.

type Flag Mask Description (llDetectedType()) Description (llSensor() and llSensorRepeat() mask)
AGENT_BY_LEGACY_NAME 0x1 Agents This is used to find agents by legacy name.
AGENT 0x1 Agents This is also used to find agents by legacy name, and is functionally identical to AGENT_BY_LEGACY_NAME
AGENT_BY_USERNAME 0x10 Reserved This is used to find agents by username.
ACTIVE 0x2 Physical tasks. (Physical objects & agents) Physical objects that are moving or objects containing an active script. Thus, it is using SL server resources now.
PASSIVE 0x4 Non-physical objects. Non-scripted or script is inactive and non-physical or, if physical, not moving. Thus, it is not using SL server resources now.
SCRIPTED 0x8 Objects containing any active script. Objects that has any script, which is doing anything in simulator just now.
DAMAGEABLE 0x20 Objects & agents that are able to process damage. Filter for objects in world that have a script with on_damage or a final_damage event (able to process damage)
llDetectedType() Scripted Not Scripted Agent Standing Agent Sitting
Physical Movement 10 (ACTIVE|SCRIPTED) 2 (ACTIVE) 3 (ACTIVE|AGENT) 3 (ACTIVE|AGENT)
Non-Physical 12 (PASSIVE|SCRIPTED) 4 (PASSIVE) 1 (AGENT) 5 (PASSIVE|AGENT)
Float Constants Arc
PI_BY_TWO A hemisphere scan
PI A full sphere scan

Caveats

  • When searching for an avatar but not by name, it doesn't matter which AGENT flag is used.
  • The repeat of the sensor event is adversely affected by time dilation (lag).
  • Sensors placed in attachments will use the direction the avatar is facing as their forward vector. In mouselook, this means that it will be wherever the avatar is looking, while out of mouselook, this means whichever way the avatar is pointing. This does not include where the avatar's head is pointing, or what animation the avatar is doing, just the direction the avatar would move in if you walked forward. This is the case, regardless of where the object is attached.
  • Only the most recent sensor event is queued. Previous sensor events are replaced.
  • A repeating sensor does not persist across a state change.
  • llSensorRepeat can occasionally detect outside of it's specified range every few cycles when used near sim borders. llSensor in a timer does not.

Examples

<lsl>// Written by Steamy Latte. // Scans every 30 seconds for visitors within 10 meters. // Reports new visitors to object owner when she is in range.


string AllAgents; string OwnerName;

default { 

   state_entry()
   {
       // arc=PI is a sphere, you could look more narrowly in the direction object is facing with PI/2, PI/4 etc.
       // don't repeat this too often to avoid lag.
       llSensorRepeat("", "", AGENT_BY_LEGACY_NAME, 10.0, PI, 30.0);
   }
   sensor(integer num_detected)
   {
       string thisAgent = "";
       integer agentNum;
       for (agentNum=0; agentNum<num_detected; agentNum++)
       {
           key thisKey = llDetectedKey(agentNum);
           string thisAgent = llDetectedName(agentNum);
           if (thisKey == llGetOwner())
           {
               if (AllAgents != "")
               {
                   llOwnerSay("We've had the following visitors:" + AllAgents);
                   AllAgents = "";
               }
           }
           else if (llSubStringIndex(AllAgents+"\n", "\n"+thisAgent+"\n") < 0)
           {
               AllAgents = AllAgents + "\n" + thisAgent;
           }
       }
   }

}</lsl>

<lsl> // Written by Evans Love. // (Limited to most recent 200 names by Void Singer to prevent eventual Stack/Heap Collision + clean up) // Continuously scans for visitors within 10 meters and reports new visitors to object owner. //-------------------------------------------------------------------------------------

integer RESPONSE_CHANNEL = -100; float SCAN_RANGE = 10.0; float SCAN_INTERVAL = 0.1; list VISITOR_LIST;

default { 

   state_entry()
   {
       llSensorRepeat("", NULL_KEY, AGENT_BY_LEGACY_NAME, SCAN_RANGE, PI, SCAN_INTERVAL);
   }

   sensor(integer number_detected)
   {
       integer agent_number;

// iterate through all detected agents 

       for (; agent_number < number_detected; agent_number++)
       {
           string  this_agent_name = llDetectedName(agent_number);
           key     this_agent_key  = llDetectedKey(agent_number);
           integer index           = llListFindList(VISITOR_LIST, [this_agent_name]);

// if the agent is not found on the list 

           if (index == ERR_GENERIC)
           {

// add her/him and make the list hold the last 200 visitors 

               VISITOR_LIST = [this_agent_name] + llList2List(VISITOR_LIST, 0, 198);

               llDialog(this_agent_key, "Welcome!", ["Ok"], RESPONSE_CHANNEL);

               llOwnerSay(this_agent_name);
           }

// else agent is already on the list 

       }

   }

}

</lsl>

Notes

KBcaution.png Important: You might want to use llGetAgentList instead of using sensors to get a list of all avatars within the same parcel or region.

See Also

Events

•  sensor – Triggered when a sensor detects something
•  no_sensor – Triggered when a sensor detects nothing

Functions

•  llSensor – Runs a sensor once
•  llSensorRemove – Stops the llSensorRepeat timer
•  llOverMyLand – What happens over owners land

Deep Notes

Footnotes

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

Signature

function void llSensorRepeat( string name, key id, integer type, float range, float arc, float rate );
Retrieved from "https://wiki.secondlife.com/w/index.php?title=LlSensorRepeat&oldid=1184999"