home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / sound2 / m1sysgen.zip / M1SYSGEN.DOC next >
Text File  |  1993-06-16  |  10KB  |  257 lines
  1. ==================================================================
  2.                      <<   M1SYSGEN v1.0   >>                  
  3.         Copyright (C) 1993 by Larry Ludwick (Wuffle Software Inc.) 
  4. ==================================================================
  5.  
  6. M1SYSGEN is a program that generates random combination patches
  7. for the Korg M1 synthesizer using any standard MIDIEX M1
  8. combination dump as the basis.  It assumes that you already have a
  9. way to receive/send a MIDIEX dump between the M1 and your PC.
  10. The program reads in a MIDIEX M1 combination dump and generates
  11. any number of new MIDIEX dumps.  The dumps can then be transmitted
  12. by whatever means you have back to the M1.  There you can
  13. review/edit and keep the combos that are satisfactory.
  14.  
  15.  
  16. SYSTEM REQUIREMENTS:
  17.  
  18. I haven't tested this program on any system other than a 386 with
  19. VGA graphics, but I'm certain it will run on any PC or clone ( XT
  20. class and up ) with at least CGA graphics.  Not much for
  21. requirements.  It's a DOS program so it doesn't even require
  22. Windows.
  23.  
  24. ANSI.SYS is required in your CONFIG.SYS (ask someone or consult
  25. your DOS manual, if this requirement confuses you).
  26.  
  27.  
  28. As stated above the program requires M1 MIDIEX combination dumps
  29. as input and will write the same as output.  You need a means of
  30. receiving these and transmitting them to your M1.  If you have a
  31. MPU 401 type card, I'm sure you can download a program to perform
  32. this function.  I use CAKEWALK PRO for Windows which has a MIDIEX
  33. send and receive function.
  34.  
  35.  
  36. OVERVIEW:
  37.  
  38. History - The reason I wrote this program is that I needed a
  39. replacement for a patch generation program I had written several
  40. years ago for my M1.  I had an XT clone with an MPU 401 card
  41. (still do).  I uploaded and downloaded from within the program so
  42. no need to mess with MIDIEX.  However, moving on to my 386 loaded
  43. with scanners, frame grabbers and a SB PRO, I discovered I had no
  44. slot left for the MPU 401 (or an interrupt for that matter).  
  45. None of my librarian software would work without the 401 and 
  46. being cheap I didn't want to go beyond CAKEWALK PRO and buy a SB 
  47. PRO version of a librarian.  So in an attempt to save maybe $100,
  48. I spent many (not too many) hours programming this utility.
  49.  
  50. The only controls currently allowed in the program are for 
  51. selection of a single combination to use as a model for the 
  52. combination generation engine.  Also, you can select the target 
  53. range for the generated combinations in the output buffer. As I 
  54. enhance the program in the near future, it will offer selection
  55. of each parameter which defines a combination. This means you
  56. will be able to select the parameters to change and those to 
  57. leave alone.  I also intend to allow a selection of the range of
  58. variation for each parameter (don't want to detune your way to 
  59. hell everytime).  I also have written a program to generate M1
  60. patch programs for my MPU 401. I hope to translate this into a 
  61. similar MIDIEX version in the near future.
  62.  
  63. I know the audience for these utilities must be limited (M1 users
  64. without librarians and combo generators). Even if you have a 
  65. random generator, you can never have too many creative tools for 
  66. you M1 synth.
  67.  
  68. Well, this thing is absolutely freeware ( which means give to all
  69. and don't you dare try to make a buck other than the cost of 
  70. distribution).  I make no claims that this thing will not corrupt
  71. memory or trash your M1, but I've never had any problems with this
  72. or the original programs that couldn't be solved by shutting the
  73. M1 off and turning it on.  Remember though to make backup copies
  74. (MIDIEX or otherwise) of you original combinations.
  75.  
  76. I would appreciate feedback, if only to have some users to notify
  77. of new versions or new programs.  Hmmm, I might be the only one 
  78. in the universe to use this thing.
  79.  
  80.  
  81. CONTACT:
  82.  
  83. Larry Ludwick
  84. 45-20 43rd Street APT. 2D
  85. Sunnyside, NY   11104
  86.  
  87. Home BBS    Infinity Factory    212-274-8110
  88.  
  89. (also, look me up through the INTERNET, Compuserve, or GENIE)
  90.  
  91.  
  92.  
  93. RUNNING THE PROGRAM:
  94.  
  95. You run this program like any other DOS program.
  96.  
  97. In DOS, type the program name 'M1SYSGEN' followed by the Enter 
  98. key.
  99.  
  100. In Windows, double click on the file 'M1SYSGEN.EXE'.
  101.  
  102. The files M1SYSGEN.EXE and M1SYSGEN.H must be in the same 
  103. directory along with the MIDIEX file(s) for input.
  104.  
  105.  
  106.  
  107. PROGRAM OPTIONS:
  108.  
  109. The Main Screen presents a menu with four options which are
  110. described in the following sections.  Menu items in the program
  111. can be selected by moving to the item using the arrow keys and 
  112. then hitting Enter.  You can also type the item number and hit 
  113. Enter if the menu items are numbered.
  114.  
  115. The following are the four options presented by the Main Screen 
  116. and their functions:
  117.  
  118. LOAD SYSEX FILE  (System Exclusive File) -
  119.  
  120. Before the program will let you do anything but QUIT,  you must
  121. load a MIDIEX file into memory.  This is a M1 combo dump format
  122. file (you should note that the length for the file will always be
  123. 14,179 bytes).
  124.  
  125. When you select this option, you will be prompted for the file 
  126. name of the MIDIEX file.  A default name is presented, which you 
  127. must alter using arrow and back space keys to edit.  When you 
  128. edit the file name and hit enter, the program will attempt to 
  129. load the file. There is standard error trapping such as testing 
  130. that the file exists.  There is error trapping based on the 
  131. specific format of the M1 combo dump format.
  132.  
  133. A message will indicate that the file has been successfully loaded
  134. if no errors are indicated.  You may now select any of the Main
  135. Screen options.
  136.  
  137. Note: When the file is loaded it stays in its own protected area
  138. and can be used any number of times to generate and save more than
  139. one set of combinations.  The only time the loaded file will be
  140. lost is when another file is loaded using the LOAD SYSEX FILE
  141. option.  You can even reload using a file you just generated. 
  142.  
  143.  
  144. SELECT MODEL COMBOS -
  145.  
  146. This option can't be invoked if you haven't loaded a sysex file
  147. first.
  148.  
  149. This option provides the main function of the program.  The option
  150. invokes a screen which allows:
  151.  
  152.   1) Selection of a Model Combination used to generate new
  153.       combinations.
  154.  
  155.   2) Selection of a target starting combination in the output
  156.       buffer for combinations generated from the model.
  157.  
  158.   3) Selection of a target ending combination in the output buffer
  159.       for combinations generated from the model.
  160.  
  161.   4) Initiate the generation process.
  162.  
  163.   5) Return to the Main Screen.
  164.  
  165.  
  166. Defaults are set to use combination 00 (zero) as the model. The
  167. target range is set to generate 100 combinations (00 start to
  168. 99 end).
  169.  
  170.  
  171. The numbers and names of all the combinations from the loaded file
  172. are displayed to aid you in the choice of the model combination to
  173. use.  You can use this program merely to display/print combo names
  174. in the file (PRINT SCREEN KEY the display screen). 
  175.  
  176. A model is used because the combinations generated will always
  177. duplicate some parameters from the model, while randomly
  178. generating other parameters. The template I used to select which
  179. parameters will be altered will be available for modification in a
  180. later version of this program, but for now, the template is
  181. standard and unalterable.  The model name will be used for each
  182. generated combination to document its source.  The program
  183. does not provide a display of the output buffer combinations
  184. (another enhancement to consider).
  185.  
  186.  
  187. The use of this generation process is simple as is illustrated by
  188. the following example:
  189.  
  190. You want to create an output file based on 2 existing 
  191. combinations. For each model you want to create 50 random 
  192. combinations which will therefore fill the 100 output slots 
  193. (2 x 50 = 100).
  194.  
  195. Select 'ENTER MODEL' and enter the combination number
  196.         i.e 15)HELL SYNTH.
  197. Select 'ENTER START' and enter start output combination number 00.
  198. Select 'ENTER END' and end output combination number 49.
  199. Select 'DO IT' (this initiates the generation process).
  200. Without leaving the screen,
  201. Select 'ENTER MODEL' and enter the combination number
  202.         i.e 84)ELETRUMPET.
  203. Select 'ENTER START' and enter start output combination number 50.
  204. Select 'ENTER END' and end output combination number 99.
  205. Select 'DO IT' (this again initiates the generation process).
  206.  
  207. You have generated 50 various combinations with the name
  208. 'HELL SYNTH' followed by 50 combinations with the name ELETRUMPET.
  209.  
  210. Exit this screen to save the new file by selecting option 3 on the
  211. Main Screen.
  212.  
  213.  
  214. If you do not target some combination area of the output buffer,
  215. the  combination slots will contain the original combinations from
  216. the loaded file. Nothing will warn you that you have not used all 
  217. the available output slots. You might intentionally decide to mix
  218. old with new.
  219.  
  220.  
  221. SAVE GENNED SYSEX FILE -
  222.  
  223. This option can't be invoked if you haven't loaded a sysex file
  224. first.
  225.  
  226. The interface here is similar to the one used for LOAD SYSEX FILE.
  227. You enter the name under which you would like to save the
  228. generated MIDIEX file.
  229.  
  230. You can save the same file any number of times, but you are not
  231. allowed to use the name of an existing file.  I do this for myself
  232. because I tend to enter the name of the file I used as the input
  233. file ( I need this kind of protection ).
  234.  
  235.  
  236. QUIT -
  237.  
  238.  
  239. This allows you to QUIT the program.
  240.  
  241. If you have genned some combinations and not saved the resulting
  242. buffer, the program will warn you.  You have a choice of exiting
  243. without saving or remaining in the program.  Select YES or NO with
  244. the arrow keys.  The default will be NO - stay in the program
  245. (another chance to save your work).
  246.  
  247.  
  248.  
  249. Having created a slew of these files (perhaps 100 X 100 in a
  250. 10 minute session), you can sit down to an evening of downloading
  251. each set to the M1. Tweak, Tweak into the wee hours.  
  252.  
  253. Enjoy ...
  254.  
  255. I hope some users will reward the M1 community by uploading
  256. collections of combinations produced with this program.
  257.