home *** CD-ROM | disk | FTP | other *** search
/ Sound, Music & MIDI Collection 2 / SMMVOL2.bin / MIDI_PAT / MTOOLS.ZIP / MTHELP.EXE / UPDATE.DOC < prev    next >
Encoding:
Text File  |  1993-09-14  |  9.8 KB  |  228 lines
  1. MidiTools Updates
  2. =================
  3.  
  4. Following are recent changes and additions to MidiTools not included in
  5. MTOOLS.DOC.
  6.  
  7.  
  8. New programs
  9. ------------
  10.  
  11. MFF2BIN        Converts a standard MIDI file to a binary (MIDIEX) file.
  12.         Only system exclusive messages are transferred.  
  13.         Usage:   mff2bin <MIDI input file> <binary output file>
  14.  
  15. BIN2MFF        Converts a binary (MIDIEX) file to a standard MIDI file.
  16.         Usage:   bin2mff <binary input file>  <MIDI output file>
  17.  
  18. MERGE        Merges one or more MIDI files.  Files may be merged in
  19.         parallel, or spliced sequentially.
  20.         Usage:   merge <output file>  <input file list>  <options>
  21.  
  22.         (Note order of files - the output file is first!)
  23.  
  24.         <options>    -R    Replace the output file (default 
  25.                     is to merge into the output file)
  26.  
  27.                 -S    Splice the files sequentially 
  28.                     (default is to merge in parallel)
  29.  
  30.                 -Fn    Select output file format - 0, 1, 2 
  31.                     (default is 1st file's format)
  32.  
  33. PLAY/D:        A driver-only version of Play/R called Play/D is now included
  34.         (playd.exe).  It is identical to Play/R except there is no
  35.         pop up control window.  Run the self-extracting archive file
  36.         playrdev.exe to extract the programming related files,
  37.         especially API.DOC, which describes the applications 
  38.         programming interface.
  39.  
  40.  
  41. Program changes
  42. ---------------
  43.  
  44. Play:        Alt-F7 now selects among 3 sync modes: internal, internal
  45.         master, and external.  See the help file.
  46.  
  47. All players:    The following interface types have been added,
  48.         supplementing the list in Appendix A:
  49.  
  50.             -dsbfm        Sound Blaster FM sound
  51.  
  52.             -dadlib        Adlib FM sound
  53.  
  54.             -dserial    Generic serial device - 38400 baud
  55.  
  56.         As with the MIDIator, the new generic serial option takes as a
  57.         first option value the com port number (i.e., -dser:2 selects
  58.         com 2).  The generic serial option only works with devices 
  59.         capable of accepting raw 8-bit MIDI data at rates up to 38400 
  60.         bits per second (for example, the new Roland SC-7).  Also, 
  61.         since a serially connected device cannot be automatically 
  62.         detected, the -d option must always be included (or an 
  63.         environment must be set - see Appendix A).
  64.  
  65. All interactive programs:
  66.  
  67.         The file list now displays and allows navigation among 
  68.         directories.
  69.  
  70. Fmt:        A new -Dn option allows a time base to be specified for
  71.         the output file, where n is the number of divisions per 
  72.         quarter note.
  73.  
  74. Play/R:        The applications programming interface has been    expanded to 
  75.         support additional song functions, as well as full MIDI 
  76.         input/output capability.  See the API.DOC file in the
  77.         playrdev.exe self-extracting archive.  This material
  78.         supersedes Appendix B in the manual.
  79.  
  80.         The meaning the timer mode 2 has changed slightly.  It will
  81.         now advance at timer ticks only if DOS is not active.  Mode 3 
  82.         still uses unconditional stepping.
  83.  
  84.         A new -r command line option causes Play/R to unload itself if
  85.         already loaded.  
  86.  
  87.  
  88. Support for Microsoft Windows
  89. -----------------------------
  90.  
  91. Although MidiTools is DOS based, it now includes several additional
  92. files which allow some of the utilities to run more effectively under
  93. Windows 3.1.  If you normally run Windows in Standard mode, this
  94. information does not apply - all the MidiTools utilities will run fine
  95. from the Windows MS-DOS prompt.  This information only applies to 386
  96. Enhanced Mode, where due to the fact that Windows exercises more control
  97. over the hardware, MIDI programs may get "stepped on" by the system. 
  98. There are two areas where the MidiTools Windows support features will
  99. help:
  100.  
  101.     1. Much more accurate timing in the MidiTools player programs,
  102.        plus background playing.
  103.  
  104.     2. A virtual MPU driver, allowing DOS MPU-based programs (such
  105.        as MidiTools) to interoperate with Multimedia Extensions.  This 
  106.        means, for example, that a DOS MIDI program can be used 
  107.        concurrently with a Windows MME MIDI program (when supported by 
  108.        the MME MIDI driver), or that a DOS MPU-based MIDI program work 
  109.        with other, non-MPU devices, even if the DOS program only supports 
  110.        the MPU.
  111.  
  112. Working with DOS under Windows can be a bit like stepping into the
  113. Twilight Zone, and will require some more advanced Windows experience. 
  114. Before proceeding, you should have a good foundation in related Windows
  115. topics, so please read the relevant sections of the Windows manual
  116. regarding running DOS applications, adding program groups and items,
  117. setting up PIF's (program information files), and editing text files
  118. (using the notepad, for example). 
  119.  
  120. *** Windows Timing
  121.  
  122. MidiTools includes a virtual timer driver called timer.386.  Once it is
  123. installed, the player programs can be instructed to use this driver
  124. instead of relying on Windows timing support for DOS, which is not very
  125. consistent.  To install the driver, do the following:
  126.  
  127.     1.  Copy the file timer.386 to your windows\system directory.
  128.         (ex:  copy \mtools\timer.386  \windows\system)
  129.  
  130.     2. Using the Windows notepad, or any other text editor: edit the file 
  131.        \windows\system.ini, find the [386enh] line, and add the following
  132.        device line after it:
  133.  
  134.         [386enh]                             (look for this line)
  135.  
  136.         device=timer.386                     (add this line after it)
  137.  
  138.     3. Start (or restart) Windows.
  139.  
  140. To use the driver: Whenever running one of the MidiTools players in a
  141. DOS window (accessed by clicking on the MS-DOS icon in the "Main"
  142. Program Manager group), add the -h option to the player command line. 
  143. This instructs the player to use the new timer device instead of normal
  144. DOS timing mechanisms (ex: play -h).  To make the MidiTools programs
  145. easier to use under Windows, you may wish to create a new program group
  146. and add the interactive MidiTools programs to that group (play, record,
  147. watch, filter).  Be sure to include -h on the Play, Record, and Watch
  148. command line when setting up the program item (or PIF).  For background
  149. playing to work correctly for any of the players, you will also need to
  150. enable background operations for the DOS Window from its control menu
  151. (upper left box).  You may find it easiest to do this once in a PIF (see
  152. your Windows manual for information on setting up a PIF for a DOS
  153. program). 
  154.  
  155. See note 4 in the Virtual MPU section below regarding 3rd party drivers
  156. which may affect running MidiTools programs in a Window, even if you do
  157. not plan to use the MidiTools virtual MPU driver. 
  158.  
  159.  
  160. *** Virtual MPU
  161.  
  162. The MPU driver included with MidiTools actually consists of two parts. 
  163. The first part is a Windows virtual device driver called VMPU.386.  This
  164. driver fools any DOS program running in a window into thinking that the
  165. driver is a real MPU-401 type MIDI interface - whether or not you
  166. actually have the hardware.  The second part is a Windows program called
  167. VMPU401.EXE.  This is a Multimedia Extensions MIDI program which must be
  168. running in order to a) activate the virtual driver, and b) serve as a
  169. gateway between the virtual MPU and the Multimedia Extensions MIDI
  170. drivers.  To install the virtual driver part, do the following:
  171.  
  172.     1. Copy the file VMPU.386 to your \windows\system directory
  173.          (ex:  copy \mtools\vmpu.386  \windows\system)
  174.  
  175.     2. Edit the file \windows\system.ini and add the line
  176.        "device=vmpu.386" in the [386enh] section.
  177.  
  178.     3. Start (or restart) Windows.
  179.  
  180. To install the MME part of the driver, add a program item to any
  181. convenient group to run the program file \mtools\vmpu401.exe.  Instead
  182. of adding it to a group, you may also run it directly whenever you need
  183. it via the "File" menu of the Program Manager.  Adding a program item
  184. that you can simply click on is recommended, however. 
  185.  
  186. To use the driver, run the VMPU401 program (click on its program icon if
  187. you installed one, or run it from the Program Manager File menu).  It
  188. will display a list of possible input and output MME MIDI drivers. 
  189. Select one of each, and optionally set the simulated IRQ and base
  190. address of the virtual MPU.  Click on OK to enable the emulation.  The
  191. program will reduce to an icon (it must remain active while needed). 
  192. You may now open a DOS window and run any MPU-compatible program. 
  193.  
  194. Virtual MPU notes:
  195.  
  196. 1.  Only one DOS MPU program should be active at a time (or results may
  197. be unpredictable). 
  198.  
  199. 2.  Due to a bug in Windows 3.1 affecting some systems, you may have
  200. trouble running Windows MIDI programs while a DOS window is open if the
  201. Windows MIDI driver is using IRQ 2/9.  The problem affects MIDI input to
  202. the Windows MME program.  If input to any Windows MIDI program stops
  203. while a DOS window is open, you are affected by the problem.  This
  204. problem is unrelated to the MidiTools VMPU driver, though it may cause
  205. some difficulty in using it.  If your DOS MIDI program is using IRQ 2 or
  206. 9, try setting it up to use a different IRQ and set the simulated IRQ in
  207. VMPU401 to be the same.  When using the MidiTools Watch program, for
  208. example, you would run "watch -dmpu:3", if you had set the virtual MPU
  209. to IRQ 3. 
  210.  
  211. 3.  Some DOS MIDI programs use unorthodox timing techniques which do not
  212. allow them to happily coexist with Windows.  Such programs cannot be
  213. used in a DOS window. 
  214.  
  215. 4.  Some Windows MIDI programs (such as Cakewalk for Windows) and some
  216. Windows MIDI drivers (such as those from Music Quest), come with their
  217. own virtual MPU drivers.  The intent of these drivers is to prevent any
  218. DOS program from getting to the MPU hardware.  This is probably not what
  219. you want.  Look in the \windows\system.ini file for any
  220. "device=xxxxxx.386" type lines in the [386enh] section that contain
  221. "MPU" or something similar to the device name (like "MQX") and delete
  222. any such lines (other than the MidiTools VMPU.386 line, of course), or
  223. to be safe, deactivate them by adding a semicolon at the beginning of
  224. the line.  The driver name may vary, so no firm guidelines can be given
  225. here.  Restart Windows afterwards. 
  226.  
  227. -----------------------------------------------------------------------------
  228.