run [-e] [-d seconds] [-f frames] [-m milliseconds] [-k pattern] [-l] [-g groupname] [-c] [-p path] [-t rc|Rc|rC|RC row col][-v] [-q] [arguments] dat_node_path
Execute the contents of a DAT node.
Optional arguments may be appended to this command, which are accessible in the called script.
$arg0 will always be set to the name of the DAT being run.
$arg1 will be the first argument.
$arg2 will be the second argument, etc.
$argc will be the total number of arguments, including the name of the DAT being run.
$args will be the complete set of arguments, including the name of the DAT being run ($arg0).
$pargs will be the complete set of arguments, not including $arg0.
Instead of using these numbered arguments explicitly, one can use the
args command to rename them accordingly.
If you are calling
run -c within a script, say inside script A you have the command
run B, then any variables declared in A can be accessed by B. However, variables declared in script B will not subsequently be accessible to A. If variable C is declared in script A with value
c, but the value was changed to
d inside script B, when script A resumes execution the value of C will revert back to
If you are calling
run B with options
-m, then variables declared in A will NOT be accessible to script B.
-c, the current path will be changed to B, and revert to back to the path before executing B after B has finished. If you call
run -c B, then B will start execution in the current path. After B has completed execution, the current path will remain at whatever path, if any, that script B has changed to.
||Delay command execution by specified seconds|
||Delay command execution by specified frames|
||Delay command execution by specified milliseconds|
||Execute delayed script at the end of the frame, after nodes have had a chance to cook.|
||Quiet mode. No errors if path not found|
||Execute in current path. Default is to execute command in |
||Execute in the given path|
||Execute the given cell in the specified dat. Specify whether the row is indexed by number with r or by name with R, and the col by number with c and column by name with C.|
||Specify a group name for the delayed command|
||List all delayed commands|
||Kill a set of delayed commands|
||Verbose output of killed commands|
Run the contents of
Run 5 seconds from now with some arguments:
run -d 5 /text1 "Hello" 123
Run 200 milliseconds from now:
run -m 200 /text1
Run 200 milliseconds from now in current location:
run -c -m 200 /text1
Delayed command group Example:
/text1 in 5 seconds, and add it to
run -g group1 -d 5 /text1
List all delayed commands:
Kill all commands under
run -k group*
Kill and list any commands under
run -v -k group1
Kill all delayed commands:
run -k *