Difference between revisions of "LlGetAgentInfo"
Jump to navigation
Jump to search
(AGENT_AUTOPILOT) |
(clarify that sitting on object measn the linked kind) |
||
| Line 55: | Line 55: | ||
{{!}}{{#var:comment}} | {{!}}{{#var:comment}} | ||
{{!}}- | {{!}}- | ||
{{!}}{{LSL Const|AGENT_ON_OBJECT|integer|hex=0x0020|32|c=is sitting on an object}} | {{!}}{{LSL Const|AGENT_ON_OBJECT|integer|hex=0x0020|32|c=is sitting on an object (and linked to it)}}{{Footnote|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.}} | ||
{{!}}{{#var:value}} | {{!}}{{#var:value}} | ||
{{!}}{{#var:comment}} | {{!}}{{#var:comment}} | ||
Revision as of 19:13, 26 June 2010
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: integer llGetAgentInfo( key 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[1] | 0x0020 | is sitting on an object (and linked to it) |
| 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.
- AGENT_TYPING indicates that the "typing" internal animation is playing, it will not be set if the user disables PlayTypingAnim.
- 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
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
Tests
| • | llGetAgentInfo_Test |
Footnotes
- ^ 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 ); |