PC2MID - Personal Composer to MIDI file converter
         -------------------------------------------------

         Kevin Weiner  June 1990
         Public domain code - may be freely copied and used.


         PC2MID is a makeshift program for converting Personal Composer
         files to standard MIDI format (until such a facility is added to
         PC).  Since specs for PC files were not available, this program
         works on the output of the PC song file disassembly program, DASM.
         Conversions are not complete - only note on/off messages, program
         changes, and sustain pedal are processed.  An initial tempo
         message, if any is used, but not subsequent tempo changes.  There
         is a limit of about 8200 processed events per MIDI channel.

         Conversion steps (follow these carefully):

         1. Save a temporary version of your PC file in which recorded
         tracks are retained.  It is recommended that graphics and other
         information NOT be saved in this file.

         2. Run the PC disassembly program as follows:

             dasm -full pcfile >dasmfile

             (This usually produces a lot of output - and much more if     
              graphics were saved.)

         3. Run PC2MID on the output file from dasm to create a MIDI file.


         The command format for PC2MID is as follows:

             pc2mid dasmfile midifile [options]

         [options] may include the following:

          -fn   specifies MIDI file format to write.  Default is -f1.
                   -f0  single track format
                   -f1  multi-track format.  Each channel's data
                         will be written to a separate track (but
                         original PC tracks are not retained if
                         they are not channelized).

          -tn   specifies tempo to use if none is specified in the
                file (default is -t120).

          -vn   randomizes note velocities +/- n units.  Use with care.
                Default is -v0.

          -en   randomizes event times +/- n ticks.  It is usually not
                wise to let event times vary by more than a few ticks.
                Default is -e0.

         After PC2MID has read the track data it will request up to 5 lines
         of title text to insert in the file.  Just press return for fewer
         than 5.  If format 1 output is being used, you will also be
         prompted for instrument name text for each channel.  Until you are
         satisfied with a conversion, it is a good idea not to waste time
         entering this text.

         As an example, if you have a Personal Composer file (with tracks
         saved) called song.pc, do the following:

            dasm -full song.pc >out
            pccon out song.mid

              <answer any text prompts>

         That should be it.  Hopefully, Personal Composer will be able to
         export MIDI files on its own one day in the not too distant future
         (fingers crossed).  This program is a quick fix which should
         handle many conversion cases until then, but a full-featured
         utility wasn't justified.  So what you see is what you get.

         Good luck!