/*******************************\
|				|                           
|   Wigware Ambisonic Decoder	|
|      Version 0.3.2 (alpha)	|
|	   27-06-2006		|
|				|
\*******************************/

0. You use this software at your own risk, I cannot
   and willnot be held responsible for any adverse effects
   this software causes.....IT IS STILL IN THE ALPHA STAGE
   OF DEVELOPMENT (not that is should do, however ;-)
1. Unzip these files into whatever directory you want.
2. Double click the "reg.bat" to register the filter.
3. To uninstall, run the "unreg.bat" file.
4. If you do not get a popup saying "successfully registered......"
   then you need to locate the file "regsvr32.exe" and edit the 
   batch files to include this into the path of the "regsvr32.exe"
5. It is normally found in c:\windows\system32, incidentally!
6. To make B-format files, please use the software made by Richard
   Dobson found here: http://www.bath.ac.uk/%7Emasrwd/mctools.html

Changes from 0.3.1b to 0.3.2
1. Added support for 3 channel, W,X & Y only, files.

Changes from 0.3.1 to 0.3.1b (Quad only)
1. Fixed incorrect decoding coefficients!

Changes from 0.3 to 0.3.1
1. Removed the debug window on public builds as it _seems_ to be causing 
   problems in Windows Media Player causing slightly irratic behaviour when
   the plugin is called more than once (i.e. more than one wavefile is in the
   playlist etc.)
2. Added a with-height cube decoder (order of channels is top front left and 
   then anti-clockwise from there, followed by bottom front left and then
   anti-clockwise from there).

Changes from 0.2.4 to 0.3
1. Support for 16, 20, 24 & 32 bit (including 32-bit float) is now confirmed
   as fully working.
2. Fixed a bug where I was creating buffers twice as long as I needed to!
   That should save a few kB of memory usage (process_audio algorithm got
   it correct, however, so no processor usage saving!)
3. Major code rewrite allowing me to easily add new decoders and support
   for different numbers of inputted channels.  As soon as there is software
   available to create these files, I'll enable it!
4. Changed the decoding code so new decoders can be added easily, and I've
   added support for:
	4 speaker quad
	4 speaker ITU
	6 speaker hex with a speaker at centre front
	6 speaker hex with speakers offset from centre front
	8 speaker hex with a speaker at centre front
	8 speaker hex with speakers offset from centre front
5. As windows doesn't support speakers in these locations, order of channels
   are starting from centre front, going anti-clockwise.

Changes from 0.2.3 to 0.2.4
1. Support for 16-bit, 20-bit (packed as 24-bit), 24-bit and 32-bit PCM 
   (fixed point) now included.  My system won't output 32-bit float, so
   although it's included, I can't test it.....just get noise!
2. Changed all processing to double floating point precision (64-bit) to
   solve a problem with 32-bit int conversion causing very high processor
   usage.
Known issues for 0.2.4
1. WARNING - if you you have AC-3 filter installed the AC-3 filter will 
   insert itself between my plugin and the audio device
   You can turn this feature off in AC-3Filter.  If you leave it on,
   be aware that it MAY ruin the decode if you don't have a standard 
   matrix setup in it (i.e. it is fine if you have a 1-to-1 mapping 
   of inputs to outputs)!

Changes from 0.2.2 to 0.2.3 (NOTE: even if you have a previous version
installed, you will need to re-register this filter).
1. 24-bit fixed point now included, so now the decoder supports:
   a.  16-bit fixed point files
   b.  24-bit fixed point files
Known issues for 0.2.3
1. 32-bit floating point decoding is broken (and always has been, it seems)
   Not sure why yet, I'm looking into it.
2. WARNING - if you play 24-bit files and you have AC-3 filter installed
   the AC-3 filter will insert itself between my plugin and the audio device
   You can turn this 'feature' off in AC-3Filter, but be aware that it MAY
   ruin the decode if you don't have a standard matrix setup in it!

Changes from 0.2.1 to 0.2.2
1. Fixed a bug in the shelf filters causing them to not 
   work correctly!

Changes from 0.2 to 0.2.1
1. Fixed a bug where the back right speaker was outputting 
   exactly the same sound as the back left speaker....ooops.
   Like I said.....Alpha version ;-)