Second Life Wiki - User contributions [en]

Link message

2009-08-16T02:31:34Z

Giuliani Rossini:

{{LSL_Event|event_id=29|event_delay|event=link_message
|p1_type=integer|p1_name=sender_num|p1_desc=The link number of the prim that contained the script that called [[llMessageLinked]].
|p2_type=integer|p2_name=num|p2_desc=Second parameter of the llMessageLinked call.
|p3_type=string|p3_name=str|p3_desc=Third parameter of the llMessageLinked call.
|p4_type=key|p4_name=id|p4_desc=Fourth parameter of the llMessageLinked call.
|event_desc=Triggered when the script receives a link message that was sent by a call to [[llMessageLinked]]. llMessageLinked is used to send messages from one script to another.
|event_footnote='''id''' is often used as a second string field (in LSL the [[key]] type is implemented as a [[string]] with just custom operators). [[typecast|Typecasting]] between [[string]] and [[key]] types has no effect on the data contained. The sizes of '''str''' and '''id''' are only limited by available script memory.
|constants
|spec
|caveats=*64 link_message events can queue, past that, they are silently dropped! Don't do too much in the event if they might be coming in fast.
*'''sender_num''' does not reflect how a message was sent, there is no way to know if it was sent with a LINK_* flag or the [[llGetLinkNumber|specific link number]].
*If '''str''' and '''id''' are bigger than available memory the script will crash with a Stack-Heap Collision.
|examples=
<lsl>
//This is just an example script, you shouldn't handle touches within single script this way.

default
{
touch_start(integer c)
{
llMessageLinked(LINK_THIS, 0, llDetectedName(0), llDetectedKey(0));
}
link_message(integer source, integer num, string str, key id)
{
llWhisper(0, str + " (" + (string)id + ") touched me!");
}
}
</lsl>
|helpers=
<lsl>
// This is just an example script, you shouldn't handle link message within single script this way.

default{ // To propagate an unlimited number of arguments of any type.
// Presumed, the separator string isn't used in any source string!
state_entry() {
list my_list = [1, 2.0, "a string", <1, 2, 3>, <1, 2, 3, 4>, llGetOwner()];
string list_parameter = llDumpList2String(my_list, "|"); // Typecast list to a string
llMessageLinked(LINK_THIS, 0, list_parameter, NULL_KEY)
}

link_message(integer sender_num, integer num, string list_argument, key id) {
list re_list = llParseString2List(list_argument, ["|"], [""]); // Typecast string back to a list
}
}
</lsl>
|also_header
|also_events
|also_functions={{LSL DefineRow||[[llMessageLinked]]}}
|also_articles
|also_footer
|notes=A script can hear its own link messages.
|mode
|cat1=Link
|cat2=Communications
|cat3=Link Message
|cat4
}}

LlAvatarOnSitTarget

2007-08-14T01:43:18Z

Giuliani Rossini: sp

{{LSL_Function|func_id=239|func_sleep=0.0|func_energy=10.0
|func=llAvatarOnSitTarget
|return_type=key
|return_text=that is the [[UUID]] of the user seated on the prim.
|func_footnote=If the prim lacks a sit target or there is no avatar sitting on the prim, then {{LSLG|NULL_KEY}} is returned.
|caveats=If the prim lacks a sit target or the avatar is seated upon a different prim, the only way to determine how many and which avatars are seated upon the object is to scan the link set.
|spec
|examples=<pre>
default
{
state_entry()
{
// set sit target, otherwise this will not work
llSitTarget(<0.0, 0.0, 0.1>, ZERO_ROTATION);
}

changed(integer change) {
if (change & CHANGED_LINK) {
key av = llAvatarOnSitTarget();
if (av) {//evaluated as true if not NULL_KEY or invalid
llSay(0, "Hello " + llKey2Name(av) + ", thank you for sitting down");
}
}
}
}
</pre>
|helpers=<pre>
//Gets the link number of a seated avatar
integer GetAgentLinkNumber(key avatar)
{
integer linkNum = 1 + llGetNumberOfPrims();
key linkKey;
//Next we get the linkKey and make sure it's not null, if it's null we are done.
while((linkKey = llGetLinkKey( --linkNum )))//is the key valid?
if(avatar == linkKey)//is it the avatar we want?
return linkNum;//It's the avatar we want so return.
//avatar wasn't found so return a number that isn't a LINK_* flag that can't be a valid link number either.
return 0x7FFFFFFF;//max int.
}//Written by Strife Onizuka
</pre>
|related
|also_tests
|also_events={{LSL DefineRow||{{LSLG|changed}}|}}
|also_functions={{LSL DefineRow||{{LSLG|llSitTarget}}|}}
|also_articles
|notes
|cat1=Avatar
|cat2=Prim
|cat3=Sit
|cat4
}}

LlSound

2007-06-30T07:45:33Z

Giuliani Rossini: spelling

{{LSL_Function/inventory|sound|uuid=true|type=sound|volume=volume}}{{LSL_Function
|func_id=85|func_sleep=0.0|func_energy=10.0
|func=llSound
|p1_type=string|p1_name=sound
|p2_type=float|p2_name=volume
|p3_type=integer|p3_name=queue|p3_desc=boolean, whether or not to queue the song ({{LSLG|TRUE}}) or interrupt the playing song ({{LSLG|FALSE}}).
|p4_type=integer|p4_name=loop|p4_desc=boolean, whether or not to loop the song.
|func_footnote
|func_desc=Plays '''sound''' at '''volume''' and whether it should '''loop''' or not.
|return_text
|spec
|caveats
|constants
|examples
|helpers
|also_functions
|also_events
|also_tests
|also_articles
|notes
|deprecated=llPlaySound
|cat1=Sound
|cat2
|cat3
|cat4
}}

Build clothing

2007-03-24T17:54:18Z

Giuliani Rossini: sp

{{OSWikiFeatureNav}}
=== Feature Design Document ===
Clothing are asset that can be worn on the avatar. They each have at least one texture swatch, a color swatch, some modification sliders, and a unique Inventory icon.

[[Undershirt]]

[[Shirt]]

[[Underpants]]

[[Pants]]

[[Jacket]]

[[Gloves]]

[[Socks]]

[[Shoes]]

[[Dress]]

=== Functional Spec ===
(none)

=== Test scripts ===
(none)

=== Discussion for future improvements ===
(none)

=== Relationship to other features ===
<b> List of features that need to be tested when this feature changes, and why. </b>

(none)

=== User Guides ===
(none)