Difference between revisions of "LlGetAttachedList"
Jump to navigation
Jump to search
m (Documented this function's return of ["NOT ON REGION"] & ["NOT FOUND"].) |
Simon Linden (talk | contribs) |
||
(2 intermediate revisions by 2 users not shown) | |||
Line 8: | Line 8: | ||
|func_desc | |func_desc | ||
|p1_type=key|p1_name=avatar|p1_desc | |p1_type=key|p1_name=avatar|p1_desc | ||
|return_type=list|return_text=of public attachments worn by an {{LSLPT|avatar}}. | |return_type=list|return_text=of object keys corresponding to public attachments worn by an {{LSLPT|avatar}}. | ||
|func_footnote=By design HUD attachment keys are not reported by this function.<br/> <br/> | |func_footnote=By design HUD attachment keys are not reported by this function.<br/> <br/> | ||
If avatar is a child agent, ["NOT ON REGION"] is returned.<br/> | If avatar is a child agent, ["NOT ON REGION"] is returned.<br/> | ||
If avatar is not a main agent and not a child agent or not an agent at all, ["NOT FOUND"] is returned. | If avatar is not a main agent and not a child agent or not an agent at all, ["NOT FOUND"] is returned. | ||
|spec | |spec | ||
|caveats | |caveats=<br> | ||
When an avatar first arrives in a region, there is a brief period when their attachments are not yet fully rezzed or added. During this time, those attachments will not appear in the results. | |||
</br></br> | |||
|examples=<source lang="lsl2"> | |examples=<source lang="lsl2"> | ||
// Touch to list all attachments | // Touch to list all attachments | ||
Line 36: | Line 37: | ||
</source> | </source> | ||
|spec | |spec | ||
|helpers | |helpers | ||
|also_functions={{LSL DefineRow||[[llGetAttached]]}} | |also_functions={{LSL DefineRow||[[llGetAttached]]}} |
Revision as of 11:36, 2 January 2024
LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: list llGetAttachedList( key avatar );Returns a list of object keys corresponding to public attachments worn by an avatar.
• key | avatar | – | avatar UUID that is in the same region |
By design HUD attachment keys are not reported by this function.
If avatar is a child agent, ["NOT ON REGION"] is returned.
If avatar is not a main agent and not a child agent or not an agent at all, ["NOT FOUND"] is returned.
Caveats
When an avatar first arrives in a region, there is a brief period when their attachments are not yet fully rezzed or added. During this time, those attachments will not appear in the results.
Examples
// Touch to list all attachments
default
{
touch_start(integer total_number)
{
list AttachedNames;
list AttachedUUIDs = llGetAttachedList(llDetectedKey(0));
integer i;
while (i < llGetListLength(AttachedUUIDs) )
{
list temp = llGetObjectDetails(llList2Key(AttachedUUIDs,i),[OBJECT_NAME]);
AttachedNames += [llList2String(temp,0)];
++i;
}
llSay(PUBLIC_CHANNEL,"\n" + llDumpList2String(AttachedNames,"\n"));
}
}
See Also
Events
• | attach |
Functions
• | llGetAttached | |||
• | llAttachToAvatar | |||
• | llDetachFromAvatar | |||
• | llAttachToAvatar | |||
• | llGetObjectDetails | – | OBJECT_ATTACHED_POINT |