LlSay

From Second Life Wiki

Jump to: navigation, search

Contents

Description

Function: llSay( integer channel, string msg );
23 Function ID
0.0 Delay
10.0 Energy

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

• integer channel output channel, any integer value
• string msg message to be transmitted
Channel Constant Description
DEBUG_CHANNEL 0x7FFFFFFF Chat channel reserved for debug and error messages from scripts.
PUBLIC_CHANNEL 0x0 Chat channel that broadcasts to all nearby users.

Caveats

  • Text can only be a maximum of 1024 bytes.
  • Text spoken can only be heard within 20 meters of the speaking prim (rather than the root). This is contrary to how listens work, where a message can only be heard by any prim in the object if and only if the root prim is capable of hearing it.
  • A prim can not hear itself, to prevent problems with recursion.

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 (if never more negative than the most negative 32-bit integer that is -2,147,483,648), e.g.,

 
    llSay(-5243212,"turn on");
 

Negative channels are popular for script communications because the client is unable to chat directly on those channels ("/-xxxx message" won't chat "message" on channel "-xxxx", it will chat "/-xxxx message" on channel zero). The only way to do so prior to llTextBox was to use llDialog which was limited to 24 bytes.

If DEBUG_CHANNEL is used as channel, the script will say msg to the Script Warning/Error window.

Channel 0 is PUBLIC_CHANNEL. Everyone can hear chat transmitted on this channel. All other channels are private channels (not sent to users).

See Also

Events

•  listen

Functions

•  llListen
•  llOwnerSay Sends chat to the owner only to avoid spamming the PUBLIC_CHANNEL
•  llRegionSay Sends chat region wide
•  llWhisper Sends chat limited to 10 meters
•  llShout Sends chat limited to 100 meters
•  llInstantMessage
This article wasn't helpful for you? Maybe the related article at the LSL Wiki is able to bring enlightenment.
Personal tools