HelpSource/Classes/IFFT.schelp

   1 class:: IFFT
   2 summary:: Inverse Fast Fourier Transform
   3 related:: Classes/FFT, Guides/FFT-Overview
   4 categories::  UGens>FFT
   5
   6
   7 Description::
   8 The inverse fast fourier transform converts from frequency content to a
   9 signal.
  10
  11 The fast fourier transform analyzes the frequency content of a signal. The IFFT UGen converts this emphasis::frequency-domain:: information back into emphasis::time-domain:: audio data. Most often this is used as the end of a process which begins with link::Classes/FFT::, followed by frequency-domain processing using PV (phase-vocoder) UGens, followed by IFFT.
  12
  13 classmethods::
  14
  15 method::new
  16
  17 argument::buffer
  18
  19 The FFT "chain" signal coming originally from an FFT UGen, perhaps via other PV UGens.
  20
  21 argument:: wintype
  22 Defines how the data is windowed:
  23 table::
  24 ## -1 || strong::rectangular:: windowing, simple but typically not recommended;
  25 ## 0 || (the default) strong::Sine:: windowing, typically recommended for phase-vocoder work;
  26 ## 1 || strong::Hann:: windowing, typically recommended for analysis work.
  27 ::
  28
  29 argument:: winsize
  30 Can be used to account for zero-padding, in the same way as the link::Classes/FFT:: UGen.
  31
  32 returns::
  33 The emphasis::time-domain:: audio signal.
  34
  35 discussion::
  36 The IFFT UGen converts the FFT data in-place (in the original FFT buffer) and overlap-adds the result to produce a continuous signal at its output.
  37
  38 Examples::
  39
  40 code::
  41 s = Server.local;
  42
  43 b = Buffer.alloc(s,2048,1);
  44
  45 SynthDef("help-noopFFT", { arg out=0,bufnum=0;
  46         var in, chain;
  47         in = WhiteNoise.ar(0.01);
  48         chain = FFT(bufnum, in);
  49         chain.inspect; // its an FFT
  50         Out.ar(out,
  51                 IFFT(chain) // inverse FFT
  52         );
  53 }).play(s,[\out,0,\bufnum,b.bufnum]);
  54 ::
  55