Difference between revisions of "LlWhisper"

Revision as of 20:50, 1 October 2008

Function: llWhisper( integer channel, string msg );

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

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

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.

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.
Text can only be a maximum of 1024 bytes.
Whispers can only be heard within 10 meters of the speaking prim.
A prim can not hear itself, to prevent problems with recursion.

<lsl>default {

   state_entry()
   {
       llWhisper(0,"This is an incredibly useless program." );
   }

}</lsl>

For communicating with the user or owner it is much better to use llDialog, llOwnerSay or llInstantMessage as they won't spam other users.

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

Signature
function void llWhisper( integer channel, string msg );

@@ Line 12: / Line 12: @@
 |constants
 |caveats=*Text can only be a maximum of 1024 bytes.
-*Whispers can only be heard within 10 meters of the speaking object.
+*Whispers can only be heard within 10 meters of the speaking prim.
 *A prim can '''not''' hear itself, to prevent problems with recursion.
 |examples=<lsl>default