HelpSource/Classes/Normalizer.schelp

   1 class:: Normalizer
   2 summary:: Flattens dynamics.
   3 related:: Classes/Amplitude, Classes/Compander, Classes/CompanderD, Classes/Limiter
   4 categories:: UGens>Dynamics
   5
   6
   7 Description::
   8
   9 Normalizes the input amplitude to the given level. Normalizer will not
  10 overshoot like  link::Classes/Compander::  will, but it needs to look
  11 ahead in the audio. Thus there is a delay equal to twice the value
  12 of the  code::dur::  parameter.
  13
  14
  15 classmethods::
  16
  17 method::ar
  18
  19 argument::in
  20 The signal to be processed.
  21
  22 argument::level
  23 The peak output amplitude level to which to normalize the input.
  24
  25 argument::dur
  26
  27 The buffer delay time. Shorter times will produce smaller delays
  28 and quicker transient response times, but may introduce amplitude
  29 modulation artifacts.
  30
  31
  32 Examples::
  33
  34 code::
  35
  36 (
  37 // example signal to process
  38 Synth.play({
  39         var z;
  40         z = Decay2.ar(
  41                 Impulse.ar(8, LFSaw.kr(0.25, -0.6, 0.7)),
  42                 0.001, 0.3, FSinOsc.ar(500));
  43 }, 0.8)
  44 )
  45
  46 (
  47 Synth.play({
  48         var z;
  49         z = Decay2.ar(
  50                 Impulse.ar(8, LFSaw.kr(0.25, -0.6, 0.7)),
  51                 0.001, 0.3, FSinOsc.ar(500));
  52         [z, Normalizer.ar(z, 0.4, 0.01)]
  53 }, 0.5)
  54 )
  55
  56 ::
  57