LlGetObjectDetails - Second Life Wiki

LlGetObjectDetails

From Second Life Wiki

Jump to: navigation, search

Contents

Summary

Function: list llGetObjectDetails( key id, list params );
332 Function ID
0.0 Delay
10.0 Energy

Returns a list of the details specified in params for the object with key id.

• key id avatar or prim UUID that is in the same region
• list params OBJECT_* flags

OBJECT_UNKNOWN_DETAIL is returned when passed an invalid integer parameter.

Flags Description Max Length Return Alternatives Local
OBJECT_NAME 1 Gets the prim's name. 63 Characters string llGetObjectName
OBJECT_DESC 2 Gets the prim's description.
If id is an avatar, an empty string is returned.
127 Characters string llGetObjectDesc
OBJECT_POS 3 Gets the prim's position in region coordinates. (36 Characters) vector llGetPos
OBJECT_ROT 4 Gets the prim's rotation. (48 Characters) rotation llGetRot
OBJECT_VELOCITY 5 Gets the object's velocity. (36 Characters) vector llGetVel
OBJECT_OWNER 6 Gets an object's owner key.
If id is an avatar, that avatar's key is returned (which is the same as id).
If id is group-owned, a NULL_KEY is returned.
(36 Characters) key llGetOwner
OBJECT_GROUP 7 Gets the prim's group key.
If id is an avatar, a NULL_KEY is returned.
(36 Characters) key Group
OBJECT_CREATOR 8 Gets the prim's creator key.
If id is an avatar, a NULL_KEY is returned.
(36 Characters) key Creator llGetCreator
Max Lengths in parentheses represent how many characters required when it is typecast to a string.

Caveats

  • Items in params that are not integers are silently ignored, OBJECT_UNKNOWN_DETAIL is not returned.
  • If an object represented by id is not in the sim an empty list is returned.
  • An empty list is also returned if the key given was an item in inventory (object or agent).
  • If id represents an agent, this function will continue to return information for approximately 45 seconds after they have left the sim (but the information is not updated).
  • llTargetOmega will only effect the return of OBJECT_ROT if the object is physical. If the object is not physical then the original start rotation is returned, llTargetOmega is a client side effect.

Search JIRA for related Bugs

Examples

default
{
    collision_start(integer i)
    {
        list a = llGetObjectDetails(llDetectedKey(0), ([OBJECT_NAME, 
                    OBJECT_DESC, OBJECT_POS, OBJECT_ROT, OBJECT_VELOCITY,
                    OBJECT_OWNER, OBJECT_GROUP, OBJECT_CREATOR]));
        llWhisper(0,"UUID: "         + (string)llDetectedKey(0) +
                  "\nName: \""       + llList2String(a,0) + "\"" +
                  "\nDescription: \"" + llList2String(a,1) + "\"" +
                  "\nPosition: "     + llList2String(a,2) +
                  "\nRotation: "     + llList2String(a,3) +
                  "\nVelocity: "     + llList2String(a,4) +
                  "\nOwner: "        + llList2String(a,5) +
                  "\nGroup: "        + llList2String(a,6) +
                  "\nCreator: "      + llList2String(a,7));
    }
}

// Group join inviter
default
{
    touch_start(integer num_detected)
    {
        llInstantMessage(llDetectedKey(0),"Click on Join in my group profile:\n" +
            " secondlife:///app/group/" + llList2String(llGetObjectDetails(llGetKey(), [OBJECT_GROUP]), 0) + "/about ");
    }
}

Useful Snippets

See Link/Get for some link related helper functions. Since there is no function to get linked prim parameters, this can be useful if you need to get the position and rotation of a linked prim.

See Also

Functions

•  llKey2Name
•  llGetPrimitiveParams
•  llSetLinkPrimitiveParams
•  llSetPrimitiveParams
•  llGetParcelDetails

Articles

•  Limits SL limits and constrictions
•  Detected
•  Prim Attribute Overloading

Deep Notes

History

Introduced in SL 1.18.3(2)

Issues

Search JIRA for related Issues

This article wasn't helpful for you? Maybe the related article at the LSL Wiki is able to bring enlightenment.