HelpSource/Classes/DetectSilence.schelp

   1 class:: DetectSilence
   2 summary:: When input falls below a threshhold, evaluate doneAction.
   3 categories::  UGens>Synth control, UGens>Analysis>Amplitude
   4
   5
   6 Description::
   7
   8 When input falls below a threshhold, evaluate doneAction. If the input
   9 signal starts with silence at the beginning of the synth's duration, then
  10 DetectSilence will wait indefinitely until the first sound before
  11 starting to monitor for silence.
  12
  13
  14 classmethods::
  15
  16 method::ar, kr
  17
  18 argument::in
  19
  20 The input signal.
  21
  22
  23 argument::amp
  24
  25 When input falls below this, evaluate
  26
  27 code::doneAction:: .
  28
  29
  30 argument::time
  31
  32 The minimum duration for which input must fall below
  33
  34 code::amp::  before this triggers.
  35
  36
  37 argument::doneAction
  38
  39 An integer representing the doneAction. See
  40
  41 link::Reference/UGen-doneActions::  for more detail.
  42
  43 returns::
  44 This UGen outputs 1 if silence is detected, otherwise 0.
  45
  46 Examples::
  47
  48 code::
  49
  50 (
  51 SynthDef("detectSilence-help", { arg out;
  52         var z;
  53         z = SinOsc.ar(Rand(400, 700), 0, LFNoise2.kr(8, 0.2).max(0));
  54         DetectSilence.ar(z, doneAction:2);
  55         Out.ar(out, z);
  56 }).send(s);
  57 )
  58
  59 s.sendMsg("/s_new", "detectSilence-help", -1);
  60 s.sendMsg("/s_new", "detectSilence-help", -1);
  61 s.sendMsg("/s_new", "detectSilence-help", -1);
  62
  63 (
  64 Task({
  65         loop({
  66                 s.sendMsg("/s_new", "detectSilence-help", -1);
  67                 [0.5, 1].choose.wait;
  68         })
  69 }).play;
  70 )
  71
  72 ::