SOX-LEVEL

[GENERIC-FUNCTION]


OM-SoX
Function Reference
ARGUMENTS:
  - gain gain (dB) [default = 0]
&key
 
  - options options (applied before gain)  
  - balance-mode balance channels in a multichannel-file using peak or rms detection  
  - sox-append Append sox-effects/statistics to the processing chain.  

Description:

Amplify, attenuate, limit, normalize audio to/by <gain>. Optionally 'balance' the gain levels of individual channels in multichannel audio.

<gain> specifies amplfication or attenuation in dB.

<options>:
'limit' will invoke a brickwall limiter, thus preventing the audio from clipping. NB: limiting more than a few dBs can cause audible distortion.
'normalize' will normalize the audio relative to 0dBFS; it is often used to normalize audio to a given level below 0dB.
'headroom' option is used to apply gain to provide head-room for subsequent processing.
'reclaim' option is used after a prior invocation of sox-level with 'headroom': if the headroom is not used by subsequent effects, it can be reclaimed with this option.

<balance-mode> specifies how the levels in different channels in multichannel audio are determined in order to change their relative levels.
NB: unlike 'peak' 'rms' might cause clipping in certain channels.



Auto doc generation by OpenMusic 6.7 © 2011 IRCAM