Difference between revisions of "LlSay"

From Second Life Wiki
Jump to navigation Jump to search
Line 14: Line 14:
*Phrases spoken with llSay can only be heard within 20 meters of the speaking object.
*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.
*Consider using [[llOwnerSay]] or channel DEBUG_CHANNEL for debugging purposes.
|examples=<pre>
|examples=<pre>
default {
default {
Line 36: Line 35:
|also_tests
|also_tests
|also_articles
|also_articles
|notes=If one object 'says' something to another object (e.g., a button that, when touched,
|notes=
Consider using [[llOwnerSay]] or channel {{LSL Const|DEBUG_CHANNEL|integer|hex=0x7FFFFFFF}} for debugging purposes.
 
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.,
turns on a lamp), it is a good idea to use a very negative channel, e.g.,
<pre>
<pre>
Line 45: Line 47:
of the message must be set to 'listen' on this channel.)
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 {{LSL Const|DEBUG_CHANNEL|integer|hex=0x7FFFFFFF}} is used as ''channel'', the script will say ''msg'' to the Script Warning/Error window.  


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.
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.

Revision as of 15:03, 26 June 2007

Summary

Function: llSay( integer channel, string msg );

Says the text supplied in string msg on channel supplied in integer channel.

• integer channel
• string msg

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

  • 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.
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

Consider using llOwnerSay or channel DEBUG_CHANNEL for debugging purposes.

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.

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
•  llRegionSay Sends chat region wide
•  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 llSay( integer channel, string msg );