Difference between revisions of "Control"

Revision as of 21:50, 10 June 2018

LSL Portal

! Event: control( key id, integer level, integer edge ){ ; }

15	Event ID
0.05	Delay

Result of llTakeControls library function call and user input.

• key	id	–	avatar UUID
• integer	level	–	bitfield of CONTROL_* flags, non-zero while one or more keys is being held down.
• integer	edge	–	bitfield of CONTROL_* flags, non-zero when one or more keys have been just pressed or released.

Constant	Value	Description
CONTROL_FWD	0x00000001	Move forward control (↑ or W)
CONTROL_BACK	0x00000002	Move back control (↓ or S)
CONTROL_LEFT	0x00000004	Move left control (⇧ Shift-← or ⇧ Shift-A [← or A in mouselook])
CONTROL_RIGHT	0x00000008	Move right control (⇧ Shift-→ or ⇧ Shift-D [→ or D in mouselook])
CONTROL_ROT_LEFT	0x00000100	Rotate left control (← or A)
CONTROL_ROT_RIGHT	0x00000200	Rotate right control (→ or D)
CONTROL_UP	0x00000010	Move up control (PgUp or E)
CONTROL_DOWN	0x00000020	Move down control (PgDn or C)
CONTROL_LBUTTON	0x10000000	Left mouse button control
CONTROL_ML_LBUTTON	0x40000000	Left mouse button control while in mouselook
(undocumented)	0x02000000	Avatar left rotation detected. Triggers llGetAnimation == "Turning Left"
(undocumented)	0x04000000	Avatar right rotation detected. Triggers llGetAnimation == "Turning Right"

Caveats

CONTROL_ROT_LEFT and CONTROL_ROT_RIGHT can be triggered when an object is selected or edited. If the user is running Viewer 2.0 and later, llGetAgentInfo will have AGENT_AUTOPILOT set in this case.
- Autopilot control events can continue for a short time after AGENT_AUTOPILOT drops.

Important Issues

~ All Issues ~ Search JIRA for related Bugs

		SCR-97	A		llTakeControls Traps repeating event when contols are changed or permission revoked
		SVC-3187	A		llTakeControls overrides existing controls

Examples

default
{
    state_entry()
    {
        llRequestPermissions(llGetOwner(), PERMISSION_TAKE_CONTROLS);
    }
    run_time_permissions(integer perm)
    {
        if(PERMISSION_TAKE_CONTROLS & perm)
        {
            llTakeControls(
                            CONTROL_FWD |
                            CONTROL_BACK |
                            CONTROL_LEFT |
                            CONTROL_RIGHT |
                            CONTROL_ROT_LEFT |
                            CONTROL_ROT_RIGHT |
                            CONTROL_UP |
                            CONTROL_DOWN |
                            CONTROL_LBUTTON |
                            CONTROL_ML_LBUTTON |
                            0, TRUE, FALSE);
                            // | 0 is for edit convenience,
                            // it does not change the mask.
        }
    }
    control(key id, integer level, integer edge)
    {
        integer start = level & edge;
        integer end = ~level & edge;
        integer held = level & ~edge;
        integer untouched = ~(level | edge);
        llOwnerSay(llList2CSV([level, edge, start, end, held, untouched]));
    }
}

Notes

llGetRot in mouselook for an attachment returns the angle the avatar is looking in.

There are some bugs when you put two scripts in the same prim and call LlTakeControls(), the id may not be the intended one. See SVC-3187.

Deep Notes

Issues

All Issues

~ Search JIRA for related Issues

		SCR-97	A		llTakeControls Traps repeating event when contols are changed or permission revoked
		SVC-3187	A		llTakeControls overrides existing controls

Signature
event void control( key id, integer level, integer edge );

@@ Line 1: / Line 1: @@
 {{LSL_Event
-|event_id=15|event_delay|event=control
+|inject-2={{Issues/SCR-97}}{{Issues/SVC-3187}}{{LSL Function/avatar|id|}}
+|event_id=15|event_delay=0.05|event=control
 |p1_type=key|p1_name=id|p1_desc
-|p2_type=integer|p2_name=level|p2_desc
+|p2_type=integer|p2_subtype=bit_field|p2_name=level|p2_desc=bitfield of CONTROL_* flags, non-zero while one or more keys is being held down.
-|p3_type=integer|p3_name=edge|p3_desc
+|p3_type=integer|p3_subtype=bit_field|p3_name=edge|p3_desc=bitfield of CONTROL_* flags, non-zero when one or more keys have been just pressed or released.
-|event_desc=Result of {{LSLG|llTakeControls}} library function call and user input.
+|event_desc=Result of [[llTakeControls]] library function call and user input.
 |constants={{LSL Constants/Controls}}
 |spec
-|caveats
+|caveats=*[[CONTROL_ROT_LEFT]] and [[CONTROL_ROT_RIGHT]] can be triggered when an object is selected or edited. If the user is running Viewer 2.0 and later, [[llGetAgentInfo]] will have [[AGENT_AUTOPILOT]] set in this case.
-|examples=<pre>
+**Autopilot control events can continue for a short time after AGENT_AUTOPILOT drops.
-default
+|examples=<source lang="lsl2">default
 {
      state_entry()
@@ Line 30: / Line 31: @@
                              CONTROL_LBUTTON |
                              CONTROL_ML_LBUTTON |
-, TRUE, TRUE);
+, TRUE, FALSE);
+                            // | 0 is for edit convenience,
+                            // it does not change the mask.
          }
      }
@@ Line 38: / Line 41: @@
          integer end = ~level & edge;
          integer held = level & ~edge;
-         integer unheld = ~(level & edge);
+         integer untouched = ~(level | edge);
-         llOwnerSay(llList2CSV([level, edge, start, end, held, unheld]));
+         llOwnerSay(llList2CSV([level, edge, start, end, held, untouched]));
      }
-}
+}</source>
-</pre>
 |helpers
 |also_header
-|also_events=*{{LSLG|run_time_permissions}}
+|also_events={{LSL DefineRow||[[run_time_permissions]]}}
-|also_functions=*{{LSLG|llTakeControls}}
+|also_functions={{LSL DefineRow||[[llTakeControls]]}}
-*{{LSLG|llReleaseControls}}
+{{LSL DefineRow||[[llReleaseControls]]}}
-*{{LSLG|llRequestPermissions}}
+{{LSL DefineRow||[[llRequestPermissions]]}}
 |also_tests
 |also_articles
 |also_footer
-|notes=llGetRot in mouselook for an attachment returns the angle the avatar is looking in.
+|notes=[[llGetRot]] in [[mouselook]] for an attachment returns the angle the avatar is looking in.
-My tests determined that the key returned when an agent control is caught is not the key for that agent, but is the object owner's key. If more then one script is used in the same object to hold permissions for multiple agents simultaneously, control may be triggered in all scripts but there is no way to know which agent actually caused the trigger. [[User:Anthony Reisman|Anthony Reisman]] 09:59, 14 February 2007 (PST)
+There are some bugs when you put two scripts in the same prim and call LlTakeControls(), the '''id''' may not be the intended one. See [http://jira.secondlife.com/browse/SVC-3187 SVC-3187].
 |mode
-|deprecated
+|issues
-|cat1=Control
+|cat1=Controls
 |cat2
 |cat3
 |cat4
 }}

Difference between revisions of "Control"

Revision as of 21:50, 10 June 2018

Contents

Description

Caveats

Important Issues

Examples

Notes

See Also

Events

Functions

Deep Notes

Issues

All Issues

Signature

Navigation menu

Search

•	llTakeControls
•	llReleaseControls
•	llRequestPermissions