HelpSource/Classes/Wavetable.schelp

   1 CLASS::Wavetable
   2 summary::sampled audio buffer in wavetable format
   3 related::Classes/Signal
   4 categories:: Signals
   5
   6 DESCRIPTION::
   7 A Wavetable is a FloatArray in a special format used by SuperCollider's interpolating oscillators. Wavetables cannot be created by strong::new::.
   8
   9 CLASSMETHODS::
  10
  11 method::sineFill
  12 Fill a Wavetable of the given size with a sum of sines at the given amplitudes and phases. The Wavetable will be normalized.
  13 code::
  14 Wavetable.sineFill(512, 1.0/[1, 2, 3, 4, 5, 6]).plot;
  15 ::
  16 argument::size
  17 must be a power of 2.
  18 argument::amplitudes
  19 an Array of amplitudes for each harmonic beginning with the fundamental.
  20 argument::phases
  21 an Array of phases in radians for each harmonic beginning with the fundamental.
  22
  23 method::chebyFill
  24 Fill a Wavetable of the given size with a sum of Chebyshev polynomials at the given amplitudes for use in waveshaping by the link::Classes/Shaper:: ugen. The Wavetable will be normalized.
  25 code::
  26 Wavetable.chebyFill(513, [1]).plot;
  27 Wavetable.chebyFill(513, [0, 1]).plot;
  28 Wavetable.chebyFill(513, [0, 0, 1]).plot;
  29 Wavetable.chebyFill(513, [0.3, -0.8, 1.1]).plot;
  30 ::
  31 argument::size
  32 must be a power of 2 plus 1, eventual wavetable is next power of two size up.
  33 argument::amplitudes
  34 an Array of amplitudes for each Chebyshev polynomial beginning with order 1.
  35
  36 INSTANCEMETHODS::
  37
  38 method::plot
  39 Plot the Wavetable in a window. The arguments are not required and if not given defaults will be used.
  40 code::
  41 Wavetable.sineFill(512, [0.5]).plot;
  42 Wavetable.sineFill(512, [1]).plot("Table 1", Rect(50, 50, 150, 450));
  43 ::
  44 argument::name
  45 a String, the name of the window.
  46 argument::bounds
  47 a Rect giving the bounds of the window.
  48 argument::minval
  49 the minimum value in the plot. Defaults to the highest value in the data.
  50 argument::maxval
  51 the maximum value in the plot. Defaults to the lowest value in the data.
  52 argument::parent
  53 a window to place the plot in. If nil, one will be created for you.
  54
  55 method::asSignal
  56 Convert the Wavetable into a Signal.
  57 code::
  58 Wavetable.sineFill(512, [1]).asSignal.plot;
  59 ::