Difference between revisions of "LlGetAgentInfo"
Jump to navigation
Jump to search
m (I had a script that I build mysel A to Z whit commants insides) |
m |
||
| (21 intermediate revisions by 7 users not shown) | |||
| Line 1: | Line 1: | ||
{{Issues/SVC-3177}}{{LSL Function/avatar|id|sim=*}} | {{LSL_Function | ||
|inject-2={{Issues/SVC-91}}{{Issues/SVC-3177}}{{LSL Function/avatar|id|sim=*}} | |||
|func=llGetAgentInfo | |func=llGetAgentInfo | ||
|sort=GetAgentInfo | |sort=GetAgentInfo | ||
|func_id=206|func_sleep=0.0|func_energy=10.0 | |func_id=206|func_sleep=0.0|func_energy=10.0 | ||
|return_type=integer|p1_type=key|p1_name=id | |return_type=integer|return_subtype=bit field | ||
|p1_type=key|p1_name=id | |||
|func_footnote | |func_footnote | ||
|func_desc | |func_desc | ||
|return_text= | |return_text=containing the agent information about {{LSLP|id}}. | ||
|spec | |spec | ||
|caveats=*[[AGENT_BUSY]] indicates that the "busy" [[Internal Animations|internal animation]] is playing, even if the user is not truly in busy mode. | |caveats=*[[AGENT_BUSY]] indicates that the "busy" [[Internal Animations|internal animation]] is playing, even if the user is not truly in busy mode. | ||
* [[AGENT_TYPING]] | * '''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 [[Debug Settings|PlayTypingAnim]]. '''On server 1.42 and up''', it reflects [[ChatFromViewer|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 {{NoWrap|{{String|c541c47f-e0c0-058b-ad1a-d6ae3a4584d9}}}} — {{Jira|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. | *<code>[[AGENT_ALWAYS_RUN]] {{!}} [[AGENT_WALKING]]</code> 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. {{Jira|SVC-3177}} | *This function does not return reliable information immediately after a border crossing. Use [[llGetAnimation]] instead, if you can. — {{Jira|SVC-3177}} | ||
|constants= | |constants= | ||
{{LSL Constants/llGetAgentInfo|table=*}} | |||
|examples= | |examples= | ||
< | <source lang="lsl2"> | ||
default | default | ||
{ | { | ||
| Line 83: | Line 28: | ||
else | else | ||
out += "The agent is not flying.\n"; | out += "The agent is not flying.\n"; | ||
if(buf & AGENT_ATTACHMENTS) | if(buf & AGENT_ATTACHMENTS) | ||
{ | { | ||
| Line 93: | Line 38: | ||
else | else | ||
out += "The agent does not have attachments.\n"; | out += "The agent does not have attachments.\n"; | ||
if(buf & AGENT_MOUSELOOK) | if(buf & AGENT_MOUSELOOK) | ||
out += "the agent is in mouselook."; | out += "the agent is in mouselook."; | ||
| Line 101: | Line 46: | ||
} | } | ||
} | } | ||
</ | </source> | ||
|helpers | |helpers | ||
|also_functions= | |also_functions= | ||
| Line 210: | Line 58: | ||
|also_articles | |also_articles | ||
|notes=This is not a good way of testing if an avatar is in the region, use [[llGetAgentSize]] instead. | |notes=This is not a good way of testing if an avatar is in the region, use [[llGetAgentSize]] instead. | ||
|history={{LSL Added|0.4.0|remote=http://secondlife.wikia.com/wiki/Version_0.4.0#Scripting}} along with these flags [[AGENT_FLYING]], [[AGENT_ATTACHMENTS]], & [[AGENT_SCRIPTED]]. | |||
*[[AGENT_AUTOPILOT]] was added in {{SVN|2900|rev=136439|trunk=*|ser=1.33.0|anchor=file21}} | |||
|cat1=Avatar | |cat1=Avatar | ||
|cat2 | |cat2 | ||
Revision as of 01:32, 22 January 2015
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: integer llGetAgentInfo( key id );| 206 | Function ID |
| 0.0 | Forced Delay |
| 10.0 | Energy |
Returns a bit field (an integer) 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_AUTOMATED | 0x4000 | is marked as a scripted agent/bot |
| 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) |
| AGENT_SCRIPTED | 0x0004 | has scripted attachments |
| AGENT_SITTING | 0x0010 | is sitting[1] |
| 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_WALKINGindicates 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
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);
}
}
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
- llGetAgentInfo Added in SL 0.4.0[2] along with these flags AGENT_FLYING, AGENT_ATTACHMENTS, & AGENT_SCRIPTED.
- 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
- ^ "Sit down" 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.
- ^ Early release notes were not very accurate or thorough, they sometimes included information about features added in previous releases or failed to include information about features added in that release.
Signature |
|---|
function integer llGetAgentInfo( key id ); |