Difference between revisions of "LlRemoteLoadScriptPin"

From Second Life Wiki
Jump to navigation Jump to search
(start_param is reset with script (tested by Cedrick Oceanland))
Line 8: Line 8:
|p4_type=integer|p4_name=running|p4_desc=boolean, if the script is to be set as running.
|p4_type=integer|p4_name=running|p4_desc=boolean, if the script is to be set as running.
|p5_type=integer|p5_name=start_param|p5_desc=value returned by [[llGetStartParameter]] in the target script.
|p5_type=integer|p5_name=start_param|p5_desc=value returned by [[llGetStartParameter]] in the target script.
|func_footnote=Only works if the owner of the object this script is attached to can modify '''target'''.
|func_desc=Copy script '''name''' into '''target''' and if '''running''' start with '''start_param'''.
|func_desc=Copy script '''name''' into '''target''' and if '''running''' start with '''start_param'''.
|func_footnote=Only works if the owner of the object this script is in can modify '''target'''.
|return_text
|return_text
|spec
|spec
|caveats=*'''start_param''' only lasts until the script is reset.
|caveats=
* '''start_param''' only lasts until the script is reset.
* If '''target''' is an attachment owned by a different user, regardless of object modify rights granted, this function will fail.{{Footnote|{{LSLGC|Attachment|Attachments}} can only be modified by their owner.|Attachments can only be modified by their owner.}}
|constants
|constants
|examples=
|examples=

Revision as of 09:40, 25 October 2008

Summary

Function: llRemoteLoadScriptPin( key target, string name, integer pin, integer running, integer start_param );

Copy script name into target and if running start with start_param.

• key target A prim in the same sim
• string name a script in the inventory of the prim this script is in
• integer pin Must match pin set by llSetRemoteScriptAccessPin
• integer running boolean, if the script is to be set as running.
• integer start_param value returned by llGetStartParameter in the target script.

Only works if the owner of the object this script is in can modify target.

Caveats

  • This function causes the script to sleep for 3.0 seconds.
  • If name is missing from the prim's inventory or it is not a script then an error is shouted on DEBUG_CHANNEL.
  • start_param only lasts until the script is reset.
  • If target is an attachment owned by a different user, regardless of object modify rights granted, this function will fail.[1]
All Issues ~ Search JIRA for related Bugs

Examples

<lsl>//Child Prim PIN setter integer PIN=1341134;

default { state_entry() {

       llOwnerSay(llGetObjectName()+" : "+(string)llGetKey()+" is ready to accept a describer script using the agreed upon PIN.");
       llSetRemoteScriptAccessPin(PIN);
   }
}</lsl>

See Also

Functions

•  llSetRemoteScriptAccessPin Used to setup a prim for remote loading

Deep Notes

Search JIRA for related Issues

Footnotes

  1. ^ Attachments can only be modified by their owner.

Signature

function void llRemoteLoadScriptPin( key target, string name, integer pin, integer running, integer start_param );