Difference between revisions of "LlWhisper"

Revision as of 10:10, 24 May 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 object.
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 1: / Line 1: @@
-{{LSL_Function
+{{LSL_Function/chat|channel|msg}}{{LSL_Function
 |func_id=22
 |func_sleep=0.0
@@ Line 7: / Line 7: @@
 |p1_type=integer|p1_name=channel
 |p2_type=string|p2_name=msg
-|func_desc=whispers the text supplied in string '''msg''' on channel supplied in integer '''channel'''.
+|func_desc=Whispers the text supplied in string '''msg''' on channel supplied in integer '''channel'''.
 |return_text
 |spec
-|constants={{LSL Constants/Chat}}
+|constants
 |caveats=*Text can only be a maximum of 1024 bytes.
 *Whispers can only be heard within 10 meters of the speaking object.
@@ Line 21: / Line 21: @@
      }
 }</lsl>
-To avoid making your object spam its neighborhood, use llOwnerSay or llInstantMessage.
+For communicating with the user or owner it is much better to use [[llDialog]], [[llOwnerSay]] or [[llInstantMessage]] as they won't spam other users.
 |helpers
 |also_events={{LSL DefineRow||[[listen]]|}}