Difference between revisions of "LlRegionSay"

From Second Life Wiki
Jump to navigation Jump to search
 
Line 1: Line 1:
{{LSL_Generic/preview|type=function}}
{{LSL_Generic/preview|type=function}}
{{LSL_Function
{{LSL_Function
|func_id=23
|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 text supplied in string '''msg''' on channel supplied in integer '''channel'''.
|func_desc=Says the string '''msg''' on channel number '''channel'''.
|func_footer=Cannot transmit on channel 0 ({{HoverLink|PUBLIC_CHANNEL|integer PUBLIC_CHANNEL = 0;}})
|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.
*Phrases spoken with llSay can only be heard within 20 meters of the speaking object.
*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

  Note! Preview Documentation

This function only exists on the preview grid

Summary

Function: llRegionSay( integer channel, string msg );

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.

All Issues ~ Search JIRA for related Bugs

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

Deep Notes

Search JIRA for related Issues

Signature

function void llRegionSay( integer channel, string msg );