HelpSource/Classes/Compander.schelp

   1 class:: Compander
   2 summary:: Compressor, expander, limiter, gate, ducker
   3 categories:: UGens>Dynamics
   4
   5 description::
   6 General purpose (hard-knee) dynamics processor.
   7
   8 classmethods::
   9 method:: ar
  10 argument::in
  11 The signal to be compressed / expanded / gated.
  12
  13 argument::control
  14 The signal whose amplitude determines the gain applied to the input signal. Often the same as in (for standard gating or compression) but should be different for ducking.
  15
  16 argument::thresh
  17 Control signal amplitude threshold, which determines the break point between slopeBelow and slopeAbove. Usually 0..1. The control signal amplitude is calculated using RMS.
  18
  19 argument::slopeBelow
  20 Slope of the amplitude curve below the threshold. If this slope > 1.0, the amplitude will drop off more quickly the softer the control signal gets; when the control signal is close to 0 amplitude, the output should be exactly zero -- hence, noise gating. Values < 1.0 are possible, but it means that a very low-level control signal will cause the input signal to be amplified, which would raise the noise floor.
  21
  22 argument::slopeAbove
  23 Same thing, but above the threshold. Values < 1.0 achieve compression (louder signals are attenuated); > 1.0, you get expansion (louder signals are made even louder). For 3:1 compression, you would use a value of 1/3 here.
  24
  25 argument::clampTime
  26 The amount of time it takes for the amplitude adjustment to kick in fully. This is usually pretty small, not much more than 10 milliseconds (the default value). I often set it as low as 2 milliseconds (0.002).
  27
  28 argument::relaxTime
  29 The amount of time for the amplitude adjustment to be released. Usually a bit longer than clampTime; if both times are too short, you can get some (possibly unwanted) artifacts.
  30
  31 discussion::
  32 If any of this is confusing, see http://en.wikipedia.org/wiki/Audio_level_compression
  33
  34 examples::
  35
  36 code::
  37 (
  38 // example signal to process
  39 play({
  40     var z;
  41     z = Decay2.ar(
  42         Impulse.ar(8, 0,LFSaw.kr(0.3, 0, -0.3, 0.3)),
  43         0.001, 0.3, Mix.ar(Pulse.ar([80,81], 0.3)))
  44 })
  45 )
  46 ::
  47
  48 code::
  49 (
  50 // noise gate
  51 play({
  52     var z;
  53     z = Decay2.ar(
  54         Impulse.ar(8, 0,LFSaw.kr(0.3, 0, -0.3, 0.3)),
  55         0.001, 0.3, Mix.ar(Pulse.ar([80,81], 0.3)));
  56     Compander.ar(z, z,
  57         thresh: MouseX.kr(0.1, 1),
  58         slopeBelow: 10,
  59         slopeAbove: 1,
  60         clampTime: 0.01,
  61         relaxTime: 0.01
  62     );
  63 })
  64 )
  65 ::
  66
  67 code::
  68 (
  69 // compressor
  70 play({
  71     var z;
  72     z = Decay2.ar(
  73         Impulse.ar(8, 0,LFSaw.kr(0.3, 0, -0.3, 0.3)),
  74         0.001, 0.3, Mix.ar(Pulse.ar([80,81], 0.3)));
  75     Compander.ar(z, z,
  76         thresh: MouseX.kr(0.1, 1),
  77         slopeBelow: 1,
  78         slopeAbove: 0.5,
  79         clampTime: 0.01,
  80         relaxTime: 0.01
  81     );
  82 })
  83 )
  84 ::
  85
  86 code::
  87 (
  88 // limiter
  89 play({
  90     var z;
  91     z = Decay2.ar(
  92         Impulse.ar(8, 0,LFSaw.kr(0.3, 0, -0.3, 0.3)),
  93         0.001, 0.3, Mix.ar(Pulse.ar([80,81], 0.3)));
  94     Compander.ar(z, z,
  95         thresh: MouseX.kr(0.1, 1),
  96         slopeBelow: 1,
  97         slopeAbove: 0.1,
  98         clampTime: 0.01,
  99         relaxTime: 0.01
 100     );
 101 })
 102 )
 103 ::
 104
 105 code::
 106 (
 107 // sustainer
 108 play({
 109     var z;
 110     z = Decay2.ar(
 111         Impulse.ar(8, 0,LFSaw.kr(0.3, 0, -0.3, 0.3)),
 112         0.001, 0.3, Mix.ar(Pulse.ar([80,81], 0.3)));
 113     Compander.ar(z, z,
 114         thresh: MouseX.kr(0.1, 1),
 115         slopeBelow: 0.1,
 116         slopeAbove: 1,
 117         clampTime: 0.01,
 118         relaxTime: 0.01
 119     )*0.1;
 120 })
 121 )
 122 ::