
Midiplay Version 0.1
--------------------

  Midiplay is a very simple sequencer for playing MIDI files to the
Midiator MS-124W serial port MIDI adapter, made by Key Electronics.
In order to run midiplay, the midi daemon must be running, and a 
Midiator must be connected to a system serial port managed by midid.

Midiplay has a few limitations in this initial 0.1 version.
  1) Midiplay currently only plays Type 1 MIDI files.  Support for
     Type 0 and Type 2 MIDI files will come in a future version.

  2) Midiplay ignores the "port" data in a MIDI sequence, all MIDI 
     messages are sent to the Midiator, and they are sent on all 4
     MIDI outputs.  This will change in the future, when a MIDI mapper
     interface has been written for midid / midiplay.

  3) The only Meta Events supported in the midiplay sequencer are
     tempo change events.  All other meta events are currently ignored.
     (other meta events should not cause playback problems, but these
      events are dispatched to a handler which doesn't do anything with
      them currently.)

  4) Killing midiplay via ctrl-c or with the "kill" command, will not 
     currently flush the MIDI event queues.  Any MIDI events already
     in the MIDI event queue will be played by midid, until the queue
     is empty.  This may cause "stuck notes" on attached synthesizers.
     A future version of midid will include signal handlers and code to
     generate a MIDI panic event which will cause an "all notes off" event
     to be sent to all attached synthesizers.

  5) midiplay may do bad things if it is given a corrupt MIDI file,
     I haven't checked for this kind of problem extensively, so
     handling for corrupt files will be dealt with better in the next
     release.  In this release, it is at least able to skip trying to play
     files with corrupt chunk ID's and things like that.    

  6) midiplay does not correctly handle SMPTE based time stamps.
     I'm not positive this is true, but since I don't have any
     to try, I'm guessing its likely not to work correctly.  If
     anyone has a small MIDI file with SMPTE based tempo etc,
     send me one.


