LlGetAgentInfo
Function: integer llGetAgentInfo( key id );
Returns an integer bitfield containing the agent information about id.
• key id – avatar UUID that is in the same region
| Constant | Val | Returned if agent... |
|---|---|---|
| AGENT_ALWAYS_RUN | 0x1000 | has running ("Always Run") enabled, or is using tap-tap-hold |
| AGENT_ATTACHMENTS | 0x0002 | has attachments |
| AGENT_AWAY | 0x0040 | is in "away" mode |
| AGENT_BUSY | 0x0800 | is in "busy" mode |
| AGENT_CROUCHING | 0x0400 | is crouching |
| AGENT_FLYING | 0x0001 | is flying |
| AGENT_IN_AIR | 0x0100 | is in the air (hovering) |
| AGENT_MOUSELOOK | 0x0008 | is in mouselook |
| AGENT_ON_OBJECT | 0x0020 | is sitting on an object |
| AGENT_SCRIPTED | 0x0004 | has scripted attachments |
| AGENT_SITTING | 0x0010 | is sitting |
| AGENT_TYPING | 0x0200 | is typing |
| AGENT_WALKING | 0x0080 | is walking |
Caveats
• AGENT_BUSY indicates that the "busy" internal animation is playing, even if the user is not truly in busy mode.
• AGENT_TYPING indicates that the "typing" internal animation is playing, it will not be set if the user disables PlayTypingAnim.
• This function does not return reliable information immediately after a border crossing. Use llGetAnimation instead, if you can. SVC-3177[c]
Examples
| <source lang="lsl">
default { touch_start(integer buf)
{
buf = llGetAgentInfo(llDetectedKey(0));
string out;
if(buf & AGENT_FLYING)
out += "The agent is flying.\n";
else
out += "The agent is not flying.\n";
if(buf & AGENT_ATTACHMENTS)
{
if(buf & AGENT_SCRIPTED)
out += "The agent has scripted attachments.\n";
else
out += "The agent's attachments are unscripted.\n";
}
else
out += "The agent does not have attachments.\n";
if(buf & AGENT_MOUSELOOK)
out += "the agent is in mouselook.";
else
out += "the agent is in normal camera mode.";
llWhisper(0, out);
}
} </source> |
Notes
This is not a good way of testing if an avatar is in the region, use llGetAgentSize instead.
See Also
Functions
• llRequestAgentData
• llGetAnimation
• llGetAnimationList