HelpSource/Classes/SOS.schelp

   1 class:: SOS
   2 summary:: Second order filter section (biquad).
   3 related:: Classes/FOS
   4 categories::  UGens>Filters>Linear
   5
   6
   7 Description::
   8
   9 A standard second order filter section. Filter coefficients are given
  10 directly rather than calculated for you. Formula is equivalent to:
  11
  12 code::
  13
  14 out(i) = (a0 * in(i)) + (a1 * in(i-1)) + (a2 * in(i-2)) + (b1 * out(i-1)) + (b2 * out(i-2))
  15
  16 ::
  17
  18
  19 classmethods::
  20
  21 method::ar, kr
  22
  23 argument::in
  24
  25 signal input
  26
  27 argument::a0
  28 See formula above.
  29
  30 argument::a1
  31 See formula above.
  32
  33 argument::a2
  34 See formula above.
  35
  36 argument::b1
  37 See formula above.
  38
  39 argument::b2
  40 See formula above.
  41
  42 argument::mul
  43
  44 argument::add
  45
  46 Examples::
  47
  48 code::
  49
  50 // example: same as TwoPole
  51 (
  52 {
  53         var rho, theta, b1, b2;
  54         theta = MouseX.kr(0.2pi, pi);
  55         rho = MouseY.kr(0.6, 0.99);
  56         b1 = 2.0 * rho * cos(theta);
  57         b2 = rho.squared.neg;
  58         SOS.ar(LFSaw.ar(200, 0, 0.1), 1.0, 0.0, 0.0, b1, b2)
  59 }.play
  60 )
  61
  62
  63 (
  64 {
  65         var rho, theta, b1, b2;
  66         theta = MouseX.kr(0.2pi, pi);
  67         rho = MouseY.kr(0.6, 0.99);
  68         b1 = 2.0 * rho * cos(theta);
  69         b2 = rho.squared.neg;
  70         SOS.ar(WhiteNoise.ar(0.1 ! 2), 1.0, 0.0, 0.0, b1, b2)
  71 }.play
  72 )
  73
  74 // example with SOS.kr kr as modulator
  75 (
  76 {
  77         var rho, theta, b1, b2, vib;
  78         theta = MouseX.kr(0.2pi, pi);
  79         rho = MouseY.kr(0.6, 0.99);
  80         b1 = 2.0 * rho * cos(theta);
  81         b2 = rho.squared.neg;
  82
  83         vib = SOS.kr(LFSaw.kr(3.16), 1.0, 0.0, 0.0, b1, b2);
  84         SinOsc.ar( vib * 200 + 600) * 0.2
  85 }.play
  86 )
  87
  88 ::
  89