Second Life Wiki - User contributions [en]

User talk:Chibbchichi Resident

2013-12-30T13:25:01Z

Chibbchichi Resident: /* llGetAgentInfo Example */

== llGetAgentInfo Example ==

I saw your recent contribution to llGetAgentInfo, but I felt it had some problems that needed addressing, so I took the liberty of moving it to here.
Your attach event resets the script, forcing it back through state_entry.
Within state_entry you assign the owner's key to the string 'id' (strictly should be a key variable).
But then you attempt to test if the object is being detached by checking if id is NULL_KEY - but it can't be. That test needs to be done inside the attach() event.
Stopping the timer from within state_entry is pointless, as no timer will be running first time nor on script reset.
Within timer(), the information you gain from llGetAgentInfo() is not only about whether the agent is typing. It could for example include mouselook indication, or if they are flying. So testing this data for a change in typing status is not totally valid. You must isolate the AGENT_TYPING bit straightaway. I won't try and fix the whole script, but perhaps this would work for the timer code. The rest needs a bit of a rethink. [[User:Omei Qunhua|Omei Qunhua]] 11:18, 26 December 2013 (PST)

<lsl>
timer()
{
integer TypingNow = llGetAgentInfo( llGetOwner() ) & AGENT_TYPING;
if (TypingNow != gLastAnimation)
{
if (TypingNow)
doStuff();
else
stopStuff();
gLastAnimation = TypingNow;
}
}
</lsl>

[V3]
<lsl>
// A simple typing override example.
// Modified the example-LSL of llGetAnimation to make it work with llGetAgentInfo.
// Also included an easy way to hide and show the whole object depending on current typing state.
// For example: Show a keyboard under avatars hands when avatar types.

key gOwner; // the wearer's key
integer gWasTyping; // last state of typing seen

// User functions
Initialize(key id){
if (id == NULL_KEY) { // detaching
llSetTimerEvent(0.0); // stop the timer
}
else { // attached, or reset while worn
llRequestPermissions(id, PERMISSION_TRIGGER_ANIMATION);
gOwner = id;
}
}

// Event handlers
default
{
state_entry() {
// in case the script was reset while already attached
if (llGetAttached() != 0) {
Initialize(llGetOwner());
}
}

attach(key id) {
Initialize(id);
}

run_time_permissions(integer perm) {
if (perm & PERMISSION_TRIGGER_ANIMATION) {
llSetTimerEvent(0.25); // start polling
}
}

timer() {
integer typingNow = llGetAgentInfo(gOwner);

if (gWasTyping != (typingNow & AGENT_TYPING)) { // any change?
if(typingNow & AGENT_TYPING){ // set whole object visible when typing
llSetLinkAlpha(LINK_SET, 1.0, ALL_SIDES);
llStartAnimation("run");
}
else{ // set whole object invisible if not typing
llSetLinkAlpha(LINK_SET, 0.0, ALL_SIDES);
llStopAnimation("run");
}
gWasTyping = typingNow; // store away for net time
}
}
}
</lsl>

:I agree with Omei here. The purpose of the examples in the wiki pages is to be educative about what the function does. This script is, at best, an example of how to put a bunch of functions and events together in order to make a typing overrider. Not really educative on what llGetAgentInfo does by itself. The individual functions are not the correct place for putting a script that requires mixing so many functions and events. The example that is already present there is enough, and serves as a good illustration of how an educational example looks like. --[[User:Pedro Oval|Pedro Oval]] 15:07, 29 December 2013 (PST)

:I've already told Omei, wrote it as comment in the script and i will say it here again: This script is based on the example shown in [[LlGetAnimation]]. If my script is not an good example then the [[LlGetAnimation]] example is not good enough as well. I won't try anymore to get it as an example in llGetAgentInfo. The search box is gladly able to find it when someone searches for "typing override" so i hope it will make someone happy in the future. --[[User:Chibbchichi Resident|Chibbchichi Resident]] 05:04, 30 December 2013 (PST)

User talk:Chibbchichi Resident

2013-12-30T13:24:04Z

Chibbchichi Resident: /* llGetAgentInfo Example */

== llGetAgentInfo Example ==

I saw your recent contribution to llGetAgentInfo, but I felt it had some problems that needed addressing, so I took the liberty of moving it to here.
Your attach event resets the script, forcing it back through state_entry.
Within state_entry you assign the owner's key to the string 'id' (strictly should be a key variable).
But then you attempt to test if the object is being detached by checking if id is NULL_KEY - but it can't be. That test needs to be done inside the attach() event.
Stopping the timer from within state_entry is pointless, as no timer will be running first time nor on script reset.
Within timer(), the information you gain from llGetAgentInfo() is not only about whether the agent is typing. It could for example include mouselook indication, or if they are flying. So testing this data for a change in typing status is not totally valid. You must isolate the AGENT_TYPING bit straightaway. I won't try and fix the whole script, but perhaps this would work for the timer code. The rest needs a bit of a rethink. [[User:Omei Qunhua|Omei Qunhua]] 11:18, 26 December 2013 (PST)

<lsl>
timer()
{
integer TypingNow = llGetAgentInfo( llGetOwner() ) & AGENT_TYPING;
if (TypingNow != gLastAnimation)
{
if (TypingNow)
doStuff();
else
stopStuff();
gLastAnimation = TypingNow;
}
}
</lsl>

[V3]
<lsl>
// A simple typing override example.
// Modified the example-LSL of llGetAnimation to make it work with llGetAgentInfo.
// Also included an easy way to hide and show the whole object depending on current typing state.
// For example: Show a keyboard under avatars hands when avatar types.

key gOwner; // the wearer's key
integer gWasTyping; // last state of typing seen

// User functions
Initialize(key id){
// in case the script was reset while already attached
if (llGetAttached() != 0) {
if (id == NULL_KEY) { // detaching
llSetTimerEvent(0.0); // stop the timer
}
else { // attached, or reset while worn
llRequestPermissions(id, PERMISSION_TRIGGER_ANIMATION);
gOwner = id;
}
}
}

// Event handlers
default
{
state_entry() {
Initialize(llGetOwner());
}

attach(key id) {
Initialize(id);
}

run_time_permissions(integer perm) {
if (perm & PERMISSION_TRIGGER_ANIMATION) {
llSetTimerEvent(0.25); // start polling
}
}

timer() {
integer typingNow = llGetAgentInfo(gOwner);

if (gWasTyping != (typingNow & AGENT_TYPING)) { // any change?
if(typingNow & AGENT_TYPING){ // set whole object visible when typing
llSetLinkAlpha(LINK_SET, 1.0, ALL_SIDES);
llStartAnimation("run");
}
else{ // set whole object invisible if not typing
llSetLinkAlpha(LINK_SET, 0.0, ALL_SIDES);
llStopAnimation("run");
}
gWasTyping = typingNow; // store away for net time
}
}
}
</lsl>

:I agree with Omei here. The purpose of the examples in the wiki pages is to be educative about what the function does. This script is, at best, an example of how to put a bunch of functions and events together in order to make a typing overrider. Not really educative on what llGetAgentInfo does by itself. The individual functions are not the correct place for putting a script that requires mixing so many functions and events. The example that is already present there is enough, and serves as a good illustration of how an educational example looks like. --[[User:Pedro Oval|Pedro Oval]] 15:07, 29 December 2013 (PST)

:I've already told Omei, wrote it as comment in the script and i will say it here again: This script is based on the example shown in [[LlGetAnimation]]. If my script is not an good example then the [[LlGetAnimation]] example is not good enough as well. I won't try anymore to get it as an example in llGetAgentInfo. The search box is gladly able to find it when someone searches for "typing override" so i hope it will make someone happy in the future. --[[User:Chibbchichi Resident|Chibbchichi Resident]] 05:04, 30 December 2013 (PST)

User talk:Chibbchichi Resident

2013-12-30T13:04:17Z

Chibbchichi Resident:

== llGetAgentInfo Example ==

I saw your recent contribution to llGetAgentInfo, but I felt it had some problems that needed addressing, so I took the liberty of moving it to here.
Your attach event resets the script, forcing it back through state_entry.
Within state_entry you assign the owner's key to the string 'id' (strictly should be a key variable).
But then you attempt to test if the object is being detached by checking if id is NULL_KEY - but it can't be. That test needs to be done inside the attach() event.
Stopping the timer from within state_entry is pointless, as no timer will be running first time nor on script reset.
Within timer(), the information you gain from llGetAgentInfo() is not only about whether the agent is typing. It could for example include mouselook indication, or if they are flying. So testing this data for a change in typing status is not totally valid. You must isolate the AGENT_TYPING bit straightaway. I won't try and fix the whole script, but perhaps this would work for the timer code. The rest needs a bit of a rethink. [[User:Omei Qunhua|Omei Qunhua]] 11:18, 26 December 2013 (PST)

<lsl>
timer()
{
integer TypingNow = llGetAgentInfo( llGetOwner() ) & AGENT_TYPING;
if (TypingNow != gLastAnimation)
{
if (TypingNow)
doStuff();
else
stopStuff();
gLastAnimation = TypingNow;
}
}
</lsl>

[V3]
<lsl>
// A simple typing override example.
// Modified the example-LSL of llGetAnimation to make it work with llGetAgentInfo.
// Also included an easy way to hide and show the whole object depending on current typing state.
// For example: Show a keyboard under avatars hands when avatar types.

key gOwner; // the wearer's key
integer gWasTyping; // last state of typing seen

// User functions
Initialize(key id){
// in case the script was reset while already attached
if (llGetAttached() != 0) {
if (id == NULL_KEY) { // detaching
llSetTimerEvent(0.0); // stop the timer
}
else { // attached, or reset while worn
llRequestPermissions(id, PERMISSION_TRIGGER_ANIMATION);
gOwner = id;
}
}
}

// Event handlers
default
{
state_entry() {
Initialize(llGetOwner());
}

attach(key id) {
Initialize(id);
}

run_time_permissions(integer perm) {
if (perm & PERMISSION_TRIGGER_ANIMATION) {
llSetTimerEvent(0.25); // start polling
}
}

timer() {
integer typingNow = llGetAgentInfo(llGetOwner());

if (gWasTyping != (typingNow & AGENT_TYPING)) { // any change?
if(typingNow & AGENT_TYPING){ // set whole object visible when typing
llSetLinkAlpha(LINK_SET, 1.0, ALL_SIDES);
}
else{ // set whole object invisible if not typing
llSetLinkAlpha(LINK_SET, 0.0, ALL_SIDES);
}
gWasTyping = typingNow; // store away for net time
}
}
}
</lsl>

:I agree with Omei here. The purpose of the examples in the wiki pages is to be educative about what the function does. This script is, at best, an example of how to put a bunch of functions and events together in order to make a typing overrider. Not really educative on what llGetAgentInfo does by itself. The individual functions are not the correct place for putting a script that requires mixing so many functions and events. The example that is already present there is enough, and serves as a good illustration of how an educational example looks like. --[[User:Pedro Oval|Pedro Oval]] 15:07, 29 December 2013 (PST)

:I've already told Omei, wrote it as comment in the script and i will say it here again: This script is based on the example shown in [[LlGetAnimation]]. If my script is not an good example then the [[LlGetAnimation]] example is not good enough as well. I won't try anymore to get it as an example in llGetAgentInfo. The search box is gladly able to find it when someone searches for "typing override" so i hope it will make someone happy in the future. --[[User:Chibbchichi Resident|Chibbchichi Resident]] 05:04, 30 December 2013 (PST)

User talk:Chibbchichi Resident

2013-12-29T17:53:28Z

Chibbchichi Resident: /* llGetAgentInfo Example */

User talk:Chibbchichi Resident

2013-12-29T17:44:24Z

Chibbchichi Resident: /* llGetAgentInfo Example */

User talk:Chibbchichi Resident

2013-12-29T17:44:13Z

Chibbchichi Resident: /* llGetAgentInfo Example */

User talk:Chibbchichi Resident

2013-12-29T17:43:19Z

Chibbchichi Resident: /* llGetAgentInfo Example */

User talk:Chibbchichi Resident

2013-12-29T17:43:04Z

Chibbchichi Resident: /* llGetAgentInfo Example */

User talk:Chibbchichi Resident

2013-12-29T17:42:54Z

Chibbchichi Resident: /* llGetAgentInfo Example */

User talk:Chibbchichi Resident

2013-12-26T22:55:20Z

Chibbchichi Resident:

== llGetAgentInfo Example ==

I saw your recent contribution to llGetAgentInfo, but I felt it had some problems that needed addressing, so I took the liberty of moving it to here.
Your attach event resets the script, forcing it back through state_entry.
Within state_entry you assign the owner's key to the string 'id' (strictly should be a key variable).
But then you attempt to test if the object is being detached by checking if id is NULL_KEY - but it can't be. That test needs to be done inside the attach() event.
Stopping the timer from within state_entry is pointless, as no timer will be running first time nor on script reset.
Within timer(), the information you gain from llGetAgentInfo() is not only about whether the agent is typing. It could for example include mouselook indication, or if they are flying. So testing this data for a change in typing status is not totally valid. You must isolate the AGENT_TYPING bit straightaway. I won't try and fix the whole script, but perhaps this would work for the timer code. The rest needs a bit of a rethink. [[User:Omei Qunhua|Omei Qunhua]] 11:18, 26 December 2013 (PST)

<lsl>
timer()
{
integer TypingNow = llGetAgentInfo( llGetOwner() ) & AGENT_TYPING;
if (TypingNow != gLastAnimation)
{
if (TypingNow)
doStuff();
else
stopStuff();
gLastAnimation = TypingNow;
}
}
</lsl>

<lsl>
// A simple typing override example.
// Modified the example-LSL of llGetAnimation to make it work with llGetAgentInfo.
// Also included an easy way to hide and show the whole object depending on current typing state.
// For example: Show a keyboard under avatars hands when avatar types.

// User functions
doStuff(){
llStartAnimation("run");
llSetAlpha(1,ALL_SIDES);
}

stopStuff(){
llStopAnimation("run");
llSetAlpha(0,ALL_SIDES);
}

key gOwner; // the wearer's key
integer gLastAnimation; // last llGetAnimation value seen

// Event handlers
default
{
state_entry() {
string id=llGetOwner();
// in case the script was reset while already attached
if (llGetAttached() != 0) {
if (id == NULL_KEY) { // detaching
llSetTimerEvent(0.0); // stop the timer
}
else { // attached, or reset while worn
llRequestPermissions(id, PERMISSION_TRIGGER_ANIMATION);
gOwner = id;
}
}
}

attach(key id) {
llResetScript();
}

run_time_permissions(integer perm) {
if (perm & PERMISSION_TRIGGER_ANIMATION) {
llSetTimerEvent(0.25); // start polling
}
}

timer() {
integer newAnimation = llGetAgentInfo(gOwner);

if (gLastAnimation != newAnimation) { // any change?
if(newAnimation & AGENT_TYPING){
doStuff();
}
else if (gLastAnimation !=(newAnimation & AGENT_TYPING)) {
stopStuff();
}
gLastAnimation = newAnimation; // store away for next time
}
}
}
</lsl>

[V2]
<lsl>
// A simple typing override example.
// Modified the example-LSL of llGetAnimation to make it work with llGetAgentInfo.
// Also included an easy way to hide and show the whole object depending on current typing state.
// For example: Show a keyboard under avatars hands when avatar types.

key gOwner; // the wearer's key
integer gLastAnimation; // last llGetAnimation value seen

// User functions
doStuff(){
llStartAnimation("run");
llSetAlpha(1,ALL_SIDES);
}

stopStuff(){
llStopAnimation("run");
llSetAlpha(0,ALL_SIDES);
}

Initialize(key id){
// in case the script was reset while already attached
if (llGetAttached() != 0) {
if (id == NULL_KEY) { // detaching
llSetTimerEvent(0.0); // stop the timer
}
else { // attached, or reset while worn
llRequestPermissions(id, PERMISSION_TRIGGER_ANIMATION);
gOwner = id;
}
}
}

// Event handlers
default
{
state_entry() {
Initialize(llGetOwner());
}

attach(key id) {
Initialize(id);
}

run_time_permissions(integer perm) {
if (perm & PERMISSION_TRIGGER_ANIMATION) {
llSetTimerEvent(0.25); // start polling
}
}

timer() {
integer newAnimation = llGetAgentInfo(gOwner);
integer isTyping = newAnimation & AGENT_TYPING;

if (gLastAnimation != newAnimation) { // any change?
if(isTyping){
doStuff();
}
else if (gLastAnimation != isTyping) {
stopStuff();
}
gLastAnimation = newAnimation; // store away for next time
}
}
}
</lsl>

User talk:Chibbchichi Resident

2013-12-26T22:50:32Z

Chibbchichi Resident:

== llGetAgentInfo Example ==

I saw your recent contribution to llGetAgentInfo, but I felt it had some problems that needed addressing, so I took the liberty of moving it to here.
Your attach event resets the script, forcing it back through state_entry.
Within state_entry you assign the owner's key to the string 'id' (strictly should be a key variable).
But then you attempt to test if the object is being detached by checking if id is NULL_KEY - but it can't be. That test needs to be done inside the attach() event.
Stopping the timer from within state_entry is pointless, as no timer will be running first time nor on script reset.
Within timer(), the information you gain from llGetAgentInfo() is not only about whether the agent is typing. It could for example include mouselook indication, or if they are flying. So testing this data for a change in typing status is not totally valid. You must isolate the AGENT_TYPING bit straightaway. I won't try and fix the whole script, but perhaps this would work for the timer code. The rest needs a bit of a rethink. [[User:Omei Qunhua|Omei Qunhua]] 11:18, 26 December 2013 (PST)

<lsl>
timer()
{
integer TypingNow = llGetAgentInfo( llGetOwner() ) & AGENT_TYPING;
if (TypingNow != gLastAnimation)
{
if (TypingNow)
doStuff();
else
stopStuff();
gLastAnimation = TypingNow;
}
}
</lsl>

<lsl>
// A simple typing override example.
// Modified the example-LSL of llGetAnimation to make it work with llGetAgentInfo.
// Also included an easy way to hide and show the whole object depending on current typing state.
// For example: Show a keyboard under avatars hands when avatar types.

// User functions
doStuff(){
llStartAnimation("run");
llSetAlpha(1,ALL_SIDES);
}

stopStuff(){
llStopAnimation("run");
llSetAlpha(0,ALL_SIDES);
}

key gOwner; // the wearer's key
integer gLastAnimation; // last llGetAnimation value seen

// Event handlers
default
{
state_entry() {
string id=llGetOwner();
// in case the script was reset while already attached
if (llGetAttached() != 0) {
if (id == NULL_KEY) { // detaching
llSetTimerEvent(0.0); // stop the timer
}
else { // attached, or reset while worn
llRequestPermissions(id, PERMISSION_TRIGGER_ANIMATION);
gOwner = id;
}
}
}

attach(key id) {
llResetScript();
}

run_time_permissions(integer perm) {
if (perm & PERMISSION_TRIGGER_ANIMATION) {
llSetTimerEvent(0.25); // start polling
}
}

timer() {
integer newAnimation = llGetAgentInfo(gOwner);

if (gLastAnimation != newAnimation) { // any change?
if(newAnimation & AGENT_TYPING){
doStuff();
}
else if (gLastAnimation !=(newAnimation & AGENT_TYPING)) {
stopStuff();
}
gLastAnimation = newAnimation; // store away for next time
}
}
}
</lsl>

<lsl>
// A simple typing override example.
// Modified the example-LSL of llGetAnimation to make it work with llGetAgentInfo.
// Also included an easy way to hide and show the whole object depending on current typing state.
// For example: Show a keyboard under avatars hands when avatar types.

// User functions
doStuff(){
llStartAnimation("run");
llSetAlpha(1,ALL_SIDES);
}

stopStuff(){
llStopAnimation("run");
llSetAlpha(0,ALL_SIDES);
}

Initialize(key id){
// in case the script was reset while already attached
if (llGetAttached() != 0) {
if (id == NULL_KEY) { // detaching
llSetTimerEvent(0.0); // stop the timer
}
else { // attached, or reset while worn
llRequestPermissions(id, PERMISSION_TRIGGER_ANIMATION);
gOwner = id;
}
}
}
key gOwner; // the wearer's key
integer gLastAnimation; // last llGetAnimation value seen

// Event handlers
default
{
state_entry() {
Initialize(llGetOwner());
}

attach(key id) {
Initialize(id);
}

run_time_permissions(integer perm) {
if (perm & PERMISSION_TRIGGER_ANIMATION) {
llSetTimerEvent(0.25); // start polling
}
}

timer() {
integer newAnimation = llGetAgentInfo(gOwner);

if (gLastAnimation != newAnimation) { // any change?
if(newAnimation & AGENT_TYPING){
doStuff();
}
else if (gLastAnimation !=(newAnimation & AGENT_TYPING)) {
stopStuff();
}
gLastAnimation = newAnimation; // store away for next time
}
}
}
</lsl>

LlGetAgentInfo

2013-12-26T17:04:13Z

Chibbchichi Resident:

{{LSL_Function
|inject-2={{Issues/SVC-91}}{{Issues/SVC-3177}}{{LSL Function/avatar|id|sim=*}}
|func=llGetAgentInfo
|sort=GetAgentInfo
|func_id=206|func_sleep=0.0|func_energy=10.0
|return_type=integer|return_subtype=bit field
|p1_type=key|p1_name=id
|func_footnote
|func_desc
|return_text=containing the agent information about {{LSLP|id}}.
|spec
|caveats=*[[AGENT_BUSY]] indicates that the "busy" [[Internal Animations|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 [[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}}
*<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}}
|constants=
{{LSL Constants/llGetAgentInfo|table=*}}
|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>
<lsl>
// A simple typing override example.
// Modified the example-LSL of llGetAnimation to make it work with llGetAgentInfo.
// Also included an easy way to hide and show the whole object depending on current typing state.
// For example: Show a keyboard under avatars hands when avatar types.

// User functions
doStuff(){
llStartAnimation("run");
llSetAlpha(1,ALL_SIDES);
}

stopStuff(){
llStopAnimation("run");
llSetAlpha(0,ALL_SIDES);
}

key gOwner; // the wearer's key
integer gLastAnimation; // last llGetAnimation value seen

// Event handlers
default
{
state_entry() {
string id=llGetOwner();
// in case the script was reset while already attached
if (llGetAttached() != 0) {
if (id == NULL_KEY) { // detaching
llSetTimerEvent(0.0); // stop the timer
}
else { // attached, or reset while worn
llRequestPermissions(id, PERMISSION_TRIGGER_ANIMATION);
gOwner = id;
}
}
}

attach(key id) {
llResetScript();
}

run_time_permissions(integer perm) {
if (perm & PERMISSION_TRIGGER_ANIMATION) {
llSetTimerEvent(0.25); // start polling
}
}

timer() {
integer newAnimation = llGetAgentInfo(gOwner);

if (gLastAnimation != newAnimation) { // any change?
if(newAnimation & AGENT_TYPING){
doStuff();
}
else if (gLastAnimation !=(newAnimation & AGENT_TYPING)) {
stopStuff();
}
gLastAnimation = newAnimation; // store away for next time
}
}
}
</lsl>
|helpers
|also_functions=
{{LSL DefineRow||[[llRequestAgentData]]|}}
{{LSL DefineRow||[[llGetAnimation]]|}}
{{LSL DefineRow||[[llGetAnimationList]]|}}
|also_events
|also_tests=
{{LSL DefineRow||[[llGetAgentInfo_Test]]|}}
|also_articles
|notes=This is not a good way of testing if an avatar is in the region, use [[llGetAgentSize]] instead.
|history={{LSL Added|0.2.0|remote=http://secondlife.wikia.com/wiki/Version_0.2.0}} 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
|cat2
|cat3
|cat4
}}

LlGetAgentInfo

2013-12-26T17:03:02Z

Chibbchichi Resident:

{{LSL_Function
|inject-2={{Issues/SVC-91}}{{Issues/SVC-3177}}{{LSL Function/avatar|id|sim=*}}
|func=llGetAgentInfo
|sort=GetAgentInfo
|func_id=206|func_sleep=0.0|func_energy=10.0
|return_type=integer|return_subtype=bit field
|p1_type=key|p1_name=id
|func_footnote
|func_desc
|return_text=containing the agent information about {{LSLP|id}}.
|spec
|caveats=*[[AGENT_BUSY]] indicates that the "busy" [[Internal Animations|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 [[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}}
*<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}}
|constants=
{{LSL Constants/llGetAgentInfo|table=*}}
|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>
<lsl>
// A simple typing override example.
// Modified the example-LSL of llGetAnimation to make it work with llGetAgentInfo.
// Also included an easy way to hide and show the whole object depending on current typing state.

// User functions
doStuff(){
llStartAnimation("run");
llSetAlpha(1,ALL_SIDES);
}

stopStuff(){
llStopAnimation("run");
llSetAlpha(0,ALL_SIDES);
}

key gOwner; // the wearer's key
integer gLastAnimation; // last llGetAnimation value seen

// Event handlers
default
{
state_entry() {
string id=llGetOwner();
// in case the script was reset while already attached
if (llGetAttached() != 0) {
if (id == NULL_KEY) { // detaching
llSetTimerEvent(0.0); // stop the timer
}
else { // attached, or reset while worn
llRequestPermissions(id, PERMISSION_TRIGGER_ANIMATION);
gOwner = id;
}
}
}

attach(key id) {
llResetScript();
}

run_time_permissions(integer perm) {
if (perm & PERMISSION_TRIGGER_ANIMATION) {
llSetTimerEvent(0.25); // start polling
}
}

timer() {
integer newAnimation = llGetAgentInfo(gOwner);

if (gLastAnimation != newAnimation) { // any change?
if(newAnimation & AGENT_TYPING){
doStuff();
}
else if (gLastAnimation !=(newAnimation & AGENT_TYPING)) {
stopStuff();
}
gLastAnimation = newAnimation; // store away for next time
}
}
}
</lsl>
|helpers
|also_functions=
{{LSL DefineRow||[[llRequestAgentData]]|}}
{{LSL DefineRow||[[llGetAnimation]]|}}
{{LSL DefineRow||[[llGetAnimationList]]|}}
|also_events
|also_tests=
{{LSL DefineRow||[[llGetAgentInfo_Test]]|}}
|also_articles
|notes=This is not a good way of testing if an avatar is in the region, use [[llGetAgentSize]] instead.
|history={{LSL Added|0.2.0|remote=http://secondlife.wikia.com/wiki/Version_0.2.0}} 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
|cat2
|cat3
|cat4
}}