Difference between revisions of "LlSay"

From Second Life Wiki
Jump to navigation Jump to search
Line 5: Line 5:
|func=llSay
|func=llSay
|sort=Say
|sort=Say
|p1_type=integer
|p1_type=integer|p1_name=channel
|p1_name=channel
|p2_type=string|p2_name=msg
|p2_type=string
|p2_name=msg
|func_desc=Says the text supplied in string '''msg''' on channel supplied in integer '''channel'''.
|func_desc=Says the text supplied in string '''msg''' on channel supplied in integer '''channel'''.
|return_text
|return_text
|spec
|spec
|constants={{LSL Constants/Chat}}
|caveats=*Text can only be a maximum of 1024 bytes.
|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.
*Phrases spoken with llSay can only be heard within 20 meters of the speaking object.

Revision as of 02:57, 28 February 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." );
    }
}

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

Deep Notes

Search JIRA for related Issues

Signature

function void llSay( integer channel, string msg );