Difference between revisions of "LlCreateLink"

Revision as of 19:32, 16 April 2007

Function: llCreateLink( key target, integer parent );


1.0	Forced Delay
10.0	Energy

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 2: / Line 2: @@
 |func_id=141|func_sleep=1.0|func_energy=10.0
 |func=llCreateLink|sort=CreateLink
-|p1_type=key|p1_name=target
+|p1_type=key|p1_name=target|p1_desc=A prim in the same region.
-|p2_type=integer|p2_name=parent
+|p2_type=integer|p2_name=parent|p2_desc=If [[FALSE]], then '''target''' becomes the root.
-|func_desc=Attempt to link task script is attached to and target. If '''parent''' == {{LSLG|TRUE}}, task script is attached to is the root
+|func_desc=Attempt to link the script's object with '''target'''.
 |return_text
 |spec
-|caveats
+|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