Difference between revisions of "LlAvatarOnSitTarget"

From Second Life Wiki
Jump to navigation Jump to search
m
m (added example)
Line 6: Line 6:
|caveats=If the prim lacks a sit target or the avatar is seated upon a different prim, the only way to determin how many and which avatars are seated upon the object is to scan the link set.
|caveats=If the prim lacks a sit target or the avatar is seated upon a different prim, the only way to determin how many and which avatars are seated upon the object is to scan the link set.
|spec
|spec
|examples=<lsl>
|examples=<pre>
default
default
{
{
Line 23: Line 23:
     }
     }
}
}
</lsl>
</pre>
|helpers=<pre>
|helpers=<pre>
//Gets the link number of a seated avatar
//Gets the link number of a seated avatar

Revision as of 07:17, 9 May 2007

Summary

Function: key llAvatarOnSitTarget( );
0.0 Forced Delay
10.0 Energy

Returns a key that is the key of the user seated on the prim.

If the prim lacks a sit target or there is no avatar sitting on the prim, then 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 determin how many and which avatars are seated upon the object is to scan the link set.

Examples

default
{
    state_entry()
    {
        // set sit target, otherwise this will not work 
        llSitTarget(<0,0,.1>, ZERO_ROTATION);
    }

    changed(integer chance) {
        if (change & CHANGED_LINK) { 
            if (llAvatarOnSitTarget() != NULL_KEY) {
                llSay(0, "Hello " + llKey2Name(llAvatarOnSitTarget()) + ", thank you for sitting down");
            }
        }
    }
}

Useful Snippets

//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 )))
        if(avatar == linkKey)//It's an avatar, 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

See Also

Events

•  changed

Functions

•  llSitTarget

Deep Notes

Signature

function key llAvatarOnSitTarget();