m2BUZZ v3.6     (by vII   muehle@theory.phy.tu-dresden.de)
	    -----------

Introduction/Purpose:
---------------------
This program converts 4/6/8 channel MOD, XM and MIDI-files to BUZZ-songs
(BMX- or BMW-files), allows to merge 2 BUZZ songs into one or to
transform a BUZZ song with several options including transposing/cloning
of generators and wave tuning/ripping.

There's a lot you can do with the program, so you should read the
helpfile to learn more about it. As quickstart tutorial:
     -launch m2bvc.exe
     -press the "Help" button ;)

Disclaimer:
-----------
I don't take any responsibilities for anything resulting from use of
this code/program to any person, data, computer or foreign race in
a foreign galaxy.

THIS CODE IS NOT CAREFULLY TESTED!!! at least only by myself and few
example files. I did my best, but this may not be sufficient.

The resulting files sometimes crash BUZZ, but I tried to reduce this.
Often incorrect input files are responsible for wrong output.


News  (more details in m2buzz.rev) :
-------------------------------------
  version 3.6:
  -------------
       -fixed MOD sampleoffset effect (thanks to Renegade)
       -fixed MOD volume handling and volume slides (thanks to Daniel Baum)
       -allow (almost) any generator as conversion/cloning target

  version 3.5:
  ------------
   -complete (and fixed) song merging
   -player for MOD and BUZZ formats
   -automatic machine update for unknown machines
   -changed (improved?) outfit a bit
   -now compiled with VisualC (probably needs some runtime dll's
    which you should already have with BUZZ)


    -for more details look into m2buzz.rev and the help file

Installation:
-------------
	  -unrar all files into one directory (with subdirectories!!),
	   that's done automatically by the "installer"
	   (probably already is done, when you read this)
	  -start the GUI (m2bvc), or better add a link to your desktop or
	   startmenu or anythere you like (the working directory has to be
	   where you installed the files to!)
	  -now choose your MOD or XM files on the first tab and push "Convert"
	  -for MIDI files have a look at the MIDI tab
	  -before you start with song merging look into the help file
	  -you may want to insert your XI-directory in the BUZZ wavetable
	   section, but that's not necessary
	  -for more about the option settings and the program push the
	   "Help"-Button

Uninstallation:
---------------
	  -simply remove the program-directory, and maybe the XI-directory
	  -no registry settings are used, no ini-file stays in the Windows-directory

Comments: -I've done most of the coding and testing with the DOS version,
	   if something doesn't work with the GUI, try the DOS version.
	   Because the DOS programs also use the ini-File of the GUI you
	   can set the options with the GUI and save them, then simply type
		     m2buzz inputfile [outputfile]
	   in a DOS shell.
	  -for version v2.1: I concentrated on the new "Make BMX+waves"
	   option, maybe this introduced some new errors to the "Make BMW"
	   option
	  -If you set logging to on you can save all output of the DOS
	   version into a logfile by redirecting it:
		     m2buzz [inputfile] [outputfile] >logfile
	   You even get some info for S3M,XI,BMX and BMW input files,
	   but I can't imagine what you want to do with it ;)

In either case you'll find the output file (if you gave no name it's
m2buzz.bmx or m2buzz.bmw). Now you should be able to play the song.
Listen...and be impressed (or look into the "Bugs/Missing Features"
part of the help file, to understand, what's going wrong).


That's all. The program originally was meant to get MIDI-input via
Fasttracker II, saving it as a 32 patterns 8-channel modul, converting it
to buzz and copy/paste it into other songs. That's rather complicated,
but did kind of work.
Now it has a bit evolved... I hope this is a nice toy while waiting
for BUZZ 2 ;)

Big thanks to Oskari Tammelin for BUZZ. Never has tracking been that lot
of fun. Let's grow BUZZ. The BUZZ player code+dll is also by him.
Thank David Lai for his source code and Stefano Maini for Easyxmid,
giving me a very fast way of doing what I wanted (although now almost
everything is replaced by my own). The intern midi code is almost
unchanged based on the midilib by Tim Thompson, very fine package.
I couldn't get the propertysheet page to work, so I used a tabbed
dialog (c) Edward McCreary (1994) with some major adaptions to Windows95.
I don't intend to take the troubles of IT conversion on me, so I'm
thankful to Andy Voss that somebody already has done this.
The MOD formats player uses the BASS-library (c) Ian Luck.

Further I wish to thank
     -Rasmus Schultz for his very constructive help
     -Gabriel Winter for helping to fix the NT and other bugs
     -Nick Alevridis and Fabio Napodano for help and suggestions
and last but not least MAZ for hints,discussions and his general work.