list llGetObjectDetails(key id, list params)
Returns details of the object with the key id specified in the params list.
The details are returned inside a list in the same order as the parameters are given. The value OBJECT_UNKNOWN_DETAIL is returned inside the list for an unknown parameter given.
Notes:
- If one value of the list params is not an integer, that value is silently ignored and OBJECT_UNKNOWN_DETAIL is not returned.
- The function is Simulator-Local. It will not return results on input-keys in other simulators.
- This function was first introduced with SL 1.18.3.
- This function can be used in combination with llGetLinkKey to determine the parameters of a child prim in a linked object.
Parameters
Query | List Entry Type | Object Application | Agent Application |
OBJECT_NAME | string | Returns object name. Similar to llKey2Name | Returns agent name. Similar to llKey2Name |
OBJECT_DESC | string | Returns object description. | Returns empty string. |
OBJECT_POS | vector | Returns object position. | Returns agent position. |
OBJECT_ROT | rotation | Returns object rotation. | Returns agent rotation. |
OBJECT_VELOCITY | vector | Returns object velocity. | Returns agent velocity. |
OBJECT_OWNER | key | Returns the key of the object owner.
Returns NULL_KEY if deeded to a group. |
Returns agent key (identical to input key id) |
OBJECT_GROUP | key | Returns the key of the object’s set group. | Returns NULL_KEY. |
OBJECT_CREATOR | key | Returns the key of the object creator. | Returns NULL_KEY. |
OBJECT_RUNNING_SCRIPT_COUNT | integer | Returns the number of running scripts on the object. | Returns the number of running scripts inside all of the agent’s attachments. |
OBJECT_TOTAL_SCRIPT_COUNT | integer | Returns the total number of scripts, running or not, on the object. | Returns the total number of scripts, running or not, inside all of the agent’s attachments. |
OBJECT_SCRIPT_MEMORY | integer | Returns the maximum script memory that might be used by the object. | Returns the maximum script memory that might be used by all of the agent’s attachments. |
Example:
list params = llGetObjectDetails(id, [OBJECT_NAME, OBJECT_POS, OBJECT_OWNER]);