File	Date	Author	Commit
D2DDemoPlugin	2012-06-20	zenofbits	[d10b30] v.0.0.1
QMVamp	2012-06-20	zenofbits	[d10b30] v.0.0.1
qm-dsp-1.7	2012-06-20	zenofbits	[d10b30] v.0.0.1
.gitignore	2012-06-20	zenofbits	[d10b30] v.0.0.1
D2DDemoPlugin.sln	2012-06-20	zenofbits	[d10b30] v.0.0.1
readme.txt	2012-06-20	zenofbits	[d10b30] v.0.0.1

Read Me

To build the project:
---------------------
The project   D2DDemoPlugin is a VS2008 project.  It was generated by the WMP12 wizard found in the Microsoft Windows SDK 7 so it's a COM plugin for WMP12.  So all you need to generate the dll is the SDK and VS2008.  The wizard actually generates sample code for simple Bars and Wave visualizations using the classic GDI.

To play with the plugin:
------------------------
You'll need a beat file for every song you want to play.  To generate the beat files, you need the Vamp plugins host binaries.  The actual executable file for Windows is vamp-simple-host.exe.  The beat file must have the same name as your song with the extension .beat appended, for eample:

Song file name:  mysong.mp3
Beat file name:  mysong.mp3.beat

And the beat file must be in the same folder as your song.

To make beat files:
-------------------
You need the QM Vamp plugins files in their standard folder "C:\Program Files (x86)\Vamp Plugins" so vamp-simple-host.exe will find them.
Run cmd and navigate to where your vamp-simple-host is located (you may want to add the Vamp Pluggins path to your cmd environment).
Type this command in you cmd window:
vamp-simple-host qm-vamp-plugins:qm-tempotracker mysong.wav -o mysong.mp3.beat
Notice the input file is a wav file because vamp-simple-hostdoes not have any audio decoder.  So you need to convert your compressed music file using a tool like Audacity.

To install the D2DDemoPlugin for WMP12:
---------------------------------------
VS2008 automatically installs the WMP plugin every time you successfully compile the code.  If you are in a hurry to just play with the dll, drop the 32-bit D2DDemoPlugin.dll file into the standard WMP folder for viz plugins "C:\Program Files (x86)\Windows Media Player\Visualizations".  If the dll is 64-bit, the viz plugins folder is "C:\Program Files\Windows Media Player\Visualizations".
Open cmd, navigate to the previous folder and type:
Regsvr32.exe D2DDemoPlugin.dll 

To unsinstall:
--------------
Regsvr32.exe /u D2DDemoPlugin.dll 


Links:
------
QM Vamp Plugins page:  http://www.vamp-plugins.org/plugin-doc/qm-vamp-plugins.html
QM Vamp Plugins download page:  http://isophonics.net/QMVampPlugins
Vamp Plugins download page:  http://www.vamp-plugins.org/develop.html
vamp-simple-host:  https://code.soundsoftware.ac.uk/attachments/download/229/vamp-plugin-sdk-2.3-binaries-win32-mingw.zip