llTakeControls

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/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

TakeControls

llTakeControls

Summary

Function: llTakeControls( integer controls, integer accept, integer pass_on );

111	Function ID
0.0	Forced Delay
10.0	Energy

Take controls from agent task has permissions for. If (accept == (controls & input)), send input to task. If pass_on send to agent also.

• integer	controls
• integer	accept
• integer	pass_on

To run this function the script must request the PERMISSION_TAKE_CONTROLS permission with llRequestPermissions.

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

Permissions

Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event. If the script lacks the permission PERMISSION_TAKE_CONTROLS, the script will shout an error on DEBUG_CHANNEL and the operation fails (but the script continues to run). Once the PERMISSION_TAKE_CONTROLS permission is granted, it can be revoked from inside the script (with llReleaseControls or a new llRequestPermissions call), or if the user chooses Release Keys from the viewer. The script will also lose this permission on reset, or if the object is deleted, detached, or dropped.

All Issues ~ Search JIRA for related Bugs

Examples

Notes

If a script has taken controls, it will not be stopped if the Agent enters a No-Script Area. This somehow makes sense to keep vehicle control alive, and this also leads to AOs not stopping in no-script areas, but it is not clear if this is a bug or intentional.

See Also

Events

•

run_time_permissions

–

Permission receiving event

control

Functions

•	llGetPermissions	–	Get the permissions granted
•	llGetPermissionsKey	–	Get the agent who granted permissions
•	llRequestPermissions	–	Request permissions	llReleaseControls

Articles

•

Script permissions

Deep Notes

Search JIRA for related Issues

Signature
function void llTakeControls( integer controls, integer accept, integer pass_on );