Osgridadmin: /* Function: key llAvatarOnSitTarget( ); */

2017-12-30T16:02:24Z

Function: key llAvatarOnSitTarget( );

New page

==Function: key llAvatarOnSitTarget( );==
Returns a key that is the UUID 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'''
• A prim does not have a sit target unless [[llSitTarget]] has been called with a nonzero vector as the first argument. 
• 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 (for an example of this, see [[llGetNumberOfPrims]]). 

'''Examples'''
{|border="1" cellpadding="5" cellspacing="0"
|<source lang="lsl">
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");
}
}
}
}
</source>
|}

'''Useful Snippets'''
{|border="1" cellpadding="5" cellspacing="0"
|<source lang="lsl">
//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 not found
//return a number that isn't a LINK_* flag not a valid link number either.
return 0x7FFFFFFF;//max int.
}//Written by Strife Onizuka
</source>
|}
 
'''Notes'''
The position of an avatar on a sit target can be determined with the use of llGetObjectDetails (see llSitTarget for an example). 

See Also 
'''Events''' 
• [[changed]] 
'''Functions''' 
• [[llSitTarget]] 
• [[llGetLinkKey]] 
'''Articles''' 
• [[CHANGED_LINK]]

LlAvatarOnSitTarget - Revision history

Osgridadmin: /* Function: key llAvatarOnSitTarget( ); */