The mirage was the hardest to program. It takes a huge amount of data to 
make up a sound and the mirage doesn't have enough horsepower to keep
up with todays modern PC.

The midi channel doesn't matter. It is not used. The SGU status will return
the operating system version from the mirage. You MUST HAVE MASOS 2.0 in 
your mirage. It won't work with the normal OS. The program will turn off
parameter 91 in the beginning. Leave it off. If you reboot your mirage while
midilib is still running, turn parameter 91 off yourself (or restart midilib).

I put in the most error checking of any of the dlls with the mirage. If you
get an error, try again. I was getting about a 20-30% error rate.

I save the data to the disk exactly as it appears "on the wire". The idea is
that any sysex dumper can send it back to the mirage later. The downside
is that a sound takes about 256k of disk space instead of 128k.

The reality is that no dumper will ever be able to send those sounds back to
the mirage because they will dump it too fast. The mirage can't keep up. 
I could be convinced to compress the data into 128K files but that violates
the idea of keeping the data in its native format. There are good arguments
either way.

When reading data from the mirage, I read the program and 64k of wave from
both halves at the same time. That's the way it is stored to disk as well.
I could break it up into upper and lower halves but then you have to keep
track of which upper goes with which lower and you have to open two different
files and do two different dumps. It's just easier to treat the upper and
lower halves as one unit.


Be aware the dumping to or from the mirage takes about 2 minutes. There's
nothing I can do about that. The program will time out if there is an error.
You should never have to reboot. Look at the lights on your mirage. You should
be able to tell if it's communicating or not. If it's not communicating, 
the midilib program should time out within 1 minute.

When you save your files, take advantage of Windows 95 long filenames. Since
the mirage doesn't store names with its sounds, use the Windows 95 file 
name to describe the sound. We have the technology, lets use it to overcome
the mirage's shortcomings.

