HelpSource/Classes/FSinOsc.schelp

   1 class:: FSinOsc
   2 summary:: Fast sine oscillator.
   3 related:: Classes/SinOsc, Classes/SinOscFB
   4 categories::  UGens>Generators>Deterministic
   5
   6 Description::
   7
   8 Very fast sine wave generator (2 PowerPC instructions per output sample!)
   9 implemented using a ringing filter. This generates a much cleaner sine
  10 wave than a table lookup oscillator and is a lot faster. However, the
  11 amplitude of the wave will vary with frequency. Generally the amplitude
  12 will go down as you raise the frequency and go up as you lower the frequency.
  13
  14 warning::
  15 In the current implementation, the amplitude can blow up if the
  16 frequency is modulated by certain alternating signals.
  17 ::
  18
  19
  20 classmethods::
  21
  22 method::ar, kr
  23
  24 argument::freq
  25 Frequency in Hertz.
  26
  27 argument::iphase
  28 Initial phase offset.
  29
  30 argument::mul
  31 Output will be multiplied by this value.
  32
  33 argument::add
  34 This value will be added to the output.
  35
  36
  37 Examples::
  38
  39 code::
  40 { FSinOsc.ar(800, 0.0, 0.25) }.play;
  41
  42 { FSinOsc.ar(XLine.kr(200,4000,1),0.0, 0.25) }.play;
  43
  44 // loses amplitude towards the end
  45 { FSinOsc.ar(FSinOsc.ar(XLine.kr(4,401,8),0.0, 200,800),0.0, 0.25) }.play;
  46 ::
  47