
LEVEL RESPONSE 2 (MONO & STEREO)
--------------------------------

This module modifies the signal level using block-processing.
The level of every audio block is scaled according to a look-up table, which is provided in standard Shape format.
The abscissa corresponds to the Input level, while the ordinate represents the corresponding Output level desired.

By proper usage of this module, signal dynamics can be effectively compressed or expanded in unlimited ways.

The level scale used on both coordinates is a fixed dB scale, ranging from -oo to 0 dB (0 to 1 in floating point units, which is the useful signal level), with a linear roll-off region from -60 dB down to silence.
For this reason, it is advisable to specify seven grid divisions in the Shape Editor for both dimensions, for visual consistency (suitable dB labels can be added externally using custom artworks, since the Shape Editor does not provide any labels at present).

Two float output pins are also provided for convenience. For every audio block processed, they output the Input and the Output level on a normalized dB scale identical to the one above described, where 0 corresponds to silence (-oo dB) and 10 corresponds to full level (0 dB). These two pins can be connected to linear level indicator bars, to monitor module operation.



BLOCK SIZE
----------

Five fixed block sizes are provided to choose from: 10, 20, 42, 85 or 170 mSec, where 20 or 42 are optimal in most situations. If the input signal contains very low frequencies, it is advisable to increase the block size.


LATENCY AND COMPENSATION
------------------------

Block processing introduces a latency which corresponds to the block size used. Using larger block sizes implies more accuracy and less distortion of low frequencies but higher latency.
The latency introduced can be compensated and reported by SynthEdit enabling the hidden Report Latency bool pin. To be effective, this feature requires that latency compensation and latency report are also enabled in SynthEdit prefs and export dialog, respectively.

WARNING: when this feature is enabled, the plugin (or audio engine) will be restarted everytime the block size is changed ! Always consider this fact and its possible implications when deciding to leave block size user selectable.



STATIC UPDATES NOT SUPPORTED
----------------------------

Static updates (i.e switching a fixed voltage on input) are NOT supported, because that would be pointless for this module, whose main purpose is processing live audio. When Input becomes static, it will be seen as zero (silence), no matter which its static voltage value. Once Input become static, the module will go to sleep after flushing the internal audio buffer.


PIN DESCRIPTION
---------------

Shape, Interpolation:
standard Shape representing the level response (look-up table) and Shape interpolation type

Block size:
size of the audio blocks in milli-seconds to process input audio with

Amount:
amount of effect applied, from 0 (output level = input level) to 10 (look-up table 100% effective)

Report Latency:
enables automatic latency compensation and report

Input Level, Output Level:
monitor input and output levels for every audio block processed, on a normalized scale from -oo to 0 dB, with a linear region from silence up to -60 dB


STEREO VERSION
--------------

The stereo version works identically to the mono version, the only difference being that two channels are processed individually yet using an identical scaling factor, where the signal level is computed as the maximum of the left and right channel. This ensures that both channel will always be scaled by a same amount, unlike what would happen using two distinct mono Level Response modules.


