HelpSource/Classes/Peak.schelp

   1 class:: Peak
   2 summary:: Track peak signal amplitude.
   3 related:: Classes/PeakFollower
   4 categories::  UGens>Analysis>Amplitude
   5
   6
   7 Description::
   8
   9 Outputs the peak amplitude of the signal received at the input. When
  10 a trigger occurs at the  code::reset::  input, the maximum
  11 output value is reset to the current value.
  12
  13
  14 Internally, the absolute value of the signal is used, to prevent
  15 underreporting the peak value if there is a negative DC offset. To obtain
  16 the minimum and maximum values of the signal as is, use the
  17 link::Classes/RunningMin::  and  link::Classes/RunningMax::  UGens.
  18
  19
  20 classmethods::
  21
  22 method::ar, kr
  23
  24 argument::in
  25
  26 The input signal.
  27
  28 argument::trig
  29
  30 Trigger. Resets the output value to the current input value. A trigger happens when the signal changes from non-positive to positive.
  31
  32
  33 Examples::
  34
  35 code::
  36
  37 (
  38 {
  39         SinOsc.ar(
  40                         Peak.ar(Dust.ar(20), Impulse.ar(0.4)) * 500 + 200,
  41                         0, 0.2
  42         )
  43
  44 }.play;
  45 )
  46
  47 // follow a sine lfo, reset rate controlled by mouse x
  48 (
  49 {
  50         SinOsc.ar(
  51                         Peak.kr(SinOsc.kr(0.2), Impulse.kr(MouseX.kr(0.01, 2, 1))) * 500 + 200,
  52                         0, 0.2
  53         )
  54
  55 }.play;
  56 )
  57
  58 ::
  59