Zita-dpl1 Look-ahead peak limiter
---------------------------------

Dpl1 is a look-ahead digital peak limiter, the kind you would use
after the master fader to avoid clipping when mastering or mixing.
It can be used as an effect on individual instrument tracks as well.
Latency is 1.2 ms rounded up to the nearest multiple of 8, 16 or 32
samples depending on sampling frequency. This amounts to 56 samples
at 44.1 kHz, 64 samples at 48 kHz, and twice those values for 88.2
or 96 kHz.

Dpl1 does NOT limit inter-sample peaks. This is intentional, as it
would add considerable complexity as well as increase latency. Also
any D/A converter worth its monely should be able to handle them,
and on typical signals just setting the threshold 0.5 dB lower will
ensure you are safe.

This LV2 is available in 1, 2, and 4 channel versions.

The controls
------------

Rotary controls can be set by dragging left-right or up-down,
or by using the mouse wheel. In the latter case keeping Shift
pressed will provide smaller steps.

All controls can be automated if the host supports this.
Automation 'touch' is supported as well.

* Input gain. This sets the gain applied before peak detection or
  any other processing. Range is -10 to +30 dB in steps of 0.2 dB.

* Threshold. The maximum sample value at the output. -10 to 0 dB
  in steps of 0.05 dB. Dpl1 will not allow a single sample above
  this level, if it does please report as a bug.

* Release time. This can be set from 1 ms to 1 second. Note that
  Dpl1 allows short release times even on signals that contain
  high level low frequency signals. Any gain reduction caused by
  those will have an automatically extended hold time in order to
  avoid the limiter following the shape of the waveform and create
  excessive distortion. Short superimposed peaks will still have
  the release time as set by this control.

* The 'Pk' meter shows signal level after the input gain control
  and relative to the threshold.

* The 'GR' meter shows the recent percentage of samples having
  more than 0.5 dB gain reduction. If you use Dpl1 just for safety 
  only this should not move at all. Allowing occasional GR up to
  say 10 percent will allow to raise avarage level. Driving the
  GR to full scale will remove all dynamics.


  


