LlRegionSay
From Second Life Wiki
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Tutorials |
Contents |
Summary
Function: llRegionSay( integer channel, string msg );| 331 | Function ID |
| 0.0 | Delay |
| 10.0 | Energy |
Says the string msg on channel number channel that can be heard anywhere in the region by a script listening on channel.
| • integer | channel | – | output channel, any integer value except PUBLIC_CHANNEL | |
| • string | msg | – | message to be transmitted |
Regardless of where the prim is, the message will not travel over region borders.
| Channel Constant | Description | |
|---|---|---|
| DEBUG_CHANNEL | 0x7FFFFFFF | Chat channel reserved for script debugging and error messages. |
Caveats
- This function cannot transmit on the PUBLIC_CHANNEL, this is a design feature and not a bug.
- If msg is longer than 1023 bytes it is truncated to 1023 bytes.
- A prim can not hear itself, to prevent problems with recursion.
Examples
default { state_entry() { llRegionSay(25,"This is an incredibly useless program." ); } }To avoid making your object spam its neighborhood, use llOwnerSay or llInstantMessage.
Notes
If one object 'says' something to another object (e.g., a button that, when touched, turns on a lamp), it is a good idea to use a very negative channel, e.g.,
llRegionSay(-5243212,"turn on");
Negative channels are popular for script communications because the client is unable to chat directly on those channels ("/-xxxx message" won't chat "message" on channel "-xxxx", it will chat "/-xxxx message" on channel zero). The only way to do so prior to llTextBox was to use llDialog which was limited to 24 bytes.
If DEBUG_CHANNEL is used as channel, the script will say msg to the Script Warning/Error window.
- As of 1.18.3, using llRegionSay on the DEBUG_CHANNEL will wrap around and display on channel 0, with a range of 100m.
See Also
Events
| • | listen |
Functions
| • | llListen | |||
| • | llOwnerSay | – | Sends chat to the owner only | |
| • | llWhisper | – | Sends chat limited to 10 meters | |
| • | llSay | – | Sends chat limited to 20 meters | |
| • | llShout | – | Sends chat limited to 100 meters | |
| • | llInstantMessage | |||
| • | llDialog | |||
| • | llTextBox |
