----------
 dvoc 0.2
----------

Compilation:
  Makefile coming soon; for now, simply compile with:
    gcc -Wall -lasound -lpthread -lfftw3 -lm -lrt app.c alsa.c bands.c wav.c dvoc.c -o dvoc

Execution:
  dvoc supports reading from WAV files via its own primitive
  WAV file implementaton or from the soundcard via ALSA (for
  both the carrier and the modulator).  However, dvoc does not
  yet support soundcard capture for both carrier and modulator 
  at the same time.  Thus, at least one of the two must come
  from a WAV file.  Here are a few examples of what is currently
  supported:

  To modulate carrier.wav with formant.wav:
    ./dvoc -c carrier.wav -m formant.wav

  To modulate carrier.wav with captured sound via ALSA:
    ./dvoc -c carrier.wav

  To modulate captured sound with formant.wav:
    ./dvoc -m formant.wav

  By default, dvoc has no notion of bands or channels; that is,
  each bin of the DFT used to implement vocoding is its own 
  channel.  To control the number of channels, use the -b option,
  which accepts two arguments, separated by a colon: the channel
  count, itself, and whether to use linear (0) or logarithmic (1)
  channel spacing. Here are some examples:

  To vocode using 16 linearly-spaced channels:
    ./dvoc -c carrier.wav -m formant.wav -b 16:0

  To vocode using 61 logarithmically-spaced channels:
    ./dvoc -c carrier.wav -m formant.wav -b 61:1

Tips:
  dvoc is a young project, and it is FAR from perfect.  First of 
  all, dvoc currently only supports mono (1-channel) vocoding; 
  try stereo and you'll get something funky.  Second, I'm shooting
  for real-time vocoding, so I've hardcoded the "delay" to 3ms, 
  which is as fast as I can get it to run reliably (without sound
  glitches) on my home laptop, a 1.6Ghz Pentium-M machine.  If 
  your computer is slower than this, you might get horribly
  distorted sound, as I do if I bump the delay down less than 3ms.
  If this happens or if you have any ther problems, feel free
  to e-mail me at hwa5c@virginia.edu.  Happy vocoding!


  



