LlGetAgentInfo

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it 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/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

GetAgentInfo

llGetAgentInfo

Summary

1 Bug

Function: integer llGetAgentInfo( key id );

206	Function ID
0.0	Forced Delay
10.0	Energy

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_AUTOPILOT	0x2000	is in "autopilot" mode
AGENT_AWAY	0x0040	is in "away" mode
AGENT_BUSY	0x0800	is in "busy" mode
AGENT_CROUCHING	0x0400	is crouching
AGENT_FLYING	0x0001	is flying or hovering
AGENT_IN_AIR	0x0100	is in the air (jumping, flying or falling)
AGENT_MOUSELOOK	0x0008	is in mouselook
AGENT_ON_OBJECT	0x0020	is sitting on an object (and linked to it)[1]
AGENT_SCRIPTED	0x0004	has scripted attachments
AGENT_SITTING	0x0010	is sitting
AGENT_TYPING	0x0200	is typing
AGENT_WALKING	0x0080	is walking, running or crouch walking

Caveats

• AGENT_BUSY indicates that the "busy" internal animation is playing, even if the user is not truly in busy mode.
• On server 1.40 and below, AGENT_TYPING indicated that the "type" internal animation is playing, it would not be set if the user disabled PlayTypingAnim. On server 1.42 and up, it reflects typing start/stop messages from the client and does not depend on the animation. If the old behavior is desired, use llGetAnimationList and look for c541c47f-e0c0-058b-ad1a-d6ae3a4584d9 ^SVC-787
• AGENT_ALWAYS_RUN|AGENT_WALKING indicates that the user requested to run using standard viewer controls. Use llGetAnimation to also detect running caused by physics.
• This function does not return reliable information immediately after a border crossing. Use llGetAnimation instead, if you can. ^SVC-3177

Important Issues

~ All Issues ~ Search JIRA for related Bugs

SVC-3177

A

llGetAgentInfo() returns unreliable info after a sim border crossing

Examples

<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);
   }

}

</lsl>

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

Deep Notes

History

• AGENT_AUTOPILOT was added in SVN:2900 r136439 Trunk s:1.33.0

All Issues

~ Search JIRA for related Issues

SVC-3177

A

llGetAgentInfo() returns unreliable info after a sim border crossing

Tests

•

llGetAgentInfo_Test

Footnotes

1. ^ Snowglobe and many alternate viewers allow ground sits anywhere, atop the terrain, objects or even in the air, so it is possible to sit on an object without linking.

Signature
function integer llGetAgentInfo( key id );