Difference between revisions of "LlSay"

From Second Life Wiki
Jump to navigation Jump to search
m (LSL llSay moved to LlSay: removing prefix)
Line 9: Line 9:
|p2_type=string
|p2_type=string
|p2_name=msg
|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
|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. An object can '''not''' hear itself, to prevent problems with recursion.
|caveats=*Text can only be a maximum of 1024 bytes.
|examples=<lsl>
*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.
|examples=<pre>
default {
default {
     state_entry()
     state_entry()
Line 20: Line 22:
     }
     }
}
}
</lsl>
</pre>
|helpers
|helpers
|also_events=*{{LSLG|listen}}
|also_events=*{{LSLG|listen}}
Line 30: Line 32:
|notes=If one object 'says' something to another object (e.g., a button that, when touched,
|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.,
turns on a lamp), it is a good idea to use a very negative channel, e.g.,
<lsl>
<pre>
     llSay(-5243212,"turn on");
     llSay(-5243212,"turn on");
</lsl>
</pre>
It is impossible for an avatar to chat on a negative channel, and extremely unlikely that some
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
other object would accidently say something on such a channel. (Of course, the intended target

Revision as of 23:54, 20 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

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 );