
----------------------------------

   _____                 ____  __
  /     \  __________ ___\   \/ /
 /  \ /  \/  _ \_  _ \ __ \    / 
/    Y    \ <_> ) | \/ ___/    \ 
\____|__  /____/|_|  \______/\  \
        \/                    \_/
              _		  
             | \|\/| 
             |_/|  | 


Morex DM 1.0 Readme

----------------------------------

Description

This is a utility to fix a specific bug that occurs when Buzz tries to load BMX or BMW files.
It may or may not help you recover your music (but is probably worth a try!).

The Problem

When Buzz loads a BMX or BMW file, it loads the machines one at a time in order.  If the machines
were connected to the Master when the file was saved, CPU cycles are expended in switching on each
of the machines as they load, regardless of whether they are actually playing any sound.

This can cause very slow load times, and in extreme cases, can cause such system overload that the
song can no longer be loaded.

The Solution

Best practice is to always disconnect all your machines from the Master before saving.  You may find
this easier if you connect your machines to a single Cheapo DoNothing, then connect that to the master
instead.

If you forget to do this and find your song won't load, then try this utility.  It examines a BMX or
BMW file, and removes any connections to the Master machine. If you still can't load your broken BMX
or BMW after running it through the tool, then this isn't the problem.


Usage

From the command line, change to the DM directory and type

java -cp . DisconnectMaster <input file> <output file>

(for example: java -cp . DisconnectMaster C:\Buzz\Songs\test.bmx C:\Buzz\Songs\fixed.bmx)

Note: You MUST specify an output file and that Java is case sensitive.

It is recommended you back up your original file before running this tool.  You may also need the
Java Runtime Environment from http://java.sun.com.  If the resulting file loads properly, it is also
recommended you save it from buzz before making any further changes.
