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/2 Bugs

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-91	A		agent_info() event
		SVC-3177	A		llGetAgentInfo() returns unreliable info after a sim border crossing

Tests

•

llGetAgentInfo_Test

Footnotes

1. ^ "Sit here" on the avatar context menu allows ground sits anywhere: atop the terrain, on objects or even in the air, so it is possible to sit "on" an object without linking.

Signature
function integer llGetAgentInfo( key id );