Difference between revisions of "LlRequestPermissions"

Revision as of 11:06, 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 permissions are granted without notification.

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

@@ Line 20: / Line 20: @@
 * {{LSLG|llGetPermissionsKey}}
 |also_articles=* {{LSLG|Script permissions}}
-|notes
+|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.
 |constants={{LSL Constants/Permissions}}
 |cat1=Permissions/Script