21.07.2013 Views

PlugInChain documentation - Universität Oldenburg

PlugInChain documentation - Universität Oldenburg

PlugInChain documentation - Universität Oldenburg

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

All settings which are necessary to process the audio material are initialized and stored for<br />

every plugin in the Plugin structure as a sub-structure of ConfigStruct. The <strong>PlugInChain</strong><br />

GlobalSettings stores information about the plugin list, paths and some other needed control<br />

parameters.<br />

1.4.2 Run processing<br />

The block-based processing of the input signal can be started by<br />

[Signal,ConfigStruct]=pluginchain_process(Signal, ConfigStruct);.<br />

Note that the input arguments of the function pluginchain_process.m require the initialized<br />

Signal and the initialized ConfigStruct structure (contains the plugins as well as the ‘GlobalSettings’).<br />

If no block processing is needed it is recommended to process the whole signal in one, because<br />

it’s much faster and therefore is chosen as the default constellation.<br />

The actual progress is reported by a waitbar showing the percentage of completed processing.<br />

It can be turned off by redefining the value in the GlobalSettings as<br />

‘showProgessbar = false’.<br />

The processed signal is stored in the Signal structure. But depending on the last plugin of the<br />

actual plugin list, the output also can be<br />

• stored to a wavefile,<br />

• stored to a file,<br />

• plotted into a figure<br />

just to name a few examples.<br />

1.5 Examples of starting the <strong>PlugInChain</strong><br />

In the directory where all files and folders for the <strong>PlugInChain</strong> are stored, two functions are<br />

available to run the <strong>PlugInChain</strong> without or with GUI:<br />

‘pluginchain.m’ (without GUI) and<br />

‘pluginchaingui.m’. (with GUI)<br />

For the pluginchaingui function most parameters are optional. If used, they always must appear<br />

in pairs of variable name and variable value. In the following the possible commands are<br />

shortly described:<br />

1. pluginchaingui();<br />

Starts the PluginChain with GUI in the directory ‘base’ with the default plugin list.<br />

2. pluginchaingui (‘pluginlist’,‘pluginlistname.cfg’)<br />

Starts the <strong>PlugInChain</strong> with GUI using the specified plugin list ‘pluginlistname.cfg’,<br />

as long as not specified GlobalSettings.guidefault = false.<br />

3. pluginchaingui (‘pluginlist’,‘pluginlistname.cfg’,’gui’,’true’)<br />

Starting the <strong>PlugInChain</strong> with GUI loading the plugin list ‘pluginlistname.cfg’, the last<br />

two arguments are optional.<br />

10

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!