Difference between revisions of "LlListenControl"

From Second Life Wiki
Jump to navigation Jump to search
m
m (<lsl> tag to <source>)
(One intermediate revision by one other user not shown)
Line 4: Line 4:
|func_id=26|func_sleep=0.0|func_energy=10.0
|func_id=26|func_sleep=0.0|func_energy=10.0
|func=llListenControl
|func=llListenControl
|p1_type=integer|p2_subtype=handle|p1_name=handle
|p1_type=integer|p1_subtype=handle|p1_name=handle
|p2_type=integer|p2_subtype=boolean|p2_name=active
|p2_type=integer|p2_subtype=boolean|p2_name=active
|func_footnote
|func_footnote
Line 13: Line 13:
|constants
|constants
|examples=a small example of an on and off switchable listen by use of llListenControl()
|examples=a small example of an on and off switchable listen by use of llListenControl()
<LSL>
<source lang="lsl2">
integer handle;
integer handle;
integer toggle;
integer toggle;
Line 47: Line 47:
     }
     }
}
}
</LSL>
</source>
|helpers
|helpers
|also_functions={{LSL DefineRow||[[llListen]]}}
|also_functions={{LSL DefineRow||[[llListen]]}}

Revision as of 12:13, 22 January 2015

Summary

Function: llListenControl( integer handle, integer active );

Makes listen event callback handle active or inactive

• integer handle handle to control listen event
• integer active TRUE (default) activates, FALSE deactivates

Caveats

All Issues ~ Search JIRA for related Bugs

Examples

a small example of an on and off switchable listen by use of llListenControl()

integer handle;
integer toggle;
default
{
    state_entry()
    {
        handle = llListen(5, "", NULL_KEY, "");    // Establish a listener to listen to anything on channel 5 ...
        llListenControl(handle, FALSE);            // ... but make the listener inactive for now
        llSetText("not listening", <0.0,0.0,0.0>, 1.0);
    }

    touch_start(integer total_number)
    {
        toggle = !toggle;
        llListenControl(handle, toggle);           // Make the listener active or inactive as required

        if(toggle)
        {
            llSay(0, "now listening on channel 5");
            llSetText("listening on ch 5", <1.0,0.0,0.0>, 1.0);
        }
        else
        {
            llSay(0, "not listening any more");
            llSetText("not listening", <0.0,0.0,0.0>, 1.0);
        }     
    }
    
    listen(integer channel, string name, key id, string message)
    {
        llSay(0, name + " just said " + message);
    }
}

See Also

Events

•  listen

Functions

•  llListen
•  llListenRemove

Deep Notes

Search JIRA for related Issues

Signature

function void llListenControl( integer handle, integer active );