Difference between revisions of "LlRegionSay"

From Second Life Wiki
Jump to navigation Jump to search
m (In anticipation for tomorrows release)
Line 30: Line 30:
{{LSL DefineRow||[[llListen]]|}}
{{LSL DefineRow||[[llListen]]|}}
{{LSL DefineRow||[[llOwnerSay]]|}}
{{LSL DefineRow||[[llOwnerSay]]|}}
{{LSL DefineRow||{{LSLG|llWhisper}}|Sends chat limited to 10 meters}}
{{LSL DefineRow||[[llWhisper}}|Sends chat limited to 10 meters}}
{{LSL DefineRow||{{LSLG|llShout}}|Sends chat limited to 100 meters}}
{{LSL DefineRow||[[llSay]]|Sends chat limited to 20 meters}}
{{LSL DefineRow||[[llShout]]|Sends chat limited to 100 meters}}
{{LSL DefineRow||[[llInstantMessage]]|}}
{{LSL DefineRow||[[llInstantMessage]]|}}
|also_tests
|also_tests

Revision as of 22:53, 22 May 2007

{{LSL_Function |func_id=331 |func_sleep=0.0 |func_energy=10.0 |func_release=1.16.0.? |func=llRegionSay |p1_type=integer|p1_name=channel|p1_desc=Any integer value other than zero. |p2_type=string|p2_name=msg|p2_desc=Message to be transmitted. |func_desc=Says the string msg on channel number channel that can be heard anywhere in the region by a script listening on channel. |func_footnote=Regardless of where the prim is, the message will not travel over region boarders. |return_text |spec |constants=

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.

  • Text can only be a maximum of 1024 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. |helpers |also_events= |-style="vertical-align:top;" | style="color:gray;" |•  | listen | style="color:gray;" | | | |also_functions= |-style="vertical-align:top;" | style="color:gray;" |•  | llListen | style="color:gray;" | | | |-style="vertical-align:top;" | style="color:gray;" |•  | llOwnerSay | style="color:gray;" | | | {{LSL DefineRow||[[llWhisper}}|Sends chat limited to 10 meters}} |-style="vertical-align:top;" | style="color:gray;" |•  | llSay | style="color:gray;" | – | Sends chat limited to 20 meters | |-style="vertical-align:top;" | style="color:gray;" |•  | llShout | style="color:gray;" | – | Sends chat limited to 100 meters | |-style="vertical-align:top;" | style="color:gray;" |•  | llInstantMessage | style="color:gray;" | | | |also_tests |also_articles |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 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)

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