Difference between revisions of "LlListenControl"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
m (<lsl> tag to <source>) |
|||
| (14 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
{{LSL_Function | {{LSL_Function | ||
|inject-2={{LSL Function/handle|handle|listen|control=*}} | |||
{{LSL Function/boolean|active|td=activates|fd=deactivates|default=true}} | |||
|func_id=26|func_sleep=0.0|func_energy=10.0 | |func_id=26|func_sleep=0.0|func_energy=10.0 | ||
|func=llListenControl|p1_type=integer|p1_name= | |func=llListenControl | ||
|p1_type=integer|p1_subtype=handle|p1_name=handle | |||
|p2_type=integer|p2_subtype=boolean|p2_name=active | |||
|func_footnote | |func_footnote | ||
|func_desc= | |func_desc=Makes [[listen]] event callback {{LSLP|handle}} active or inactive | ||
|return_text | |return_text | ||
|spec | |spec | ||
|caveats | |caveats=*On [[state]] change or [[llResetScript|script reset]] all listens are removed automaticaly. | ||
|constants | |constants | ||
|examples | |examples=a small example of an on and off switchable listen by use of llListenControl() | ||
<source lang="lsl2"> | |||
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); | |||
} | |||
} | |||
</source> | |||
|helpers | |helpers | ||
|also_functions= | |also_functions={{LSL DefineRow||[[llListen]]}} | ||
{{LSL DefineRow||[[llListenRemove]]}} | |||
|also_events= | |also_events={{LSL DefineRow||[[listen]]}} | ||
|also_tests | |also_tests | ||
|also_articles | |also_articles | ||
| Line 18: | Line 57: | ||
|permission | |permission | ||
|negative_index | |negative_index | ||
|cat1=Communications | |cat1=Communications | ||
|cat2=Chat | |cat2=Chat | ||
Revision as of 12:13, 22 January 2015
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llListenControl( integer handle, integer active );| 26 | Function ID |
| 0.0 | Forced Delay |
| 10.0 | Energy |
Makes listen event callback handle active or inactive
| • integer | handle | – | handle to control listen event | |
| • integer | active | – | TRUE (default) activates, FALSE deactivates |
Caveats
- On state change or script reset all listens are removed automaticaly.
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
Deep Notes
Search JIRA for related Issues
Signature |
|---|
function void llListenControl( integer handle, integer active ); |