Difference between revisions of "LlReleaseControls"

Revision as of 17:30, 20 July 2007

Function: llReleaseControls( );

Stop taking inputs (that were taken with llTakeControls), dequeues any remaining control events.

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

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.

Signature
function void llReleaseControls();

@@ Line 1: / Line 1: @@
-{{LSL_Function
+{{LSL_Function/permission|PERMISSION_TAKE_CONTROLS}}{{LSL_Function
 |func_id=112|func_sleep=0.0|func_energy=10.0
 |sort=ReleaseControls|func=llReleaseControls
@@ Line 15: / Line 15: @@
 |also_tests
 |notes
-|permission=PERMISSION_TAKE_CONTROLS
-|negative_index
 |cat1=Controls
 |cat2

•	run_time_permissions	–	Permission receiving event
•	control

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