View source for LlSensorRepeat

{{LSL_Function/uuid|id}}{{#vardefine:constants_nb|{{LSL Constants/Sensing|type}}}}{{LSL_Function
|func=llSensorRepeat
|sort=SensorRepeat
|func_id=29|func_sleep=0.0|func_energy=10.0
|p1_type=string|p1_name=name|p1_desc=Object or avatar name
|p2_type=key|p2_name=id
|p3_type=integer|p3_name=type|p3_desc=mask ({{#var:AGENT}}, {{#var:ACTIVE}}, {{#var:PASSIVE}}, and/or {{#var:SCRIPTED}})|p3_hover=mask (AGENT, ACTIVE, PASSIVE, and/or SCRIPTED)
|p4_type=float|p4_name=range|p4_desc=range 0.0 to 96.0m
|p5_type=float|p5_name=arc|p5_desc=the max angle between the local x-axis of the prim and detectable objects, range 0.0 to {{#var:PI}}|p5_hover=the max angle between the local x-axis of the prim and detectable objects, range 0.0 to PI
|p6_type=float|p6_name=rate|p6_desc=How often a [[sensor]]/[[no_sensor]] will be queued.
|func_footnote=If '''name''', '''id''', and/or '''type''' are empty or 0, they are ignored.<br/>If '''id''' is an invalid key or [[NULL_KEY]] it is treated as empty.

See: [http://www.lslwiki.net/lslwiki/wakka.php?wakka=llSensor llSensor] for an excellent explanation of '''arc'''.
|func_desc=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.
|return_text
|spec
|caveats=*The repeat of the sensor event is adversely affected by [[llGetRegionTimeDilation|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>
|helpers
|also_functions=
{{LSL DefineRow||[[llSensor]]| Runs a sensor once}}
{{LSL DefineRow||[[llSensorRemove]]| Stops the llSensorRepeat timer}}
|also_events=
{{LSL DefineRow||[[sensor]]|Triggered when a sensor detects something}}
{{LSL DefineRow||[[no_sensor]]|Triggered when a sensor detects nothing}}
|also_articles
|notes=[http://rpgstats.com/wiki/index.php?title=Lag Lag tip]: Consider [[llVolumeDetect]] as a less resource intensive alternative to llSensorRepeat in many cases.
|cat1=Sensor
|cat2=Detected
|cat3
|cat4
}}