Difference between revisions of "LlRegionSay"
| Line 3: | Line 3: | ||
|func_sleep=0.0 | |func_sleep=0.0 | ||
|func_energy=10.0 | |func_energy=10.0 | ||
|func=llRegionSay | |func=llRegionSay | ||
|p1_type=integer|p1_name=channel|p1_desc=Any integer value other than zero. | |p1_type=integer|p1_name=channel|p1_desc=Any integer value other than zero. | ||
| Line 13: | Line 12: | ||
|constants={{LSL Constants/Chat|mode=no_public}} | |constants={{LSL Constants/Chat|mode=no_public}} | ||
|caveats=*This function cannot transmit on the {{LSL Const|PUBLIC_CHANNEL|integer|0|public channel}}, this is a design feature and not a bug. | |caveats=*This function cannot transmit on the {{LSL Const|PUBLIC_CHANNEL|integer|0|public channel}}, this is a design feature and not a bug. | ||
* | *If '''msg''' is longer then 1023 bytes it is truncated to 1023 bytes. | ||
*A prim can '''not''' hear itself, to prevent problems with recursion. | *A prim can '''not''' hear itself, to prevent problems with recursion. | ||
|examples=<pre> | |examples=<pre> | ||
| Line 47: | Line 46: | ||
If {{LSL Const|DEBUG_CHANNEL|integer|hex=0x7FFFFFFF}} is used as '''channel''', the script will say '''msg''' to the Script Warning/Error window. | If {{LSL Const|DEBUG_CHANNEL|integer|hex=0x7FFFFFFF}} is used as '''channel''', the script will say '''msg''' to the Script Warning/Error window. | ||
|history=Introduced with SL 1.16.0 | |||
|cat1=Communications | |cat1=Communications | ||
|cat2=Chat | |cat2=Chat | ||
Revision as of 18:19, 4 September 2007
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llRegionSay( integer channel, string msg );| 331 | Function ID |
| 0.0 | Forced 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 | – | Any integer value other than zero. | |
| • 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, broadcasts to all nearby users. |
| PUBLIC_CHANNEL | 0x0 | Chat channel that broadcasts to all nearby users. This channel is sometimes referred to as: open chat, local chat and public chat. |
Caveats
- This function cannot transmit on the public channel, this is a design feature and not a bug.
- If msg is longer then 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");
It is impossible for an avatar to chat on a negative channel, and extremely unlikely that some other object would accidentally say something on such a channel. (Of course, the intended target of the message must be set to 'listen' on this channel.)
If DEBUG_CHANNEL is used as channel, the script will say msg to the Script Warning/Error window.
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 |
Deep Notes
History
Search JIRA for related Issues
Signature |
|---|
function void llRegionSay( integer channel, string msg ); |