LlGetAgentSize

Returns a vector that is the size of the requested avatar by id.

ZERO_VECTOR is returned if id is not in the region or if it is not an avatar.

Search JIRA for related Bugs

//A simple script that makes a box hover above the owner's head.
default {
    state_entry(integer i) {
        key owner = llGetOwner();
        vector pos = llList2Vector(llGetObjectDetails(owner, [OBJECT_POS]),0);
        vector agent = llGetAgentSize(owner);
        pos.z += 0.5 + agent.z / 2;//"pos" needs to be adjusted so it appears above the owner.
        if(agent)//makes sure it found the owner, a zero vector evaluates as false
            llSetPos(pos);
    }
    touch_start(integer num) {
        llResetScript();
    }
}

• This function is a good way to quickly test...
  • if an avatar is in the same region.
  • if a UUID known to be in the region is an avatar.

To use this function to test either case use as follows

if(llGetAgentSize(uuid)) {
    //uuid is an avatar in the region
} else {
    //uuid is not an avatar in the region
}

• The returned vector holds the size of the avatar's bounding box^[1], of which only the height (z) varies. Width (x) and depth (y) are constant. (0.45m and 0.6m respectively).

Functions

Issues

Footnotes