Difference between revisions of "LlBreakAllLinks"

From Second Life Wiki
Jump to navigation Jump to search
m
 
(4 intermediate revisions by 3 users not shown)
Line 7: Line 7:
|return_text
|return_text
|spec
|spec
|caveats
|caveats=
*This function fails if the owner does not have edit permissions on the object containing the script, the system message "''Delink failed because you do not have edit permission''" is received by the owner.
|constants
|constants
|examples=
|examples=
<lsl>
<source lang="lsl2">
//-- requests permission to change linkes, then breaks all links on touch.
//-- requests permission to change linkes, then breaks all links on touch.
default{
default{
Line 31: Line 32:
   }
   }
}
}
</lsl>
</source>
|helpers
|helpers
|also_functions={{LSL DefineRow||[[llBreakLink]]|Break a link}}
|also_functions={{LSL DefineRow||[[llBreakLink]]|Break a link}}
Line 38: Line 39:
|also_events={{LSL DefineRow||[[changed]]|[[CHANGED_LINK]]}}
|also_events={{LSL DefineRow||[[changed]]|[[CHANGED_LINK]]}}
|also_articles
|also_articles
|notes=*This only works in case the owner got edit permission on the item containing the script. Otherwise the system message "''Delink failed because you do not have edit permission''" is received by the owner.
|notes
|cat1=Link
|cat1=Link
|cat2
|cat2=Link/Management
|cat3
|cat3
|cat4
|cat4
}}
}}

Latest revision as of 23:08, 21 January 2015

Summary

Function: llBreakAllLinks( );
0.0 Forced Delay
10.0 Energy

Delinks all prims in the link set.

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

Caveats

Permissions
  • This function fails if the owner does not have edit permissions on the object containing the script, the system message "Delink failed because you do not have edit permission" is received by the owner.

Examples

//-- requests permission to change linkes, then breaks all links on touch.
default{
  state_entry(){
    llRequestPermissions( llGetOwner(), PERMISSION_CHANGE_LINKS );
  }

  run_time_permissions( integer vBitPermissions ){
    if (PERMISSION_CHANGE_LINKS & vBitPermissions){
      state sMain;
    }else{
      llResetScript();
    }
  }
}

state sMain{
  touch_start( integer vIntTouched ){
    llBreakAllLinks();
  }
}

See Also

Events

•  run_time_permissions Permission receiving event
•  changed CHANGED_LINK

Functions

•  llGetPermissions Get the permissions granted
•  llGetPermissionsKey Get the agent who granted permissions
•  llRequestPermissions Request permissions
•  llBreakLink Break a link
•  llCreateLink Link to another object

Articles

•  Script permissions

Deep Notes

Signature

function void llBreakAllLinks();