llParcelSay

From Second Life Wiki
Revision as of 23:24, 2 August 2008 by Strife Onizuka (talk | contribs)
Jump to navigation Jump to search
Emblem-important-yellow.png LSL Feature Request
The described function does not exist. This article is a feature request.

Summary

Function: llParcelSay( integer channel, string msg );
0.0 Forced Delay
10.0 Energy

Says the string msg on channel number channel that can be heard anywhere in the parcel by an agent (when on the PUBLIC_CHANNEL) or by a script listening on channel.

• integer channel output chat channel, any integer value
• string msg message to be transmitted

Regardless of where the prim is, the message will not travel over parcel borders.

See: SVC-1224

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

  • Messages sent on channel zero[1] and DEBUG_CHANNEL are throttled to a rate of <200/10sec, per region, per owner/user.
    • Once the rate is exceeded, all following messages on channel zero or DEBUG_CHANNEL will be dropped until the send rate is again below 200/10sec for the previous 10 sec. Dropped messages, despite being dropped still count against the limit.
  • If msg is longer than 1023 bytes it is truncated to 1023 bytes.
  • A prim can not hear itself, to prevent problems with recursion.

Examples

<lsl>default {

   state_entry()
   {
       llParcelSay(0, "Abandon ship! This is not a drill!" );
   }
}</lsl>

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., <lsl> llParcelSay(-654321, "light on");</lsl> 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).

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

See Also

Events

•  listen

Functions

•  llListen
•  llOwnerSay Sends chat to the owner only
•  llWhisper Sends chat limited to 10 meters
•  llSay Sends chat limited to 20 meters
•  llShout Sends chat limited to 100 meters
•  llRegionSay Sends chat region wide
•  llInstantMessage
•  llDialog
•  llTextBox

Deep Notes

Footnotes

  1. ^ Channel zero is also known as: PUBLIC_CHANNEL, open chat, local chat and public chat

Signature

//function void llParcelSay( integer channel, string msg );