home *** CD-ROM | disk | FTP | other *** search
/ Programming Sound Cards / Programming Sound Cards.iso / sound_49 / mutil2.doc next >
Encoding:
Text File  |  1995-01-01  |  7.6 KB  |  185 lines
  1. 10/10/88
  2.  
  3.                                mUTIL2
  4.  
  5. Roland MT-32 Performance Setup Utility for the IBM PC/MPU 401:
  6. =============================================================
  7.  
  8. Introduction:
  9. -------------
  10.  
  11. This is version 2 of MT32UTIL.EXE, a performance setup utility
  12. for the MT-32 (it seems to work on the D110 as well). This version
  13. is a COMPLETE RE-DESIGN of version 1. The old program had a lot of
  14. major flaws and would not run properly on some machines, mostly
  15. AT's (the MT-32 needs a 20 millisecond delay between MIDI messages
  16. and the old program's delay routine was hardware dependent). This
  17. version SHOULD fix that bug (it's still pretty much untested on
  18. fast machines) ; if it doesn't work, please notify the author.
  19.  
  20. The program was developed on a monochrome XT running at 4.77Mhz
  21. and sporting 512k RAM and DOS 3.2.
  22.  
  23. FEATURES :
  24. You now have access to the ff. for parts 1 to 8 :
  25.    Partial Reserve*
  26.    MIDI Channel
  27.    Timbre Group*
  28.    Timbre Number*
  29.    Key Shift*            (* indicates NEW feature)
  30.    Fine Tune
  31.    Bender Range
  32.    Assign Mode*
  33.    Reverb Switch
  34.    Output Level*
  35.    PAN Pot
  36.  
  37. Furthermore, YOU MAY NOW SAVE AND LOAD PERFORMANCE SETTINGS to
  38. disk files. For example, you may load the utility, set the MIDI
  39. channels of parts 1 to 4 to the same channel, assign different
  40. timbres to these parts and save these changes to a file. At a
  41. later time, you may load these settings from the file so you
  42. don't have to re-enter them.
  43.  
  44. For those kind people who registered their copies of version 1,
  45. THANK YOU. You will be the first to be notified of this and all
  46. succeeding versions. Your contribution was largely responsible
  47. for this version coming out and you needn't feel obligated to
  48. register this or any succeeding versions.
  49.  
  50. For those of you who are new to this program, please support the
  51. shareware concept by registering you copy with a contribution of
  52. $10.00 (US currency). A TIMBRE AND PATCH EDITOR/LIBRARIAN is now
  53. being tested for shareware release and your registration will
  54. facilitate its release.
  55.  
  56.  
  57.  
  58.     Emilio Abello
  59.     2043 Oregon Ave.
  60.     Redwood City, CA. 94061
  61.  
  62. Disclaimer:
  63. ----------
  64.  
  65. In no way does the author warrant the performance or usability of this
  66. software. Use it at your own risk. This utility is to be considered
  67. "shareware" and may not be distributed for profit. This documentation
  68. file should be included with the program if it is to be distributed or
  69. transferred to another person.
  70.  
  71.  
  72. The Registration Fee -- What you get for it :
  73. -------------------------------------------
  74.  
  75. The asking registration fee of 10 dollars is NOT to be construed as
  76. payment for an updated or later version of the software. It is instead
  77. a gesture of appreciation that you bestow upon the author IF (and only
  78. if) you liked the version you currently have. Registered users will be
  79. notified if and when I intend to release any software that may be of
  80. value to them.  Also, a registered user who is notified of an upgrade,
  81. AND sends a 5.25" diskette to me will be sent that upgrade. Generally,
  82. upgrades to software I write will not be placed on BBS systems or net-
  83. works, so if you do receive an upgrade, do NOT distribute it.
  84.  
  85. THE AUTHOR DOES NOT GUARANTEE THAT ANY SOFTWARE WRITTEN BY HIM WILL
  86. IMPROVED.
  87.  
  88.  
  89. Acknowledgements:
  90. ----------------
  91.  
  92. This program would not have been possible if not for the helpful advice
  93. of a kind person on GENIE's MIDI RT BBS (Category 6, Topic 20). All I
  94. know about him is his handle: MWILLIAMS; if you know him, send him my
  95. thanks. He explained how the checksums for Roland MIDI System Exclusive
  96. messages works.
  97.  
  98. Possible Problems :
  99. -----------------
  100.  
  101. Because I am limited to testing the software on my own machine, I have
  102. no way of assuring that it will work on all other machines. Thus, if it
  103. constantly crashes or hangs up, or fails to perform adequately, you can
  104. assume that it isn't going to work on your machine. It is also likely
  105. that any upgrade will perform similarly. Sorry -- I'd like nothing
  106. better than for you enjoy the program so you could register it -- but
  107. there ain't much I could do.
  108.  
  109. If you notice that your computer hangs up often, try this -- connect
  110. the MT32 directly to your MPU401 and turn off all your other MIDI
  111. modules (including your main keyboard). Then run the software, exit,
  112. turn on your other modules, and test it. Hope that works.
  113.  
  114. Note that as a result of using direct screen writes, the program may
  115. be very "snowy" on a CGA adapter.
  116.  
  117. Source Code :
  118. -----------
  119.  
  120. The program was written using Turbo Pascal 4.0 and 5.0. Except for the
  121. MIDI communication routines, all routines make use of a toolbox which
  122. I developed for my company (a real estate software firm). Since these
  123. routines are propietary, I cannot distribute or comment on them, and
  124. since almost all the other routines are dependent on that toolbox, ...
  125. you get my drift.
  126.  
  127. Instructions:
  128. ------------
  129.  
  130. For D110 users, set the UNIT # on your module to 17.
  131.  
  132. From the DOS command line, mUTIL2 may be invoked as follows :
  133.  
  134.    drive> MUTIL [edit file] <CR>
  135.  
  136. The "edit file" may be the name of a file you created using mUTIL2's
  137. "W" option (more on that later); it is entirely optional.
  138.  
  139. After a brief pause, the mUTIL2 screen will pop up. You'll see several
  140. parameters arranged vertically and the 8 parts arranged horizontally
  141. forming a gridlike structure. These eight parts conform to your MT32's
  142. 8 parts. You'll notice a "bar cursor" highlighting a space on the grid.
  143. By typing the + and - keys, you may edit the value of that parameter
  144. for that part. You won't notice any change on the MT32 though, until you
  145. SEND that change to the '32 by typing the <F2> key. You can use the up,
  146. down, left, and right arrow keys to move to a new parameter and edit it
  147. as you did before. Be sure that you type <F2> to send the change (note :
  148. from the main edit screen, when you change a value AND move to another
  149. parameter or part, the program automatically sends the change).
  150.  
  151. You'll notice that if you type <F1> from the main screen, you'll get a
  152. little help screen showing you what features are available. Following is
  153. an explanation of these features :
  154.  
  155.    R - if you type this from the main screen, you'll get a little window
  156.        showing you the reverb paramters you may edit on the MT32. Use the
  157.        cursor up and down keys to highlight the paramter of your choice
  158.        and the + and - keys to change the value. Be sure to send the edit
  159.        using the <F2> key. To get back to the main screen, type <Esc>.
  160.  
  161.    W - the first time you type this from the main screen, you'll be asked
  162.        to enter a filename. Enter a valid filename and type <return> (note:
  163.        it is your responsibility to make sure that you type a valid file-
  164.        name -- if the file exists, it will be overwritten). At this point,
  165.        mUTIL2 will be in "RECORD" mode, dutifully recording whatever
  166.        changes you make. All changes you make will be saved to the file
  167.        you specified UNTIL YOU TYPE THE "W" KEY AGAIN.
  168.  
  169.    L - loads a file of changes made using the "W" option and sends each
  170.        change to the MT32 as it is read from the file. Note that if you
  171.        specify a file on the command line (i.e. if you include an input
  172.        filename when you invoke mUTIL2), that file will be loaded and
  173.        sent automatically to the MT32.
  174.  
  175. <Esc> terminates the program unless you are in REVERB edit.
  176.  
  177.  
  178.  
  179.  
  180. And that's all folks. The utility is much simpler to use now although
  181. some of you will no doubt miss the rhythm part editing capability. Never
  182. fear, that will need will be met in a separate rhythm setup utility which
  183. should come out after the release of my MT32 editor/librarian utilities.
  184.  
  185.