llSensorRepeat

Template:Needs Translation/LSL/de 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

SensorRepeat

llSensorRepeat

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 prim UUID
• integer	type	–	mask (AGENT, ACTIVE, PASSIVE, and/or SCRIPTED)
• float	range	–	range 0.0 to 96.0m
• float	arc	–	the max angle between the local x-axis of the prim and detectable objects, range 0.0 to 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.

See: llSensor for an excellent explanation of arc.

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).
• When a sensor event is queued, it dequeues all other sensor events in the queue.
• The script must have a sensor event, without it no_sensor will not be triggered. An empty sensor event is enough to satisfy this condition and cause no_sensor to be triggered.

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, 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>

Notes

Lag tip: Consider llVolumeDetect as a less resource intensive alternative to llSensorRepeat in many cases.

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

Deep Notes

Signature
function void llSensorRepeat( string name, key id, integer type, float range, float arc, float rate );