Difference between revisions of "LlRegionSay"
Line 1: | Line 1: | ||
{{LSL_Generic/preview|type=function}} | {{LSL_Generic/preview|type=function}} | ||
{{LSL_Function | {{LSL_Function | ||
|func_id= | |func_id=331 | ||
|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_type=integer|p1_name=channel|p1_desc=Any integer value other than zero. | ||
|p2_type=string|p2_name=msg | |p2_type=string|p2_name=msg|p2_desc=Message to be transmitted. | ||
|func_desc=Says the | |func_desc=Says the string '''msg''' on channel number '''channel'''. | ||
|return_text | |return_text | ||
|spec | |spec | ||
|constants={{LSL Constants/Chat|mode=no_public}} | |constants={{LSL Constants/Chat|mode=no_public}} | ||
|caveats=*Text can only be a maximum of 1024 bytes | |caveats=*This function cannot transmit on the {{HoverLink|PUBLIC_CHANNEL|integer PUBLIC_CHANNEL {{=}} 0;|public channel}}, this is a *Text can only be a maximum of 1024 bytes. | ||
*A prim can '''not''' hear itself, to prevent problems with recursion. | *A prim can '''not''' hear itself, to prevent problems with recursion. | ||
design feature and not a bug. | |||
|examples=<pre> | |examples=<pre> | ||
default { | default { |
Revision as of 17:10, 16 May 2007
LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Note! Preview Documentation
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.
• integer | channel | – | Any integer value other than zero. | |
• string | msg | – | Message to be transmitted. |
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 *Text can only be a maximum of 1024 bytes.
- A prim can not hear itself, to prevent problems with recursion.
design feature and not a bug.
Examples
default { state_entry() { llSay(0,"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.,
llSay(-5243212,"turn on");
It is impossible for an avatar to chat on a negative channel, and extremely unlikely that some other object would accidently 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. (DEBUG_CHANNEL = 2147483647)
If 0 is used as channel, the script will say msg so anyone can see it as normal chat. All other integers used are private channels.
See Also
Events
• | listen |
Functions
• | llListen | |||
• | llOwnerSay | |||
• | llWhisper | – | Sends chat limited to 10 meters | |
• | llShout | – | Sends chat limited to 100 meters | |
• | llInstantMessage |