home *** CD-ROM | disk | FTP | other *** search
/ PC Format Collection 5 / PCFORMAT5.iso / MIDI / MF2ROL.DOC < prev    next >
Encoding:
Text File  |  1991-04-08  |  5.9 KB  |  136 lines
  1.  
  2. MF2ROL - A MIDI file to .ROL file converter.
  3. Beta V1.1 04/08/91 (See revision history below for new features & bug fixes)
  4. Uploaded originally to the National PC & MIDI Data Bank BBS (708) 593-8703
  5.  
  6. This package should include the following files:
  7.  
  8. MF2ROL.DOC      This file.
  9. MF2ROL.EXE      MIDI File to AdLib .ROL file converter.
  10. LISTBNK.EXE     AdLib instrument bank (.BNK) listing program.
  11. BNK835.BNK      Instrument bank file referenced by all the .CFG files below
  12. PANAMA.MID      Sample MIDI file from BENOIT.ZIP on this BBS.
  13. PANAMA.CFG      Config file suitable for PANAMA.MID
  14. FANTASIA.MID    Another sample MIDI file from LUTE.ZIP on this BBS
  15. ROOTBEER.MID    Another sample MIDI file from PIANSOLO.ZIP on this BBS
  16. STYX-32.MID     Another sample MIDI file from STYX-32.ZIP on this BBS
  17. DEFAULT.CFG     A simple config file.
  18. MT32.CFG        A very incomplete config file to emulate an MT32
  19. MT32INS.CFG     Same as above but with no percussion
  20.  
  21. The author wrote MF2ROL and LISTBNK at home, for his own personal use.  Since
  22. many AdLib and SoundBlaster owners may find these programs useful, they are
  23. being released to the user community.  However, the author retains ownership
  24. of the programs, and they may not be sold for profit.  The package may be
  25. distributed freely, but the contents should not be altered in any way
  26. including this document.  The user is responsible for determining that these
  27. programs are suitable and safe for use on his/her system.
  28.  
  29. MF2ROL -
  30.  
  31. This program converts MIDI files to .ROL files.  This beta version processes
  32. note, program (patch/timbre) and tempo information and ignores pitch-bend and
  33. volume (pressure).  The MIDI file parser is based on Tim Thompson's C
  34. Language MIDI routines found in MIDIFILE.ZIP on this BBS.  To convert a MIDI
  35. file, simply specify it on the command line.  For example to convert a file
  36. MUSIC.MID to a ROL:
  37.  
  38.     mf2rol music.mid
  39.  
  40. This will create the file called music.rol in the current directory.  The
  41. conversion will assume all notes should be played with the instrument
  42. "PIANO1".  To control what timbres (instruments) are used, you may specify a
  43. configuration file as a second argument to the program, for example:
  44.  
  45.     mf2rol music.mid mt32.cfg
  46.  
  47. In this case, the converter will use the information in the config file
  48. MT32.CFG to assign instruments to patch numbers, tracks or channels.  The
  49. config file specifies an instrument bank file to use, percussion mode, and a
  50. set of timbre assignment rules.  Examine the sample config files for
  51. documentation.  You will certainly want to develop your own config files to
  52. emulate the more popular synths.  Some knowledge of MIDI would be handy.
  53. During the conversion, the program prints some important information on the
  54. screen about the MIDI file being converted, like the MIDI channels used,
  55. patches (i.e. programs or instruments) used, and comments (if any) about each
  56. track.  Sometimes, the creator of a MIDI sequence adds comments about what
  57. instrument is on each track, or at least tells you what synth(s) are used.
  58. You can use this information to create a custom config file for that
  59. particular MIDI file.
  60.  
  61. To convert the sample MIDI files in this package to ROLs, use the following
  62. commands:
  63.  
  64.     mf2rol panama.mid panama.cfg
  65.     mf2rol fantasia.mid default.cfg
  66.     mf2rol rootbeer.mid
  67.     mf2rol styx-32.mid mt32ins.cfg
  68.  
  69. When you play the ROLs, remember to tell your player to use BNK835.BNK,
  70. especially for MT32INS.CFG since that file uses unusual instruments not
  71. normally found in the default instrument bank file.  The converter uses a
  72. dynamic allocation method to assign sound-card voices to individual notes.
  73. If there are more simultaneous notes in a MIDI file than there are voices,
  74. the program cuts off the oldest notes currently playing.  Thus, if you
  75. convert MIDI files that have very many simultaneous notes playing, the
  76. resulting ROL may sound choppy.  Take note that many professionally sequenced
  77. files DO use a LOT of notes.  The styx-32 sample is included to illustrate
  78. this effect.
  79.  
  80. LISTBNK -
  81.  
  82. This program lists the contents of an instrument bank file.  For example, to
  83. list the contents of BNK835.BNK use the command:
  84.  
  85.     listbnk bnk835.bnk
  86.  
  87. This will list the instruments to the screen.  To save into a file or to
  88. print, use:
  89.  
  90.     listbnk bnk835.bnk > bnk835.lst
  91.     listbnk bnk835.bnk > prn:
  92.  
  93. A listing of the contents of your favorite instrument bank file is handy when
  94. creating your own config file.
  95.  
  96. ---
  97. I hope you find these programs useful as I have.  Since they are basically
  98. free, please do not expect support.  I am willing to take bug reports
  99. however.  If you do develop a complete config file for the MT32, I'd
  100. appreciate a copy.
  101.  
  102. -Alejandro Kapauan (on the PC & MIDI Data Bank)
  103.  aak@iexist.att.com (internet)
  104.  hdtx51a (Prodigy)
  105.  
  106.  
  107. MF2ROL - MIDI File to AdLib ROL Converter Revision History
  108. ----------------------------------------------------------
  109.  
  110. Version 1.0 Beta 04/06/91
  111. -------------------------
  112. First Release. Limited to 6400 MIDI events.
  113.  
  114. Version 1.1 Beta 04/08/91
  115. -------------------------
  116. 1) Revised the memory allocation method used when reading a MIDI file into
  117. memory.  Will now process files as large as free memory will allow.  Huge
  118. MIDI files can be converted as long as you don't have too many TSRs and
  119. drivers loaded.
  120.  
  121. 2) Instead of giving up when garbage bytes are found after a track (normally
  122. the bytes should contain "MTrk") the program now assumes that the file has
  123. ended.  I have run into a few MIDI files that have extra bytes at the end
  124. that are otherwise okay.
  125.  
  126. 3) When reading a config file, the program now allocates just enough memory
  127. to contain the assignment rules.
  128.  
  129. 4) Added the special instrument called "mute" for use in config files that
  130. tells the program to skip those notes.  This is handy if you want to silence
  131. certain tracks or instruments.
  132.  
  133. -Alejandro Kapauan (on the PC & MIDI Data Bank)
  134.  aak@iexist.att.com (internet)
  135.  hdtx51a (Prodigy)
  136.