Difference between revisions of "LlCreateLink"

From Second Life Wiki
Jump to navigation Jump to search
m (moved func_footer to func_footnote: attempt to correct order in function category)
Line 4: Line 4:
|p1_type=key|p1_name=target|p1_desc=A prim in the same region.
|p1_type=key|p1_name=target|p1_desc=A prim in the same region.
|p2_type=integer|p2_name=parent|p2_desc=If [[FALSE]], then '''target''' becomes the root.
|p2_type=integer|p2_name=parent|p2_desc=If [[FALSE]], then '''target''' becomes the root.
|func_footnote='''target''' must be modifiable and have the same owner.<br/>
This object must also be modifiable.
|func_desc=Attempt to link the script's object with '''target'''.
|func_desc=Attempt to link the script's object with '''target'''.
|func_footer='''target''' must be modifiable and have the same owner.<br/>
This object must also be modifiable.
|spec
|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.

Revision as of 00:27, 12 November 2007

Summary

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. target must be modifiable and have the same owner.
This object must also be modifiable.

Caveats

  • This function causes the script to sleep for 1.0 seconds.
Permissions
  • Shouts an error on DEBUG_CHANNEL if target isn't in the region or an object.
  • If either the object or the target are not modifiable or of different owners, then an error is shouted on DEBUG_CHANNEL.

Examples

See Also

Events

•  run_time_permissions Permission receiving event

Functions

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

Articles

•  Script permissions

Deep Notes

Signature

function void llCreateLink( key target, integer parent );