PlugInChain documentation - Universität Oldenburg

GlobalSettings.blockSize = 0;
In this case, the first plugin ‘readData’ (this or an equivalent other plugin is required in first
place to read the signal data) changes the value in this case to the size of specified input signal.
The default value for the GlobalSettings.blockSize is set to zero. If you want to use
frame-based processing with the same block sizes for all used plugins, it is useful to change
this parameter in the plugin list to the required value (e.g. GlobalSettings.blockSize=1024;)
and then define for all plugins
Settings.blockSize = GlobalSettings.blockSize.
In every other case of frame-based processing it is advised to use the default value.
The sampling rate and the number of channels also can be defined in the GlobalSettings:
GlobalSettings.fs = 0;
GlobalSettings.channels = 0;
If they (or one of them) remain on default value ‘0’, it is set in first step by the plugin ‘read-
Data’ to the sampling rate or number of channels of the signal.
If any plugin is changing the actual value it is required to change GlobalSettings appropriately
in its _init file. If any value for sampling rate or channels is defined for the Global-
Settings in the plugin list, it has to agree with the used incoming signal data. Otherwise it
will produce an error and processing is stopped.
WARNING:
If you write and use your own plugin to read any data instead of ‘readData’, your plugin has
to do more than just reading data. It has to supply the PluginChain with the functionality of
initializing the signal structure and setting several values in the GlobalSettings.
If Simulations should be performed with the PlugInChain, there exists the possibility of storing
the data automatically. Therefore the variable (with default value ‘false’) must be set on
true:
GlobalSettings.saveSimulation = true;.
There also exists the possibility to hide the progress bar while processing. To do this one has
to define in the plugin list
GlobalSettings.showProgressBar = 0;.
Some plugins need to act on a specific signal level. Therefore GlobalSettings.dBFS2SPL
defines the level of dB an amplitude of 1 will correspond to. Each plugin might have other
scaling factors, but must in this case transform the signal and retransform afterwards or
change the value of dBFS2SPL in the GlobalSettings correctly (see Example 2).
27