Difference between revisions of "LlShout"

Revision as of 10:12, 24 May 2008

Function: llShout( integer channel, string msg );

Shouts 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.
Phrases shouted with llShout can only be heard within 100 meters of the speaking object.
A prim can not hear itself, to prevent problems with recursion.

<lsl>default {

   state_entry()
   {
       llShout(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 llShout( integer channel, string msg );

@@ Line 1: / Line 1: @@
-{{LSL_Function
+{{LSL_Function/chat|channel|msg}}{{LSL_Function
 |func_id=24
 |func_sleep=0.0
@@ Line 9: / Line 9: @@
 |func_desc=Shouts the text supplied in string '''msg''' on channel supplied in integer '''channel'''.
 |spec
-|constants={{LSL Constants/Chat}}
+|constants
 |caveats=*Text can only be a maximum of 1024 bytes.
 *Phrases shouted with llShout can only be heard within 100 meters of the speaking object.
@@ Line 20: / Line 20: @@
      }
 }</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]]|}}