Difference between revisions of "LlCreateLink"

Revision as of 20:32, 16 April 2007

Function: llCreateLink( key target, integer parent );

Attempt to link the script's object with target.

• key	target	–	A prim in the same region.
• integer	parent	–	If FALSE, then target becomes the root.

To run this function the script must request the PERMISSION_CHANGE_LINKS permission with llRequestPermissions and it must be granted by the owner.

Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event.
If the script lacks the permission PERMISSION_CHANGE_LINKS, the script will shout an error on DEBUG_CHANNEL and the operation fails (but the script continues to run).
If PERMISSION_CHANGE_LINKS is granted by anyone other than the owner, then when the function is called an error will be shouted on DEBUG_CHANNEL.

Once the PERMISSION_CHANGE_LINKS permission is granted there is no way to revoke it except from inside the script (for example, with a new llRequestPermissions call) or the script is reset or deleted.

Shouts an error on DEBUG_CHANNEL if target isn't in the region or an object.

Signature
function void llCreateLink( key target, integer parent );

@@ Line 7: / Line 7: @@
 |return_text
 |spec
-|caveats=Shouts an error on [[DEBUG_CHANNEL]] if '''target''' isn't in the region or an object.
+|caveats=*Shouts an error on [[DEBUG_CHANNEL]] if '''target''' isn't in the region or an object.
 |constants
 |examples

•	llGetPermissions	–	Get the permissions granted
•	llGetPermissionsKey	–	Get the agent who granted permissions
•	llRequestPermissions	–	Request permissions
•	llBreakLink	–	Break a link
•	llBreakAllLinks	–	Break all links