Osgridadmin: /* Function: llAttachToAvatar( integer attachment ); */

2017-12-30T16:00:58Z

Function: llAttachToAvatar( integer attachment );

New page

==Function: llAttachToAvatar( integer attachment );==
Attaches the object to the avatar who has granted permission to the script. The object is taken into the users inventory and attached to the attach point attachment. 
• integer attachment – ATTACH_* constant or valid value (see the tables below) 

Requires the PERMISSION_ATTACH permission, granted by the owner, to run. 
If attachment is zero, then the object attaches to the attach point it was most recently attached to. 

{|class="wikitable"
|
{| class="wikitable" border=".5" style="text-align:center"
! bgcolor="black" colspan="2" | Constant !! bgcolor="black" style="text-align:center| Comment
|-
|style="text-align:left"| [[LINK_ROOT]] || style="text-align:center"| 1 || style="text-align:left" | sends to root prim in a linked set
|-
|style="text-align:left"| [[ATTACH_HEAD]] || style="text-align:center"| 2 || style="text-align:left" | head
|-
|style="text-align:left"| [[ATTACH_LSHOULDER]] || style="text-align:center"| 3 || style="text-align:left" | left shoulder
|-
|style="text-align:left"| [[ATTACH_RSHOULDER]] || style="text-align:center"| 4 || style="text-align:left" | right shoulder
|-
|style="text-align:left"| [[ATTACH_LHAND]] || style="text-align:center"| 5 || style="text-align:left" | left hand
|-
|style="text-align:left"| [[ATTACH_RHAND]] || style="text-align:center"| 6 || style="text-align:left" | right hand
|-
|style="text-align:left"| [[ATTACH_LFOOT]] || style="text-align:center"| 7 || style="text-align:left" | left foot
|-
|style="text-align:left"| [[ATTACH_RFOOT]] || style="text-align:center"| 8 || style="text-align:left" | right foot
|-
|style="text-align:left"| [[ATTACH_BACK]] || style="text-align:center"| 9 || style="text-align:left" | back
|-
|style="text-align:left"| [[ATTACH_PELVIS]] || style="text-align:center"| 10 || style="text-align:left" | pelvis
|-
|style="text-align:left"| [[ATTACH_MOUTH]] || style="text-align:center"| 11 || style="text-align:left" | mouth
|-
|style="text-align:left"| [[ATTACH_CHIN]] || style="text-align:center"| 12 || style="text-align:left" | chin
|-
|style="text-align:left"| [[ATTACH_LEAR]] || style="text-align:center"| 13 || style="text-align:left" | left ear
|-
|style="text-align:left"| [[ATTACH_REAR]] || style="text-align:center"| 14 || style="text-align:left" | right ear
|-
|style="text-align:left"| [[ATTACH_LEYE]] || style="text-align:center"| 15 || style="text-align:left" | left eye
|-
|style="text-align:left"| [[ATTACH_REYE]] || style="text-align:center"| 16 || style="text-align:left" | right eye
|-
|style="text-align:left"| [[ATTACH_NOSE]] || style="text-align:center"| 17 || style="text-align:left" | nose
|-
|style="text-align:left"| [[ATTACH_RUARM]] || style="text-align:center"| 18 || style="text-align:left" | right upper arm
|-
|style="text-align:left"| [[ATTACH_RLARM]] || style="text-align:center"| 19 || style="text-align:left" | right lower arm
|}
|
{| class="wikitable" border=".5" style="text-align:center"
! bgcolor="black" colspan="2" | Constant !! bgcolor="black" style="text-align:center| Comment
|-
|style="text-align:left"| [[ATTACH_LUARM]] || style="text-align:center"| 20 || style="text-align:left" | left upper arm
|-
|style="text-align:left"| [[ATTACH_LLARM]] || style="text-align:center"| 21 || style="text-align:left" | left lower arm
|-
|style="text-align:left"| [[ATTACH_RHIP]] || style="text-align:center"| 22 || style="text-align:left" | right hip
|-
|style="text-align:left"| [[ATTACH_RULEG]] || style="text-align:center"| 23 || style="text-align:left" | right upper leg
|-
|style="text-align:left"| [[ATTACH_RLLEG]] || style="text-align:center"| 24 || style="text-align:left" | right lower leg
|-
|style="text-align:left"| [[ATTACH_LHIP]] || style="text-align:center"| 25 || style="text-align:left" | left hip
|-
|style="text-align:left"| [[ATTACH_LULEG]] || style="text-align:center"| 26 || style="text-align:left" | left upper leg
|-
|style="text-align:left"| [[ATTACH_LLLEG]] || style="text-align:center"| 27 || style="text-align:left" | left lower leg
|-
|style="text-align:left"| [[ATTACH_BELLY]] || style="text-align:center"| 28 || style="text-align:left" | belly/stomach/tummy
|-
|style="text-align:left"| <strike>ATTACH_RPEC</strike> || style="text-align:center"| 29 || style="text-align:left" | left pectoral
|-
|style="text-align:left"| <strike>ATTACH_LPEC</strike> || style="text-align:center"| 30 || style="text-align:left" | right pectoral
|-
|style="text-align:left"| [[ATTACH_HUD_CENTER_2]] || style="text-align:center"| 31 || style="text-align:left" | HUD Center 2
|-
|style="text-align:left"| [[ATTACH_HUD_TOP_RIGHT]] || style="text-align:center"| 32 || style="text-align:left" | HUD Top Right
|-
|style="text-align:left"| [[ATTACH_HUD_TOP_CENTER]] || style="text-align:center"| 33 || style="text-align:left" | HUD Top
|-
|style="text-align:left"| [[ATTACH_HUD_TOP_LEFT]] || style="text-align:center"| 34 || style="text-align:left" | HUD Top Left
|-
|style="text-align:left"| [[ATTACH_HUD_CENTER_1]] || style="text-align:center"| 35 || style="text-align:left" | HUD Center
|-
|style="text-align:left"| [[ATTACH_HUD_BOTTOM_LEFT]] || style="text-align:center"| 36 || style="text-align:left" | HUD Bottom Left
|-
|style="text-align:left"| [[ATTACH_HUD_BOTTOM]] || style="text-align:center"| 37 || style="text-align:left" | HUD Bottom
|-
|style="text-align:left"| [[ATTACH_HUD_BOTTOM_RIGHT]] || style="text-align:center"| 38 || style="text-align:left" | HUD Bottom Right
|}
|}
 
'''Caveats''' 
• Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event. 
• If the script lacks the permission PERMISSION_ATTACH, the script will shout an error on DEBUG_CHANNEL and the operation fails (but the script continues to run). 
• If PERMISSION_ATTACH is granted by anyone other than the owner, then when the function is called an error will be shouted on DEBUG_CHANNEL. 
• Once the PERMISSION_ATTACH permission is granted there is no way to revoke it. The script will only lose the permission if it is reset or the object derezzed (deleted, detached, or taken). 
• The call will fail if the avatar is not the owner of the object being attached, even if PERMISSION_ATTACH has been properly granted. 
• Two objects cannot be attached to the same attachment point at the same time.
• Objects attached to the head (and any attachment position within the head) will not be visible in First Person view (aka Mouselook) if "show attachments in mouselook" is disable. 
• If attachment is zero but the object was never previously attached, it defaults to the right hand (ATTACH_RHAND). 

'''Examples'''
{|border="1" cellpadding="5" cellspacing="0"
|<source lang="lsl">
//-- rez object on ground, drop in this script, it will request permissions to attach,
//-- and then attach to the left hand if permission is granted. if permission is denied,
//-- then the script complains.
default
{
state_entry()
{
llRequestPermissions( llGetOwner(), PERMISSION_ATTACH );
}

run_time_permissions( integer vBitPermissions )
{
if (PERMISSION_ATTACH & vBitPermissions)
{
llAttachToAvatar( ATTACH_LHAND );
}
else
{
llOwnerSay( "Permission to attach denied" );
}
}

on_rez(integer rez)
{
if(!llGetAttached())
{ //reset the script if it's not attached.
llResetScript();
}
}

attach(key AvatarKey)
{
if(AvatarKey)
{//event is called on both attach and detach, but Key is only valid on attach
integer test = llGetAttached();
if (test) {
llOwnerSay( "The object is attached" );
} else {
llOwnerSay( "The object is not attached");
}
}
}
</source>
|}

See Also 
'''Events''' 
• [[run_time_permissions]] – Permission receiving event 
Functions 
• [[llGetPermissions]] – Get the permissions granted 
• [[llGetPermissionsKey]] – Get the agent who granted permissions 
• [[llRequestPermissions]] – Request permissions 
• [[llDetachFromAvatar]] – Detaches the object from the avatar 
• [[llGetAttached]] – Gets the attach point number 
'''Articles''' 
• [[Script permissions]]

LlAttachToAvatar - Revision history

Osgridadmin: /* Function: llAttachToAvatar( integer attachment ); */