Programmer Guide/Command Reference/LOAD: Difference between revisions
m (Text replace - "S_TOOLS-STx" to "{{STX}}") |
No edit summary |
||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:{{SUBPAGENAME}}}} | {{DISPLAYTITLE:{{SUBPAGENAME}}}} | ||
The <code>LOAD</code> command is used to load macro code, spu code and sound files, making them available for use in the {{STX}} programming environment. | The <code>LOAD</code> command is used to load macro code, spu code and sound files, making them available for use in the {{STX}} programming environment. | ||
Macros, signal processing units and sound files must be loaded before they can be used!Information about the currently active sound file is stored in the variables <code>CSF</code> (= fullfilepath) and <code>CSFH</code> (= srate channels samples code type mode). If no sound file is active, the variable <code>CSF</code> is empty. See Shell Environment for more details.Sound files opened with write access (/Write) cannot be shared with other users or processes.The sound file management is normally performed by the application {{STX}} . All other applications should use the {{STX}} APPMSG interface to attach or select sound files.The script library <code>BSF</code> implements a set of functions for using sound files and segments in scripts.To attach the directory of the current sound file to a (temporary) table item use the command <code>NEW TABLE * /Soundfiledirectory</code>. This attachment (and the temporary item) can be removed with "<code>DELETE diritemname</code>" without deleting the sound file directory itself. The directory table is deleted automatically when the sound file is unloaded. | Macros, signal processing units and sound files must be loaded before they can be used!Information about the currently active sound file is stored in the variables <code>CSF</code> (= fullfilepath) and <code>CSFH</code> (= srate channels samples code type mode). If no sound file is active, the variable <code>CSF</code> is empty. See Shell Environment for more details.Sound files opened with write access (/Write) cannot be shared with other users or processes.The sound file management is normally performed by the application {{STX}} . All other applications should use the {{STX}} APPMSG interface to attach or select sound files.The script library <code>BSF</code> implements a set of functions for using sound files and segments in scripts.To attach the directory of the current sound file to a (temporary) table item use the command <code>NEW TABLE * /Soundfiledirectory</code>. This attachment (and the temporary item) can be removed with "<code>DELETE diritemname</code>" without deleting the sound file directory itself. The directory table is deleted automatically when the sound file is unloaded. | ||
==LOAD SOURCECODE== | |||
<code>LOAD MACROCODE|SPUCODE <var>src1</var> [ <var>src2</var> ... ] [ /T ] [ /Nolog ] [ /S ]</code> | |||
Load all source code from the specified source files (<var>src1</var> etc). The command loads all sections containing source code, preprocesses them and adds them to the shell environment. | |||
/T | |||
:If specified, <var>src1</var> is interpreted as a simple table, rather than a file item. | |||
/N | |||
:Suppress log window output. | |||
/S | |||
:If specified, errors will generate warning messages rather than error messages. See The Silent Flag for details. | |||
Revision as of 14:25, 15 April 2011
The LOAD command is used to load macro code, spu code and sound files, making them available for use in the STx programming environment.
Macros, signal processing units and sound files must be loaded before they can be used!Information about the currently active sound file is stored in the variables CSF (= fullfilepath) and CSFH (= srate channels samples code type mode). If no sound file is active, the variable CSF is empty. See Shell Environment for more details.Sound files opened with write access (/Write) cannot be shared with other users or processes.The sound file management is normally performed by the application STx . All other applications should use the STx APPMSG interface to attach or select sound files.The script library BSF implements a set of functions for using sound files and segments in scripts.To attach the directory of the current sound file to a (temporary) table item use the command NEW TABLE * /Soundfiledirectory. This attachment (and the temporary item) can be removed with "DELETE diritemname" without deleting the sound file directory itself. The directory table is deleted automatically when the sound file is unloaded.
LOAD SOURCECODE
LOAD MACROCODE|SPUCODE src1 [ src2 ... ] [ /T ] [ /Nolog ] [ /S ]
Load all source code from the specified source files (src1 etc). The command loads all sections containing source code, preprocesses them and adds them to the shell environment.
/T
- If specified, src1 is interpreted as a simple table, rather than a file item.
/N
- Suppress log window output.
/S
- If specified, errors will generate warning messages rather than error messages. See The Silent Flag for details.
