Second Life Wiki - User contributions [en]

LlListenRemove

2007-07-06T02:48:03Z

Placid Kidd:

{{LSL_Function
|func_id=27|func_sleep=0.0|func_energy=10.0
|func=llListenRemove|p1_type=integer|p1_name=number
|func_footnote
|func_desc=Removes listen event callback '''number'''
|return_text
|spec
|caveats=*On [[state]] change or script reset all listens are removed.
**A state change can be used as a shortcut to releasing all listens in the script.
|constants
|examples=<pre>
integer olf;
default
{
//Repeats one line of text then stops listening
state_entry()
{
olf=llListen(0,"",llGetOwner(),"");
}
listen(integer channel, string name, key id, string message)
{
llOwnerSay(message);
llListenRemove(olf);
}
}
</pre>
|helpers
|also_functions={{LSL DefineRow||[[llListen]]}}
{{LSL DefineRow||[[llListenControl]]}}
|also_events={{LSL DefineRow|[[listen]]|}}
|also_tests
|also_articles
|notes
|permission
|negative_index
|sort=ListenRemove
|cat1=Communications
|cat2=Chat
|cat3
|cat4
}}

LlListenRemove

2007-07-06T02:47:26Z

Placid Kidd: less spammy

{{LSL_Function
|func_id=27|func_sleep=0.0|func_energy=10.0
|func=llListenRemove|p1_type=integer|p1_name=number
|func_footnote
|func_desc=Removes listen event callback '''number'''
|return_text
|spec
|caveats=*On [[state]] change or script reset all listens are removed.
**A state change can be used as a shortcut to releasing listens.
|constants
|examples=<pre>
integer olf;
default
{
//Repeats one line of text then stops listening
state_entry()
{
olf=llListen(0,"",llGetOwner(),"");
}
listen(integer channel, string name, key id, string message)
{
llOwnerSay(message);
llListenRemove(olf);
}
}
</pre>
|helpers
|also_functions={{LSL DefineRow||[[llListen]]}}
{{LSL DefineRow||[[llListenControl]]}}
|also_events={{LSL DefineRow|[[listen]]|}}
|also_tests
|also_articles
|notes
|permission
|negative_index
|sort=ListenRemove
|cat1=Communications
|cat2=Chat
|cat3
|cat4
}}

LlSetLinkPrimitiveParams

2007-07-06T02:44:32Z

Placid Kidd: comment on lack of llGetLinkPrimitiveParams

{{LSL Function/link|linknumber}}{{LSL Function
|func_id=328|func_sleep=0.2|func_energy=10.0
|func=llSetLinkPrimitiveParams|sort=SetLinkPrimitiveParams
|p1_type=integer|p1_name=linknumber
|p2_type=list|p2_name=rules
|func_desc=Set primitive parameters for '''linknumber''' based on '''rules'''.
|spec
|caveats=* Applying an operation to [[LINK_SET]] is applied first to the root prim, then to each child prim.
*There is currently no corresponding [[llGetLinkPrimitiveParams]].
**The only way to get many parameters from linked prims is to put a separate script in each child and use [[llMessageLinked|linked messages]].
|constants={{LSL Constants/PrimitiveParams|set|remote=true}}
|examples
|helpers
|also_functions=
{{LSL DefineRow||[[llSetPrimitiveParams]]|Set many primitive parameters}}
{{LSL DefineRow||[[llGetPrimitiveParams]]|Get many primitive parameters}}
{{LSL DefineRow||[[llSetLinkAlpha]]|}}
{{LSL DefineRow||[[llSetLinkColor]]|}}
{{LSL DefineRow||[[llSetLinkTexture]]|}}
|also_tests
|also_events
|also_articles
|notes
|cat1=Prim
|cat2=Movement
|cat3=Status
|cat4=Texture
|cat5=Object
|cat6
}}

LlMoveToTarget

2007-07-06T02:38:47Z

Placid Kidd: typo

{{LSL Function/damping|tau}}{{LSL_Function
|func_id=70|func_sleep=0.0|func_energy=10.0
|func=llMoveToTarget
|p1_type=vector|p1_name=target|p1_desc=[[Viewer coordinate frames#Region|region]] position
|p2_type=float|p2_name=tau
|func_footnote=To stop the object from maintaining the '''target''' positions use {{LSLG|llStopMoveToTarget}} 
To change the rotation in the same manner use {{LSLG|llLookAt}} or {{LSLG|llRotLookAt}}.
|func_desc=Critically damp to '''target''' in '''tau''' seconds (if the script is physical)
|return_text
|spec
|caveats
|constants
|examples=Drop this script in a prim to have it follow the prim owner.
<pre>
default
{
state_entry()
{
vector pos = llGetPos();
llSetStatus(STATUS_PHYSICS, TRUE);
// Little pause to allow server to make potentially large linked object physical.
llSleep(0.1);
llMoveToTarget(pos,0.4);
// Look for owner within 20 metres in 360 degree arc every 1 seconds.
llSensorRepeat("", llGetOwner(), AGENT, 20.0, PI,1.0);
}
sensor(integer total_number)
{
// Get position of detected owner
vector pos = llDetectedPos(0);
// Offset back one metre in X and up one metre in Z based on world coordinates.
// Offset relative to owner is possible but beyond the scope of this example.
vector offset =<-1,0,1>;
pos+=offset;
llMoveToTarget(pos,0.4);
}
}
</pre>
|helpers
|also_functions=*{{LSLG|llStopMoveToTarget}}
*{{LSLG|llLookAt}}
*{{LSLG|llRotLookAt}}
*{{LSLG|llTarget}}
|also_tests
|also_events
|also_articles
|notes
|cat1
|cat2=Physics
|cat3=Movement
|cat4=Target
|cat5
|cat6
}}

LlMoveToTarget

2007-07-06T02:38:25Z

Placid Kidd: add intro for example

{{LSL Function/damping|tau}}{{LSL_Function
|func_id=70|func_sleep=0.0|func_energy=10.0
|func=llMoveToTarget
|p1_type=vector|p1_name=target|p1_desc=[[Viewer coordinate frames#Region|region]] position
|p2_type=float|p2_name=tau
|func_footnote=To stop the object from maintaining the '''target''' positions use {{LSLG|llStopMoveToTarget}} 
To change the rotation in the same manner use {{LSLG|llLookAt}} or {{LSLG|llRotLookAt}}.
|func_desc=Critically damp to '''target''' in '''tau''' seconds (if the script is physical)
|return_text
|spec
|caveats
|constants
|examples=Drop this script in a prim to have to it follow the prim owner.
<pre>
default
{
state_entry()
{
vector pos = llGetPos();
llSetStatus(STATUS_PHYSICS, TRUE);
// Little pause to allow server to make potentially large linked object physical.
llSleep(0.1);
llMoveToTarget(pos,0.4);
// Look for owner within 20 metres in 360 degree arc every 1 seconds.
llSensorRepeat("", llGetOwner(), AGENT, 20.0, PI,1.0);
}
sensor(integer total_number)
{
// Get position of detected owner
vector pos = llDetectedPos(0);
// Offset back one metre in X and up one metre in Z based on world coordinates.
// Offset relative to owner is possible but beyond the scope of this example.
vector offset =<-1,0,1>;
pos+=offset;
llMoveToTarget(pos,0.4);
}
}
</pre>
|helpers
|also_functions=*{{LSLG|llStopMoveToTarget}}
*{{LSLG|llLookAt}}
*{{LSLG|llRotLookAt}}
*{{LSLG|llTarget}}
|also_tests
|also_events
|also_articles
|notes
|cat1
|cat2=Physics
|cat3=Movement
|cat4=Target
|cat5
|cat6
}}

LlMoveToTarget

2007-07-06T02:35:52Z

Placid Kidd: replace fairly useless example

{{LSL Function/damping|tau}}{{LSL_Function
|func_id=70|func_sleep=0.0|func_energy=10.0
|func=llMoveToTarget
|p1_type=vector|p1_name=target|p1_desc=[[Viewer coordinate frames#Region|region]] position
|p2_type=float|p2_name=tau
|func_footnote=To stop the object from maintaining the '''target''' positions use {{LSLG|llStopMoveToTarget}} 
To change the rotation in the same manner use {{LSLG|llLookAt}} or {{LSLG|llRotLookAt}}.
|func_desc=Critically damp to '''target''' in '''tau''' seconds (if the script is physical)
|return_text
|spec
|caveats
|constants
|examples=<pre>
default
{
state_entry()
{
vector pos = llGetPos();
llSetStatus(STATUS_PHYSICS, TRUE);
// Little pause to allow server to make potentially large linked object physical.
llSleep(0.1);
llMoveToTarget(pos,0.4);
// Look for owner within 20 metres in 360 degree arc every 1 seconds.
llSensorRepeat("", llGetOwner(), AGENT, 20.0, PI,1.0);
}
sensor(integer total_number)
{
// Get position of detected owner
vector pos = llDetectedPos(0);
// Offset back one metre in X and up one metre in Z based on world coordinates.
// Offset relative to owner is possible but beyond the scope of this example.
vector offset =<-1,0,1>;
pos+=offset;
llMoveToTarget(pos,0.4);
}
}
</pre>
|helpers
|also_functions=*{{LSLG|llStopMoveToTarget}}
*{{LSLG|llLookAt}}
*{{LSLG|llRotLookAt}}
*{{LSLG|llTarget}}
|also_tests
|also_events
|also_articles
|notes
|cat1
|cat2=Physics
|cat3=Movement
|cat4=Target
|cat5
|cat6
}}

Follower script

2007-07-06T02:32:11Z

Placid Kidd: remove junk about follow distance because it is entirely incorrect

This script is based on an extract from the Batman Follower v1.2.

<pre>
default
{
state_entry()
{
vector pos = llGetPos();
llSetStatus(STATUS_PHYSICS, TRUE);
// Little pause to allow server to make potentially large linked object physical.
llSleep(0.1);
llMoveToTarget(pos,0.4);
// Look for owner within 20 metres in 360 degree arc every 1 seconds.
llSensorRepeat("", llGetOwner(), AGENT, 20.0, PI,1.0);
}
sensor(integer total_number)
{
// Get position of detected owner
vector pos = llDetectedPos(0);
// Offset back one metre in X and up one metre in Z based on world coordinates.
// Offset relative to owner is possible but beyond the scope of this example.
vector offset =<-1,0,1>;
pos+=offset;
llMoveToTarget(pos,0.4);
}
}
</pre>

{{LSLC|Library|Follower}}

Follower script

2007-07-06T02:27:23Z

Placid Kidd: spell out llSensorRepeat parameters and more comments

This script was extracted from the Batman Follower v1.2, but the following distance was changed from .3 m to .1 m.

<pre>
default
{
state_entry()
{
vector pos = llGetPos();
llSetStatus(STATUS_PHYSICS, TRUE);
// Little pause to allow server to make potentially large linked object physical.
llSleep(0.1);
llMoveToTarget(pos,0.2);
// Look for owner within 20 metres in 360 degree arc every 1 seconds.
llSensorRepeat("", llGetOwner(), AGENT, 20.0, PI,1.0);
}
sensor(integer total_number)
{
// Get position of detected owner
vector pos = llDetectedPos(0);
// Offset back one metre in X and up one metre in Z based on world coordinates.
// Offset relative to owner is possible but beyond the scope of this example.
vector offset =<-1,0,1>;
pos+=offset;
llMoveToTarget(pos,0.2);
}
}
</pre>

{{LSLC|Library|Follower}}

Follower script

2007-07-06T02:17:41Z

Placid Kidd: remove entirely incorrect description of llMoveToTarget parameters

This script was extracted from the Batman Follower v1.2, but the following distance was changed from .3 m to .1 m.

<pre>
default
{
state_entry()
{
vector pos = llGetPos();
llSetStatus(STATUS_PHYSICS, TRUE);
llSleep(0.1);
llMoveToTarget(pos,0.1);
key id = llGetOwner();
llSensorRepeat("", id, AGENT, 96.0, PI, 0.4);
}
sensor(integer total_number)
{
vector pos = llDetectedPos(0);
vector offset =<-1,0,1>;
pos+=offset;
llMoveToTarget(pos,0.0);
}
}
</pre>

{{LSLC|Library|Follower}}

LlListen

2007-07-06T02:00:54Z

Placid Kidd: note limitation of negative channel number

{{LSL_Function
|func=llListen
|sort=Listen
|func_id=25|func_sleep=0.0|func_energy=10.0
|return_type=integer
|return_text=that can be used to deactivate or remove the listen.
|p1_type=integer|p1_name=channel|p1_desc=any valid integer, positive or negative.
|p2_type=string|p2_name=name
|p3_type=key|p3_name=id
|p4_type=string|p4_name=msg
|func_desc=Sets a callback for '''msg''' on '''channel''' from '''name''' and '''id'''.
|func_footnote=If '''msg''', '''name''' or '''id''' are blank they are not used to filter incoming messages. 
If '''id''' is an invalid key or a {{LSLG|NULL_KEY|null key}}, it is considered blank.
|also_functions={{LSL DefineRow||{{LSLG|llListenRemove}}|Removes a listen}}
{{LSL DefineRow||{{LSLG|llListenControl}}|Enables/Disables a listen}}
{{LSL DefineRow||{{LSLG|llWhisper}}|Sends chat limited to 10 meters}}
{{LSL DefineRow||{{LSLG|llSay}}|Sends chat limited to 20 meters}}
{{LSL DefineRow||{{LSLG|llShout}}|Sends chat limited to 100 meters}}
|also_events={{LSL DefineRow||{{LSLG|listen}}|}}
|also_tests
|also_articles
|notes
|constants={{LSL Constants/Chat}}
|caveats=*On [[state]] change or script reset all listens are released.
**A state change can be used as a shortcut to releasing listens.
*Only 64 listens can simultaneously be open in any single script.
**If this number is exceeded an error is shouted.
*Avoid channel 0 and set name or id where possible to avoid lag. ([http://rpgstats.com/wiki/index.php?title=Lag Lag])
**llListen(0,"",NULL_KEY,"") is extremely laggy as it listens to all chat from everyone in chat range and should be avoided at all cost.
*Negative channel numbers can only be used for inter object communication (and are preferable in that case).
|examples=
Trivial example to listen to any chat from the object owner and respond once. To reduce lag and avoid spamming surrounding users, it is vastly preferable to listen on channels other than 0 and to trigger the listen event by chatting on an alternative channel such as '/5 hello'.
<pre>
// says beep to owner the first time owner says something in main chat;
integer listen_handle;

default
{
state_entry()
{ //Registers the listen to the owner of the object at the moment of the call. This does not automatically update when the owner changes.
// Change 0 to another positive number to listen for '/5 hello' style of chat.
listen_handle = llListen(0, "", llGetOwner(), "");
}
listen( integer channel, string name, key id, string message )
{
llOwnerSay("beep");
// Stop listening until script is reset
llListenRemove(listen_handle);
}
on_rez(integer param)
{ //Triggered when the object is rezed, like after the object had been sold from a vendor
llResetScript();//By resetting the script on rez it forces the listen to re-register.
}
changed(integer mask)
{ //Triggered when the object containing this script changes owner.
if(mask & CHANGED_OWNER)
{
llResetScript();
}
}
}
</pre>

|specs
|cat1=Communications
|cat2=Chat
|cat3
|cat4
}}

LlListen

2007-07-06T01:58:25Z

Placid Kidd: typo

{{LSL_Function
|func=llListen
|sort=Listen
|func_id=25|func_sleep=0.0|func_energy=10.0
|return_type=integer
|return_text=that can be used to deactivate or remove the listen.
|p1_type=integer|p1_name=channel|p1_desc=any valid integer, positive or negative.
|p2_type=string|p2_name=name
|p3_type=key|p3_name=id
|p4_type=string|p4_name=msg
|func_desc=Sets a callback for '''msg''' on '''channel''' from '''name''' and '''id'''.
|func_footnote=If '''msg''', '''name''' or '''id''' are blank they are not used to filter incoming messages. 
If '''id''' is an invalid key or a {{LSLG|NULL_KEY|null key}}, it is considered blank.
|also_functions={{LSL DefineRow||{{LSLG|llListenRemove}}|Removes a listen}}
{{LSL DefineRow||{{LSLG|llListenControl}}|Enables/Disables a listen}}
{{LSL DefineRow||{{LSLG|llWhisper}}|Sends chat limited to 10 meters}}
{{LSL DefineRow||{{LSLG|llSay}}|Sends chat limited to 20 meters}}
{{LSL DefineRow||{{LSLG|llShout}}|Sends chat limited to 100 meters}}
|also_events={{LSL DefineRow||{{LSLG|listen}}|}}
|also_tests
|also_articles
|notes
|constants={{LSL Constants/Chat}}
|caveats=*On [[state]] change or script reset all listens are released.
**A state change can be used as a shortcut to releasing listens.
*Only 64 listens can simultaneously be open in any single script.
**If this number is exceeded an error is shouted.
*Avoid channel 0 and set name or id where possible to avoid lag. ([http://rpgstats.com/wiki/index.php?title=Lag Lag])
**llListen(0,"",NULL_KEY,"") is extremely laggy as it listens to all chat from everyone in chat range and should be avoided at all cost.
|examples=
Trivial example to listen to any chat from the object owner and respond once. To reduce lag and avoid spamming surrounding users, it is vastly preferable to listen on channels other than 0 and to trigger the listen event by chatting on an alternative channel such as '/5 hello'.
<pre>
// says beep to owner the first time owner says something in main chat;
integer listen_handle;

default
{
state_entry()
{ //Registers the listen to the owner of the object at the moment of the call. This does not automatically update when the owner changes.
// Change 0 to another positive number to listen for '/5 hello' style of chat.
listen_handle = llListen(0, "", llGetOwner(), "");
}
listen( integer channel, string name, key id, string message )
{
llOwnerSay("beep");
// Stop listening until script is reset
llListenRemove(listen_handle);
}
on_rez(integer param)
{ //Triggered when the object is rezed, like after the object had been sold from a vendor
llResetScript();//By resetting the script on rez it forces the listen to re-register.
}
changed(integer mask)
{ //Triggered when the object containing this script changes owner.
if(mask & CHANGED_OWNER)
{
llResetScript();
}
}
}
</pre>

|specs
|cat1=Communications
|cat2=Chat
|cat3
|cat4
}}

LlListen

2007-07-06T01:56:54Z

Placid Kidd: move anti lag suggestion to caveats

{{LSL_Function
|func=llListen
|sort=Listen
|func_id=25|func_sleep=0.0|func_energy=10.0
|return_type=integer
|return_text=that can be used to deactivate or remove the listen.
|p1_type=integer|p1_name=channel|p1_desc=any valid integer, positive or negative.
|p2_type=string|p2_name=name
|p3_type=key|p3_name=id
|p4_type=string|p4_name=msg
|func_desc=Sets a callback for '''msg''' on '''channel''' from '''name''' and '''id'''.
|func_footnote=If '''msg''', '''name''' or '''id''' are blank there are not used to filter incoming messages. 
If '''id''' is an invalid key or a {{LSLG|NULL_KEY|null key}}, it is considered blank.
|also_functions={{LSL DefineRow||{{LSLG|llListenRemove}}|Removes a listen}}
{{LSL DefineRow||{{LSLG|llListenControl}}|Enables/Disables a listen}}
{{LSL DefineRow||{{LSLG|llWhisper}}|Sends chat limited to 10 meters}}
{{LSL DefineRow||{{LSLG|llSay}}|Sends chat limited to 20 meters}}
{{LSL DefineRow||{{LSLG|llShout}}|Sends chat limited to 100 meters}}
|also_events={{LSL DefineRow||{{LSLG|listen}}|}}
|also_tests
|also_articles
|notes
|constants={{LSL Constants/Chat}}
|caveats=*On [[state]] change or script reset all listens are released.
**A state change can be used as a shortcut to releasing listens.
*Only 64 listens can simultaneously be open in any single script.
**If this number is exceeded an error is shouted.
*Avoid channel 0 and set name or id where possible to avoid lag. ([http://rpgstats.com/wiki/index.php?title=Lag Lag])
**llListen(0,"",NULL_KEY,"") is extremely laggy as it listens to all chat from everyone in chat range and should be avoided at all cost.
|examples=
Trivial example to listen to any chat from the object owner and respond once. To reduce lag and avoid spamming surrounding users, it is vastly preferable to listen on channels other than 0 and to trigger the listen event by chatting on an alternative channel such as '/5 hello'.
<pre>
// says beep to owner the first time owner says something in main chat;
integer listen_handle;

default
{
state_entry()
{ //Registers the listen to the owner of the object at the moment of the call. This does not automatically update when the owner changes.
// Change 0 to another positive number to listen for '/5 hello' style of chat.
listen_handle = llListen(0, "", llGetOwner(), "");
}
listen( integer channel, string name, key id, string message )
{
llOwnerSay("beep");
// Stop listening until script is reset
llListenRemove(listen_handle);
}
on_rez(integer param)
{ //Triggered when the object is rezed, like after the object had been sold from a vendor
llResetScript();//By resetting the script on rez it forces the listen to re-register.
}
changed(integer mask)
{ //Triggered when the object containing this script changes owner.
if(mask & CHANGED_OWNER)
{
llResetScript();
}
}
}
</pre>

|specs
|cat1=Communications
|cat2=Chat
|cat3
|cat4
}}

LlListen

2007-07-06T01:53:54Z

Placid Kidd: add example from listen for completeness

{{LSL_Function
|func=llListen
|sort=Listen
|func_id=25|func_sleep=0.0|func_energy=10.0
|return_type=integer
|return_text=that can be used to deactivate or remove the listen.
|p1_type=integer|p1_name=channel|p1_desc=any valid integer, positive or negative.
|p2_type=string|p2_name=name
|p3_type=key|p3_name=id
|p4_type=string|p4_name=msg
|func_desc=Sets a callback for '''msg''' on '''channel''' from '''name''' and '''id'''.
|func_footnote=If '''msg''', '''name''' or '''id''' are blank there are not used to filter incoming messages. 
If '''id''' is an invalid key or a {{LSLG|NULL_KEY|null key}}, it is considered blank. 

[http://rpgstats.com/wiki/index.php?title=Lag Lag] tip: Avoid channel 0 and set name or id where possible. llListen(0,"",NULL_KEY,"") is extremely laggy and should be avoided at all cost.
|also_functions={{LSL DefineRow||{{LSLG|llListenRemove}}|Removes a listen}}
{{LSL DefineRow||{{LSLG|llListenControl}}|Enables/Disables a listen}}
{{LSL DefineRow||{{LSLG|llWhisper}}|Sends chat limited to 10 meters}}
{{LSL DefineRow||{{LSLG|llSay}}|Sends chat limited to 20 meters}}
{{LSL DefineRow||{{LSLG|llShout}}|Sends chat limited to 100 meters}}
|also_events={{LSL DefineRow||{{LSLG|listen}}|}}
|also_tests
|also_articles
|notes
|constants={{LSL Constants/Chat}}
|caveats=*On [[state]] change or script reset all listens are released.
**A state change can be used as a shortcut to releasing listens.
*Only 64 listens can simultaneously be open in any single script.
**If this number is exceeded an error is shouted.
|examples=
Trivial example to listen to any chat from the object owner and respond once. To reduce lag and avoid spamming surrounding users, it is vastly preferable to listen on channels other than 0 and to trigger the listen event by chatting on an alternative channel such as '/5 hello'.
<pre>
// says beep to owner the first time owner says something in main chat;
integer listen_handle;

default
{
state_entry()
{ //Registers the listen to the owner of the object at the moment of the call. This does not automatically update when the owner changes.
// Change 0 to another positive number to listen for '/5 hello' style of chat.
listen_handle = llListen(0, "", llGetOwner(), "");
}
listen( integer channel, string name, key id, string message )
{
llOwnerSay("beep");
// Stop listening until script is reset
llListenRemove(listen_handle);
}
on_rez(integer param)
{ //Triggered when the object is rezed, like after the object had been sold from a vendor
llResetScript();//By resetting the script on rez it forces the listen to re-register.
}
changed(integer mask)
{ //Triggered when the object containing this script changes owner.
if(mask & CHANGED_OWNER)
{
llResetScript();
}
}
}
</pre>

|specs
|cat1=Communications
|cat2=Chat
|cat3
|cat4
}}

Category:Articles in need of example

2007-07-06T01:49:23Z

Placid Kidd: Removing all content from page

Category:Articles in need of example

2007-07-06T01:47:17Z

Placid Kidd: New category

The following articles need an example to make them more useful to your fellow Residents.

Please read through them and improve them if you can lend a hand.

User:Placid Kidd

2007-07-06T01:43:20Z

Placid Kidd: New page: Proficient scripter specialising in low lag, low spam scripting solutions.

Proficient scripter specialising in low lag, low spam scripting solutions.

Talk:LlListenControl

2007-07-06T01:42:30Z

Placid Kidd: why?

Why does this function exist? Can it be saving much on doing a llListenRemove then new llListen? [[User:Placid Kidd|Placid Kidd]] 18:42, 5 July 2007 (PDT)

Listen

2007-07-06T01:39:21Z

Placid Kidd:

{{LSL_Event|event_id=12|event_delay
|event=listen
|p1_type=integer|p1_name=channel|p1_desc
|p2_type=string|p2_name=name|p2_desc
|p3_type=key|p3_name=id|p3_desc
|p4_type=string|p4_name=message|p4_desc
|event_desc=Trigged by chat, use {{LSLG|llListen}} to enable and filter
|constants={{LSL Constants/Chat}}
|spec
|caveats=*On [[state]] change or [[llResetScript|script reset]] all listens are [[llListenRemove|removed]].
*When an object changes owner any listen registered with [[llGetOwner]] will not automatically update itself until the script is reset. The scripter can catch this scenario per the example below.
|examples=
Trivial example to listen to any chat from the object owner and respond once. To reduce lag and avoid spamming surrounding users, it is vastly preferable to listen on channels other than 0 and to trigger the listen event by chatting on an alternative channel such as '/5 hello'.
<pre>
// says beep to owner the first time owner says something in main chat;
integer listen_handle;

default
{
state_entry()
{ //Registers the listen to the owner of the object at the moment of the call. This does not automatically update when the owner changes.
// Change 0 to another positive number to listen for '/5 hello' style of chat.
listen_handle = llListen(0, "", llGetOwner(), "");
}
listen( integer channel, string name, key id, string message )
{
llOwnerSay("beep");
// Stop listening until script is reset
llListenRemove(listen_handle);
}
on_rez(integer param)
{ //Triggered when the object is rezed, like after the object had been sold from a vendor
llResetScript();//By resetting the script on rez it forces the listen to re-register.
}
changed(integer mask)
{ //Triggered when the object containing this script changes owner.
if(mask & CHANGED_OWNER)
{
llResetScript();
}
}
}
</pre>

|helpers
|also_header
|also_events
|also_functions=
{{LSL DefineRow||[[llListen]]|}}
{{LSL DefineRow||[[llListenControl]]|}}
{{LSL DefineRow||[[llListenRemove]]|}}
{{LSL DefineRow||[[llDialog]]|}}
{{LSL DefineRow||[[llWhisper]]|Sends chat limited to 10 meters}}
{{LSL DefineRow||[[llSay]]|Sends chat limited to 20 meters}}
{{LSL DefineRow||[[llShout]]|Sends chat limited to 100 meters}}
{{LSL DefineRow||[[llRegionSay]]|Sends chat limited to region}}
|also_articles
|also_footer
|notes
|mode
|deprecated
|cat1=Communications
|cat2=Chat
|cat3
|cat4
}}

Listen

2007-07-06T01:37:36Z

Placid Kidd: link some references

{{LSL_Event|event_id=12|event_delay
|event=listen
|p1_type=integer|p1_name=channel|p1_desc
|p2_type=string|p2_name=name|p2_desc
|p3_type=key|p3_name=id|p3_desc
|p4_type=string|p4_name=message|p4_desc
|event_desc=Trigged by chat, use {{LSLG|llListen}} to enable and filter
|constants={{LSL Constants/Chat}}
|spec
|caveats=*On [[state]] change or [[llResetScript|script reset]] all listens are [[llListenRemove|removed]].
*When an object changes owner any listen registered with [[llGetOwner]] will not automatically update itself until the script is reset. The scripter can catch this scenario per the example below.
|examples=
Trivial example to listen to any chat from the object owner and respond once. To reduce lag and avoid spamming surrounding users, it is vastly preferable to listen on channels other than 0 and to trigger the listen event by chatting on an alternative channel such as '/5 hello'.
<pre>
// says beep to owner the first time owner says something in main chat;
integer listen_handle;

default
{
state_entry()
{ //Registers the listen to the owner of the object at the moment of the call. This does not automatically update when the owner changes.
// Change 0 to another positive number to listen for '/5 hello' style of chat.
listen_handle = llListen(0, "", llGetOwner(), "");
}
listen( integer channel, string name, key id, string message ){
llOwnerSay("beep");
// Stop listening until script is reset
llListenRemove(listen_handle);
}
on_rez(integer param)
{ //Triggered when the object is rezed, like after the object had been sold from a vendor
llResetScript();//By resetting the script on rez it forces the listen to re-register.
}
changed(integer mask)
{ //Triggered when the object containing this script changes owner.
if(mask & CHANGED_OWNER)
{
llResetScript();
}
}
}
</pre>

|helpers
|also_header
|also_events
|also_functions=
{{LSL DefineRow||[[llListen]]|}}
{{LSL DefineRow||[[llListenControl]]|}}
{{LSL DefineRow||[[llListenRemove]]|}}
{{LSL DefineRow||[[llDialog]]|}}
{{LSL DefineRow||[[llWhisper]]|Sends chat limited to 10 meters}}
{{LSL DefineRow||[[llSay]]|Sends chat limited to 20 meters}}
{{LSL DefineRow||[[llShout]]|Sends chat limited to 100 meters}}
{{LSL DefineRow||[[llRegionSay]]|Sends chat limited to region}}
|also_articles
|also_footer
|notes
|mode
|deprecated
|cat1=Communications
|cat2=Chat
|cat3
|cat4
}}

LlListenRemove

2007-07-06T01:36:24Z

Placid Kidd:

{{LSL_Function
|func_id=27|func_sleep=0.0|func_energy=10.0
|func=llListenRemove|p1_type=integer|p1_name=number
|func_footnote
|func_desc=Removes listen event callback '''number'''
|return_text
|spec
|caveats=*On [[state]] change or script reset all listens are removed.
**A state change can be used as a shortcut to releasing listens.
|constants
|examples=<pre>
integer olf;
default
{
//Repeats one line of text then stops listening
state_entry()
{
olf=llListen(0,"",llGetOwner(),"");
}
listen(integer channel, string name, key id, string message)
{
llSay(0, message);
llListenRemove(olf);
}
}
</pre>
|helpers
|also_functions={{LSL DefineRow||[[llListen]]}}
{{LSL DefineRow||[[llListenControl]]}}
|also_events={{LSL DefineRow|[[listen]]|}}
|also_tests
|also_articles
|notes
|permission
|negative_index
|sort=ListenRemove
|cat1=Communications
|cat2=Chat
|cat3
|cat4
}}

Listen

2007-07-06T01:32:00Z

Placid Kidd: clarify owner change effect

{{LSL_Event|event_id=12|event_delay
|event=listen
|p1_type=integer|p1_name=channel|p1_desc
|p2_type=string|p2_name=name|p2_desc
|p3_type=key|p3_name=id|p3_desc
|p4_type=string|p4_name=message|p4_desc
|event_desc=Trigged by chat, use {{LSLG|llListen}} to enable and filter
|constants={{LSL Constants/Chat}}
|spec
|caveats=*On [[state]] change all listens are released (on script reset as well).
*When an object changes owner any listen registered with [[llGetOwner]] will not automatically update itself until the script is reset. The scripter can catch this scenario per the example below.
|examples=
Trivial example to listen to any chat from the object owner and respond once. To reduce lag and avoid spamming surrounding users, it is vastly preferable to listen on channels other than 0 and to trigger the listen event by chatting on an alternative channel such as '/5 hello'.
<pre>
// says beep to owner the first time owner says something in main chat;
integer listen_handle;

default
{
state_entry()
{ //Registers the listen to the owner of the object at the moment of the call. This does not automatically update when the owner changes.
// Change 0 to another positive number to listen for '/5 hello' style of chat.
listen_handle = llListen(0, "", llGetOwner(), "");
}
listen( integer channel, string name, key id, string message ){
llOwnerSay("beep");
// Stop listening until script is reset
llListenRemove(listen_handle);
}
on_rez(integer param)
{ //Triggered when the object is rezed, like after the object had been sold from a vendor
llResetScript();//By resetting the script on rez it forces the listen to re-register.
}
changed(integer mask)
{ //Triggered when the object containing this script changes owner.
if(mask & CHANGED_OWNER)
{
llResetScript();
}
}
}
</pre>

|helpers
|also_header
|also_events
|also_functions=
{{LSL DefineRow||[[llListen]]|}}
{{LSL DefineRow||[[llListenControl]]|}}
{{LSL DefineRow||[[llListenRemove]]|}}
{{LSL DefineRow||[[llDialog]]|}}
{{LSL DefineRow||[[llWhisper]]|Sends chat limited to 10 meters}}
{{LSL DefineRow||[[llSay]]|Sends chat limited to 20 meters}}
{{LSL DefineRow||[[llShout]]|Sends chat limited to 100 meters}}
{{LSL DefineRow||[[llRegionSay]]|Sends chat limited to region}}
|also_articles
|also_footer
|notes
|mode
|deprecated
|cat1=Communications
|cat2=Chat
|cat3
|cat4
}}

Listen

2007-07-06T01:29:49Z

Placid Kidd: streamline caveats and example leadin

{{LSL_Event|event_id=12|event_delay
|event=listen
|p1_type=integer|p1_name=channel|p1_desc
|p2_type=string|p2_name=name|p2_desc
|p3_type=key|p3_name=id|p3_desc
|p4_type=string|p4_name=message|p4_desc
|event_desc=Trigged by chat, use {{LSLG|llListen}} to enable and filter
|constants={{LSL Constants/Chat}}
|spec
|caveats=*On [[state]] change all listens are released (on script reset as well).
*When an object changes owner any listen registered with [[llGetOwner]] will not automatically update itself until the script is reset. The scripter can catch this scenario per the example below.
|examples=
Trivial example to listen to any chat from the object owner and respond once. To reduce lag and avoid spamming surrounding users, it is vastly preferable to listen on channels other than 0 and to trigger the listen event by chatting on an alternative channel such as '/5 hello'.
<pre>
// says beep to owner the first time owner says something in main chat;
integer listen_handle;

default
{
state_entry()
{ //Registers the listen to the owner of the object at the moment of the call. This does not automatically update when the owner changes.
// Change 0 to another positive number to listen for '/5 hello' style of chat.
listen_handle = llListen(0, "", llGetOwner(), "");
}
listen( integer channel, string name, key id, string message ){
llOwnerSay("beep");
// Stop listening until script is reset
llListenRemove(listen_handle);
}
on_rez(integer param)
{ //Triggered when the object is rezed, like after the object had been sold from a vendor
llResetScript();//By resetting the script on rez it forces the listen to re-register.
}
changed(integer mask)
{ //Triggered when the object has been sold as "original" from in world.
if(mask & CHANGED_OWNER)
{
llResetScript();
}
}
}
</pre>

|helpers
|also_header
|also_events
|also_functions=
{{LSL DefineRow||[[llListen]]|}}
{{LSL DefineRow||[[llListenControl]]|}}
{{LSL DefineRow||[[llListenRemove]]|}}
{{LSL DefineRow||[[llDialog]]|}}
{{LSL DefineRow||[[llWhisper]]|Sends chat limited to 10 meters}}
{{LSL DefineRow||[[llSay]]|Sends chat limited to 20 meters}}
{{LSL DefineRow||[[llShout]]|Sends chat limited to 100 meters}}
{{LSL DefineRow||[[llRegionSay]]|Sends chat limited to region}}
|also_articles
|also_footer
|notes
|mode
|deprecated
|cat1=Communications
|cat2=Chat
|cat3
|cat4
}}

Listen

2007-07-06T01:27:27Z

Placid Kidd: improve example to be more resource friendly and less spammy

{{LSL_Event|event_id=12|event_delay
|event=listen
|p1_type=integer|p1_name=channel|p1_desc
|p2_type=string|p2_name=name|p2_desc
|p3_type=key|p3_name=id|p3_desc
|p4_type=string|p4_name=message|p4_desc
|event_desc=Trigged by chat, use {{LSLG|llListen}} to enable and filter
|constants={{LSL Constants/Chat}}
|spec
|caveats=*On [[state]] change all listens are released (on script reset as well).
*When an object changes owner any listen registered with [[llGetOwner]] will not automatically update itself. The scripter needs to capture this event ([[on_rez]] and [[CHANGED_OWNER]]).
|examples=
Trivial example to listen to any chat from the object owner and respond. To reduce lag and avoid spamming surrounding users, it is vastly preferable to listen on channels other than 0 and to trigger the listen event by talking on the alternative channel such as '/5 hello'.
<pre>
// says beep to owner the first time owner says something in main chat;
integer listen_handle;

default
{
state_entry()
{ //Registers the listen to the owner of the object at the moment of the call. This does not automatically update when the owner changes.
// Change 0 to another positive number to listen for '/5 hello' style of chat.
listen_handle = llListen(0, "", llGetOwner(), "");
}
listen( integer channel, string name, key id, string message ){
llOwnerSay("beep");
// Stop listening until script is reset
llListenRemove(listen_handle);
}
on_rez(integer param)
{ //Triggered when the object is rezed, like after the object had been sold from a vendor
llResetScript();//By resetting the script on rez it forces the listen to re-register.
}
changed(integer mask)
{ //Triggered when the object has been sold as "original" from in world.
if(mask & CHANGED_OWNER)
{
llResetScript();
}
}
}
</pre>

|helpers
|also_header
|also_events
|also_functions=
{{LSL DefineRow||[[llListen]]|}}
{{LSL DefineRow||[[llListenControl]]|}}
{{LSL DefineRow||[[llListenRemove]]|}}
{{LSL DefineRow||[[llDialog]]|}}
{{LSL DefineRow||[[llWhisper]]|Sends chat limited to 10 meters}}
{{LSL DefineRow||[[llSay]]|Sends chat limited to 20 meters}}
{{LSL DefineRow||[[llShout]]|Sends chat limited to 100 meters}}
{{LSL DefineRow||[[llRegionSay]]|Sends chat limited to region}}
|also_articles
|also_footer
|notes
|mode
|deprecated
|cat1=Communications
|cat2=Chat
|cat3
|cat4
}}

Listen

2007-07-06T01:16:34Z

Placid Kidd: replace llSay(0,... with llOwnerSay(

{{LSL_Event|event_id=12|event_delay
|event=listen
|p1_type=integer|p1_name=channel|p1_desc
|p2_type=string|p2_name=name|p2_desc
|p3_type=key|p3_name=id|p3_desc
|p4_type=string|p4_name=message|p4_desc
|event_desc=Trigged by chat, use {{LSLG|llListen}} to enable and filter
|constants={{LSL Constants/Chat}}
|spec
|caveats=*On [[state]] change all listens are released (on script reset as well).
*When an object changes owner any listen registered with [[llGetOwner]] will not automatically update itself. The scripter needs to capture this event ([[on_rez]] and [[CHANGED_OWNER]]).
|examples=<pre>
// says beep whenever owner says something in main chat;
default
{
state_entry()
{//Registers the listen to the owner of the object at the moment of the call. This does not automatically update when the owner changes.
llListen(0, "", llGetOwner(), "");
}
listen( integer channel, string name, key id, string message ){
llOwnerSay("beep");
}
on_rez(integer param)
{//Triggered when the object is rezed, like after the object had been sold from a vendor
llResetScript();//By resetting the script on rez it forces the listen to re-register.
}
changed(integer mask)
{//Triggered when the object has been sold as "original" from in world.
if(mask & CHANGED_OWNER)
{
llResetScript();
}
}
}
</pre>

<pre>
// says beep whenever owner says something in main chat;

//Does not use a hard reset to re-register it's listen.
integer handle;

reset()
{
llListenRemove(handle);
handle = llListen(0, "", llGetOwner(), "");
}

default
{
state_entry()
{//Registers the listen to the owner of the object at the moment of the call. This does not automatically update when the owner changes.
reset();
}
listen( integer channel, string name, key id, string message ){
llOwnerSay("beep");
}
on_rez(integer param)
{//Triggered when the object is rezed, like after the object had been sold from a vendor
reset();
}
changed(integer mask)
{//Triggered when the object has been sold as "original" from in world.
if(mask & CHANGED_OWNER)
{
reset();
}
}
}
</pre>
|helpers
|also_header
|also_events
|also_functions=
{{LSL DefineRow||[[llListen]]|}}
{{LSL DefineRow||[[llListenControl]]|}}
{{LSL DefineRow||[[llListenRemove]]|}}
{{LSL DefineRow||[[llDialog]]|}}
{{LSL DefineRow||[[llWhisper]]|Sends chat limited to 10 meters}}
{{LSL DefineRow||[[llSay]]|Sends chat limited to 20 meters}}
{{LSL DefineRow||[[llShout]]|Sends chat limited to 100 meters}}
{{LSL DefineRow||[[llRegionSay]]|Sends chat limited to region}}
|also_articles
|also_footer
|notes
|mode
|deprecated
|cat1=Communications
|cat2=Chat
|cat3
|cat4
}}

LlInstantMessage

2007-07-06T01:11:20Z

Placid Kidd: more specific regarding avoiding script delay

{{LSL_Function
|func_id=118|func_sleep=2.0|func_energy=10.0
|func=llInstantMessage
|p1_type=key|p1_name=user|p1_desc
|p2_type=string|p2_name=message|p2_desc
|func_desc=Sends an Instant Message specified in the string '''message''' to the user specified by '''key'''.
|return_text
|spec
|caveats=**For applications where this is problematic, it's possible to place the call to llInstantMessage in a child script and pass the information to that script via [[llMessageLinked]].
*The message sent can not be longer than 1024 bytes.
|examples=
Tell the owner somebody touched the object:
<pre>
key owner;

default {

on_rez(integer start_param)
{
owner=llGetOwner(); // get the key of the objects owner.
}
touch_start(integer total_num)
{
llInstantMessage(owner,llKey2Name(owner)+", " + (string)total_num +" Avatar(s) touched me!");
}
}
</pre>
Send a confirmation to the Avatar that touches an object without spamming other Avatars:
<pre>

default {

touch_start(integer total_num)
{
llInstantMessage(llDetectedKey(0),"You have been registered!");
}
}
</pre>

|helpers
|also_functions=
{{LSL DefineRow||[[llOwnerSay]]|}}
{{LSL DefineRow||[[llRegionSay]]|Sends chat region wide}}
{{LSL DefineRow||[[llWhisper]]|Sends chat limited to 10 meters}}
{{LSL DefineRow||[[llSay]]|Sends chat limited to 20 meters}}
{{LSL DefineRow||[[llShout]]|Sends chat limited to 100 meters}}
|also_tests
|also_articles
|also_events
|notes=Instant Messaging has the benefit of allowing communication from an object to an avatar anywhere in the Grid. The downside is that an object cannot receive an Instant Message, therefore an avatar cannot send an Instant Message to an object. It's a one-way communication avenue. Also, the two-second script delay can be considered a downside in some applications.
|cat1=Communications
|cat2=Instant Message
|cat3
|cat4
}}

LlListen

2007-07-06T00:59:50Z

Placid Kidd: add anti lag tip

LlSensorRepeat

2007-07-06T00:55:25Z

Placid Kidd: add suggestion re llVolumeDetect

{{LSL_Function
|func=llSensorRepeat
|sort=SensorRepeat
|func_id=29|func_sleep=0.0|func_energy=10.0
|p1_type=string|p1_name=name
|p2_type=key|p2_name=id
|p3_type=integer|p3_name=type|p3_desc=mask
|p4_type=float|p4_name=range
|p5_type=float|p5_name=arc
|p6_type=float|p6_name=rate
|func_footnote=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: [http://www.lslwiki.net/lslwiki/wakka.php?wakka=llSensor llSensor] for an excellent explanation of '''arc'''. 
[http://rpgstats.com/wiki/index.php?title=Lag Lag] tip: Consider [[llVolumeDetect]] as a less resource intensive alternative to llSensorRepeat in many cases.
|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.
|return_text
|spec
|caveats=*The repeat of the sensor event is adversely effected by [[llGetRegionTimeDilation|time dilation]] (lag).
|constants={{LSL Constants Sensor|type}}
|examples
|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
|permission
|negative_index
|cat1=Sensor
|cat2=Detected
|cat3
|cat4
}}

Follower script

2007-05-26T03:19:02Z

Placid Kidd: fix bug in script that caused this to hassle other objects

This script was extracted from the Batman Follower v1.2, but the following distance was changed from .3 m to .1 m.

To set the following distance (distance between follower and followee), change the value denoted by # in '''llMoveToTarget(pos,#)'''. This script has it set at 0.0 m.

<pre>
default
{
state_entry()
{
vector pos = llGetPos();
llSetStatus(STATUS_PHYSICS, TRUE);
llSleep(0.1);
llMoveToTarget(pos,0.1);
key id = llGetOwner();
llSensorRepeat("", id, AGENT, 96.0, PI, 0.4);
}
sensor(integer total_number)
{
vector pos = llDetectedPos(0);
vector offset =<-1,0,1>;
pos+=offset;
llMoveToTarget(pos,0.0);
}
}
</pre>

{{LSLC|Library|Follower}}

LlGetAgentSize

2007-05-25T02:31:58Z

Placid Kidd: add avatar category

{{LSL_Function
|func_id=218|func_sleep=0.0|func_energy=10.0
|func=llGetAgentSize|return_type=vector|p1_type=key|p1_name=id
|func_footnote=The agent '''id''' must be in the same sim as the requesting object.
|func_desc
|return_text=that is the size of the requested avatar by '''id'''.
|spec
|caveats
|constants
|examples
|helpers
|also_functions=
{{LSL DefineRow||[[llGetBoundingBox]]|}}
{{LSL DefineRow||[[llGetAgentInfo]]|}}
{{LSL DefineRow||[[llRequestAgentData]]|}}
|also_events
|also_tests
|also_articles
|notes
|permission
|negative_index
|cat1=Agent
|cat2=Avatar
|cat3
|cat4
}}