llGetAttachedListFiltered

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/fr Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ja Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

GetAttachedListFiltered

llGetAttachedListFiltered

Summary

Function: list llGetAttachedListFiltered( key avatar, list options );

0.0	Forced Delay
10.0	Energy

Returns a list of object keys corresponding to public attachments worn by an avatar in the order they were attached.

• key	avatar	–	avatar UUID that is in the same region
• list	options

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.

Specification

Returns a list of attachments on the avatar.

By default this function will return all attachments on all attachment points. A script may specify multiple FILTER_INCLUDE options which will limit the returned attachments to only those listed.

If the script specifies the FILTER_FLAGS option with FILTER_FLAG_HUDS this function will include any attached HUDs if the following conditions are met:

• The script must be compiled with an experience
• The experience must be active in the region
• The avatar must have accepted the experience
• The HUD must include at least one script that was also compiled with the same experience.

Parameter		Format		Description
[ FILTER_INCLUDE ]	1	[ FILTER_INCLUDE, integer attachment_point ]		Include attachments on the specified attachment point in the returned results. This parameter may occur multiple times. If it is omitted the function returns attachments on all attachment points.
[ FILTER_FLAGS ]	2	[ FILTER_FLAGS, integer flags ]		Flags to control filter behavior. Parameter Description [ FILTER_FLAG_HUDS ] 0x0001 Include HUDs in the returned result.

Note: Constants in italic require a viewer compatible with the Project Bento skeleton.

Body Constant # Name Comment ATTACH_HEAD 2 Skull head ATTACH_NOSE 17 Nose nose ATTACH_MOUTH 11 Mouth mouth ATTACH_FACE_TONGUE 52 Tongue tongue ATTACH_CHIN 12 Chin chin ATTACH_FACE_JAW 47 Jaw jaw ATTACH_LEAR 13 Left Ear left ear ATTACH_REAR 14 Right Ear right ear ATTACH_FACE_LEAR 48 Alt Left Ear left ear (extended) ATTACH_FACE_REAR 49 Alt Right Ear right ear (extended) ATTACH_LEYE 15 Left Eye left eye ATTACH_REYE 16 Right Eye right eye ATTACH_FACE_LEYE 50 Alt Left Eye left eye (extended) ATTACH_FACE_REYE 51 Alt Right Eye right eye (extended) ATTACH_NECK 39 Neck neck ATTACH_LSHOULDER 3 Left Shoulder left shoulder ATTACH_RSHOULDER 4 Right Shoulder right shoulder ATTACH_LUARM 20 L Upper Arm left upper arm ATTACH_RUARM 18 R Upper Arm right upper arm ATTACH_LLARM 21 L Lower Arm left lower arm ATTACH_RLARM 19 R Lower Arm right lower arm ATTACH_LHAND 5 Left Hand left hand ATTACH_RHAND 6 Right Hand right hand ATTACH_LHAND_RING1 41 Left Ring Finger left ring finger ATTACH_RHAND_RING1 42 Right Ring Finger right ring finger ATTACH_LWING 45 Left Wing left wing ATTACH_RWING 46 Right Wing right wing ATTACH_CHEST 1 Chest chest/sternum ATTACH_LEFT_PEC 29 Left Pec left pectoral ATTACH_RIGHT_PEC 30 Right Pec right pectoral ATTACH_BELLY 28 Stomach belly/stomach/tummy ATTACH_BACK 9 Spine back ATTACH_TAIL_BASE 43 Tail Base tail base ATTACH_TAIL_TIP 44 Tail Tip tail tip ATTACH_AVATAR_CENTER 40 Avatar Center avatar center/root ATTACH_PELVIS 10 Pelvis pelvis ATTACH_GROIN 53 Groin groin ATTACH_LHIP 25 Left Hip left hip ATTACH_RHIP 22 Right Hip right hip ATTACH_LULEG 26 L Upper Leg left upper leg ATTACH_RULEG 23 R Upper Leg right upper leg ATTACH_RLLEG 24 R Lower Leg right lower leg ATTACH_LLLEG 27 L Lower Leg left lower leg ATTACH_LFOOT 7 Left Foot left foot ATTACH_RFOOT 8 Right Foot right foot ATTACH_HIND_LFOOT 54 Left Hind Foot left hind foot ATTACH_HIND_RFOOT 55 Right Hind Foot right hind foot

HUD Constant Comment ATTACH_HUD_CENTER_2 31 HUD Center 2 ATTACH_HUD_TOP_RIGHT 32 HUD Top Right ATTACH_HUD_TOP_CENTER 33 HUD Top ATTACH_HUD_TOP_LEFT 34 HUD Top Left ATTACH_HUD_CENTER_1 35 HUD Center ATTACH_HUD_BOTTOM_LEFT 36 HUD Bottom Left ATTACH_HUD_BOTTOM 37 HUD Bottom ATTACH_HUD_BOTTOM_RIGHT 38 HUD Bottom Right Special Constant Comment ATTACH_ANY_HUD -1 A special constant representing all HUD attachment points when filtering.

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

default
{
    state_entry()
    {
        list attachments = llGetAttachedListFiltered(llGetOwner(), [FILTER_INCLUDE, ATTACH_RHAND]);

        // Object UUIDs:
        llOwnerSay(llList2CSV(attachments));

        // Object names:
        integer i;
        integer max = llGetListLength(attachments);
        for (i = 0; i < max; ++i)
        {
            string name = llList2String(attachments, i);
            llOwnerSay(llKey2Name(name));
        }
    }
}

See Also

Events

•

attach

Functions

•	llGetAttachedList
•	llGetAttached
•	llGetAttachedList
•	llAttachToAvatar
•	llDetachFromAvatar
•	llAttachToAvatar
•	llGetObjectDetails	–	OBJECT_ATTACHED_POINT

Deep Notes

Signature
function list llGetAttachedListFiltered( key avatar, list options );