Difference between revisions of "LlSitTarget"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
m |
|||
Line 1: | Line 1: | ||
{{LSL_Function | {{LSL_Function | ||
|func_id=238 | |func_id=238|func_sleep=0.0|func_energy=10.0 | ||
|sort=SitTarget | |sort=SitTarget | ||
|func=llSitTarget | |func=llSitTarget | ||
Line 13: | Line 13: | ||
**It will appear to be removed if the [[llSetSitText]] is set to a space " ". | **It will appear to be removed if the [[llSetSitText]] is set to a space " ". | ||
*Attachments cannot be sat upon. | *Attachments cannot be sat upon. | ||
*[[llSitTarget]] does not update position of an already seated avatar. | |||
**[[#UpdateSitTarget|UpdateSitTarget]] described below works around this problem. It works by converting the sit target information into a link position that can be passed along to [[llSetLinkPrimitiveParams]]. | |||
|constants | |constants | ||
|examples= | |examples= | ||
Line 25: | Line 27: | ||
<lsl>//Sets / Updates the sit target moving the avatar on it if necessary. | <lsl>//Sets / Updates the sit target moving the avatar on it if necessary. | ||
UpdateSitTarget(vector pos, rotation rot) | UpdateSitTarget(vector pos, rotation rot) | ||
{ | {//Using this while a vehicle is moving may give unpredictable results. | ||
llSitTarget(pos, rot);//Set the sit target | llSitTarget(pos, rot);//Set the sit target | ||
key user = llAvatarOnSitTarget(); | key user = llAvatarOnSitTarget(); | ||
Line 64: | Line 66: | ||
{//WARNING: llGetObjectDetails can introduce an error that goes as far as the 5th decimal place! | {//WARNING: llGetObjectDetails can introduce an error that goes as far as the 5th decimal place! | ||
//This is highly unlikely to be ever noticed unless compounded over time. | //This is highly unlikely to be ever noticed unless compounded over time. | ||
//Do not use while moving (like in a moving vehicle)!!! | |||
vector tp = llGetAgentSize(av); | vector tp = llGetAgentSize(av); | ||
if(tp) | if(tp) |
Revision as of 04:14, 24 April 2008
LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llSitTarget( vector offset, rotation rot );238 | Function ID |
0.0 | Forced Delay |
10.0 | Energy |
Set the sit location for this object.
• vector | offset | – | Position local to the prims position and rotation | |
• rotation | rot | – | Additional rotation for the sit target at the local position. |
If offset == <0.0, 0.0, 0.0> then the sit target is removed.
Caveats
- Once a sit target is removed llAvatarOnSitTarget will only return NULL_KEY.
- There is no way to remove the Sit option from the pie menu.
- It will appear to be removed if the llSetSitText is set to a space " ".
- Attachments cannot be sat upon.
- llSitTarget does not update position of an already seated avatar.
- UpdateSitTarget described below works around this problem. It works by converting the sit target information into a link position that can be passed along to llSetLinkPrimitiveParams.
Examples
<lsl>default {
state_entry() { llSitTarget(<0.0, 0.0, 1.0>, ZERO_ROTATION); //The vector's components must not all be set to 0 for effect to take place. }}</lsl>
Useful Snippets
UpdateSitTarget
<lsl>//Sets / Updates the sit target moving the avatar on it if necessary. UpdateSitTarget(vector pos, rotation rot) {//Using this while a vehicle is moving may give unpredictable results.
llSitTarget(pos, rot);//Set the sit target key user = llAvatarOnSitTarget(); if(user)//true if there is a user seated on the sittarget, if so update their position { vector size = llGetAgentSize(user); if(size)//This tests to make sure the user really exists. { //We need to make the position and rotation local to the current prim rotation localrot = ZERO_ROTATION; vector localpos = ZERO_VECTOR; if(llGetLinkNumber() > 1)//only need the local rot if it's not the root. { localrot = llGetLocalRot(); localpos = llGetLocalPos(); } pos.z += 0.4; integer linkNum = llGetNumberOfPrims(); do{ if(user == llGetLinkKey( linkNum ))//just checking to make sure the index is valid. { llSetLinkPrimitiveParams(linkNum, [PRIM_POSITION, ((pos - (llRot2Up(rot) * size.z * 0.02638)) * localrot) + localpos, PRIM_ROTATION, rot * localrot / llGetRootRotation()]); jump end;//cheaper but a tad slower then return } }while( --linkNum ); } else {//It is rare that the sit target will bork but it does happen, this can help to fix it. llUnSit(user); } } @end;
}//Written by Strife Onizuka, size adjustment provided by Escort DeFarge</lsl>
GetSitTarget
<lsl>list GetSitTarget(integer prim, key av) {//WARNING: llGetObjectDetails can introduce an error that goes as far as the 5th decimal place!
//This is highly unlikely to be ever noticed unless compounded over time. //Do not use while moving (like in a moving vehicle)!!! vector tp = llGetAgentSize(av); if(tp) { if(prim == LINK_THIS)//llGetLinkKey doesn't like LINK_THIS prim = llGetLinkNumber(); list details = [OBJECT_POS, OBJECT_ROT]; rotation f = llList2Rot(details = (llGetObjectDetails(llGetLinkKey(prim), details) + llGetObjectDetails(av, details)), 1); rotation r = llList2Rot(details, 3) / f;
return [((llList2Vector(details, 2) - llList2Vector(details, 0)) / f) + (llRot2Up(r) * tp.z * 0.02638) - <0.0, 0.0, 0.4>, r]; } return [];
}//Written by Strife Onizuka</lsl>