Difference between revisions of "LlRequestPermissions"

Revision as of 13:46, 14 February 2007

Function: llRequestPermissions( key agent, integer perm );

Ask agent for permission to run certain classes of functions.

• key	agent	–	Avatar key
• integer	perm	–	Permission mask (bitfield containing the permissions to request).

Constants		Action	Category	Granter	Automatically granted when…
PERMISSION_DEBIT	0x2	take money from agent's account	Money	Owner
PERMISSION_TAKE_CONTROLS	0x4	take agent's controls	Control	Anyone	sat on, attached
PERMISSION_TRIGGER_ANIMATION	0x10	start or stop Animations on agent	Animation	Anyone	sat on, attached
PERMISSION_ATTACH	0x20	attach/detach from agent	Attachment	Owner or Anyone	attached
PERMISSION_CHANGE_LINKS	0x80	change links	Link	Owner
PERMISSION_TRACK_CAMERA	0x400	track the agent's camera position and rotation	Camera	Anyone	sat on, attached
PERMISSION_CONTROL_CAMERA	0x800	control the agent's camera (must be sat on or attached; automatically revoked on stand or detach)	Camera	Anyone	sat on, attached
PERMISSION_TELEPORT	0x1000	teleport the agent	Teleport	Anyone^[1]
PERMISSION_SILENT_ESTATE_MANAGEMENT	0x4000	manage estate access without notifying the owner of changes	Estate	Owner
PERMISSION_OVERRIDE_ANIMATIONS	0x8000	configure the overriding of default animations on agent	Animation	Anyone	attached
PERMISSION_RETURN_OBJECTS	0x10000	Used by llReturnObjectsByOwner and llReturnObjectsByID to return objects from parcels	Cleanup	Owner, Group Owner

Permissions do not accumulate.
- If a permission was requested with a previous call to this function and granted, then in subsequent call was not requested, that permission is released (lost).
Scripts may hold permissions for only one agent at a time. To hold permissions for multiple agents you must use more then one script.

A dialog is presented to the agent to grant these permissions except for a few cases:

If agent is sitting on object - Control and Camera tracking permissions are granted without notification
If object is attached to agent - Control and Attach permissions are granted without notification.

Signature
function void llRequestPermissions( key agent, integer perm );

@@ Line 16: / Line 16: @@
 |examples
 |helpers
-|also_events=* {{LSLG|run_time_permissions}}
+|also_events={{{!}}
-|also_functions=* {{LSLG|llGetPermissions}}
+{{LSL DefineRow||{{LSLG|run_time_permissions}}|Permission receiver event}}
-* {{LSLG|llGetPermissionsKey}}
+{{!}}}
-|also_articles=* {{LSLG|Script permissions}}
+|also_functions={{{!}}
+{{LSL DefineRow||{{LSLG|llGetPermissions}}|Get the permissions granted}}
+{{LSL DefineRow||{{LSLG|llGetPermissionsKey}}|Get the avatar who granted permissions.}}
+{{!}}}
+|also_articles=*{{LSLGC|Permissions/Script|Script permissions}}
 |notes = A dialog is presented to the agent to grant these permissions except for a few cases:
 * If agent is sitting on object - Control and Camera tracking permissions are granted without notification
-* If object is attached to agent - Control permissions are granted without notification.
+* If object is attached to agent - Control and Attach permissions are granted without notification.
 |constants={{LSL Constants/Permissions}}
 |cat1=Permissions/Script

•	llGetPermissions	–	Get the permissions granted
•	llGetPermissionsKey	–	Get the avatar who granted permissions.