home *** CD-ROM | disk | FTP | other *** search
/ Da Capo / da_capo_vol1.bin / programs / amiga / midi / mod2midi / mod2midi.doc < prev    next >
Text File  |  1994-06-12  |  15KB  |  377 lines
  1. Mod2Midi V1.0 Amiga conversion © 1994 by Paul Huxham
  2.  
  3. MIDIMOD - Amiga Noise/Sound/Protracker to MIDI file converter (ver 0.2)
  4. © Andrew Scott 1993
  5.  
  6.  
  7. Conversion Authors Notes
  8. ========================
  9. Mod2Midi is based on MIDIMOD by Andrew Scott.
  10.  
  11. These instructions are based on the original program documentation by
  12. Andrew Scott.
  13.  
  14. The license for the use of this software is contained in the archive
  15. midimod2.zip.
  16.  
  17. The file midimod2.zip is the original PC archive of the source code.
  18.  
  19. If you modify the Amiga conversion - Mod2Midi, please follow the
  20. instructions in Andrew Scotts' license about naming conventions and source
  21. code distribution so that others don't have a hard time working which out
  22. version is what.
  23.  
  24. The included Amiga source code compiles under SAS/C 6.51.
  25.  
  26.  
  27. Mod2Midi - What it does
  28. ======================
  29. Mod2Midi is a program which converts music modules generated by Amiga
  30. tracker programs (MOD files) to general MIDI format 1 (MID files).  Some
  31. editing of the output MID file might be necessary, but next time there
  32. will be less editing to do as Mod2Midi can remember previous settings.
  33.  
  34.  
  35. Why convert MOD files to MID files?
  36. ===================================
  37. Even though MOD files contain some music-instructions that cannot be
  38. represented in MID format, there are many reasons why it is desirable to
  39. have music in MID form rather than MOD form:
  40.  
  41. * Top-of-the-range music editing programs do not handle MOD files, but
  42.   almost always handle MID files, or at least allow you to convert from MID
  43.   files.
  44.  
  45. * There exist programs to print out MID files as musical score.  I don't
  46.   know of any which do the same for MOD files
  47.  
  48. * MID files tend to be much smaller than MOD files
  49.  
  50. * MID files are more portable, having a well-known format, and have
  51.   utilities on many different computers.  MID files _ARE_ the industry
  52.   standard.
  53.  
  54. * MID files can be played on professional keyboards, allowing expert
  55.   recording/presentation of music
  56.  
  57.  
  58. How to use Mod2Midi
  59. ===================
  60. Mod2Midi is a CLI/Shell based program, designed to be run from a shell
  61. operating on the WorkBench screen. All parameters are supplied on the
  62. command line when launching Mod2Midi.
  63.  
  64.  
  65. Explanation of Parameters
  66. =========================
  67. The command template for Mod2Midi is:
  68.  
  69. MOD,MIDI,ABOUT/S,MAPSAMPLES/S,SAVEINFO/S,
  70. TRANSPOSE/S,DRUM/N,TEMPO/N,VOLUMESHIFT/S
  71.  
  72. ABOUT
  73. -----
  74.   Displays the copyright information.
  75.  
  76. MOD
  77. ---
  78.   The name of the source MOD file.
  79.  
  80. MIDI
  81. ----
  82.   The name of the target MIDI format 1 file.  Files that exist will be
  83. overwritten - BEWARE.
  84.  
  85. MAPSAMPLES
  86. ----------
  87. There are many, many MOD samples on computers around the world, so it is
  88. impossible to automatically know which instrument is equivalent to which
  89. sample.  You must tell Mod2Midi which instrument to use.  Use the mouse to
  90. select a sample from the list that appears on the screen.
  91.  
  92. Each sample may have an asterisk "*" before it - this means that there is
  93. actual sample data that corresponds to this sample - ignore any other
  94. samples...they won't be converted (except in name only).  Each sample will
  95. have an instrument code to its right.  If the code is prefixed by a "D"
  96. then it is a percussion code.
  97.  
  98. After selecting a sample, a list of all of the available instruments will
  99. appear on the screen.  Select one and the appropriate code will appear to
  100. the right of the chosen sample.  Samples that already have an instrument
  101. code should be left alone as they already have been matched with a sample's
  102. name.
  103.  
  104. SAVEINFO
  105. --------
  106. Because it is nicer to have the computer select instruments, transpositions
  107. and volume shifts for you than having to look them up each time, Mod2Midi
  108. keeps a list of "known" mappings/transposes/volume-shifts from MOD-samples
  109. to MIDI instruments.
  110.  
  111. Once you have selected a mapping using the MAPSAMPLES, a transposition
  112. using TRANSPOSE, or a volume shift using VOLUMESHIFT you can use this
  113. command to save a sample's info to the info file.
  114.  
  115. TRANSPOSE
  116. ---------
  117. Even if you have matched a MOD sample with a MIDI instrument there is no
  118. guarantee that each will play at the same pitch.  MOD samples tend to sound
  119. high, low, very low, or slightly off pitch when both MOD and MIDI
  120. instruments play the same note.  The trick is to map MOD samples to a
  121. different note during the conversion, so that there won't be any horrible
  122. musical clashes.
  123.  
  124. A good way to do this is to find a sample that maps exactly to a MIDI
  125. instrument, and then get a MOD-editor and play other samples, and compare
  126. those samples to the "true" sample.  This way you can find the number of
  127. semitones difference there are between a MOD sample and its instrument
  128. equivalent.
  129.  
  130. For example, bass guitar samples are usually an octave lower (sometimes
  131. two) than their actual note.  As an octave is 12 semitones, if the guitar
  132. sample is transposed down 12 semitones, it sounds ok.  Another example,
  133. chords are usually made up of 3 notes which are played simulateously (major
  134. chords have part of them transposed up 4 semitones, and another part 7
  135. semitones where minor chords have 3 and 7 semitone transposed parts).
  136.  
  137. After selecting a MOD-sample from the menu (the numbers on the right are
  138. the transpose values), you can enter in its transposition.  For a bass
  139. sample you might enter:
  140.       -12
  141.  
  142. then press <RETURN>, whereas for a major chord you might enter
  143.       0, 4, 7
  144.  
  145. then press <RETURN>, and for a bass major chord you might enter
  146.       -12, -8, -5
  147.  
  148. then press <RETURN> (note than -12+4=-8 etc.).
  149.  
  150. During conversion, these transpositions are applied and hopefully the
  151. MID-file won't sound as if many musicians are playing using different
  152. scales.
  153.  
  154. A couple of things you need to watch out for:  if one of the transposition
  155. values is 0 then it must be the first value, also don't transpose
  156. percussion instruments - it's not a good idea.
  157.  
  158. DRUM
  159. ----
  160. As different software/hardware is by definition different, you can use this
  161. option to set the drum channel.  The default drum channel is 10.
  162.  
  163. TEMPO
  164. -----
  165. Some MOD-files use an old tempo convention and don't convert at all well if
  166. the wrong convention is used.  The default TEMPO value is 0 for NORMAL.
  167.  
  168. If the MID file produced sounds like the timing is out of whack, try
  169. setting TEMPO to 1 for EXTENDED and do the conversion again.
  170.  
  171. VOLUMESHIFT
  172. -----------
  173. This is similar to transposing, but it affects volume rather than pitch.
  174. Mod2Midi alters volumes by applying a formula to each volume in the MOD
  175. file.
  176.  
  177. The formula is simple:  it takes the volume, then adds a number, then
  178. multiplies by a number, then divides by a number.  So all you have to do is
  179. supply 3 numbers, though when you come to change a volume formula you will
  180. notice that Mod2Midi has already given each sample a formula.
  181.  
  182. Mod2Midi analyses each sample of the MOD file when you it reads in the MOD
  183. file and based on this analysis allocates a formula to the samples.  Note
  184. that these formulae are not necessarily correct, they are just Mod2Midi's
  185. best guess, but most of the time they will suffice.  To set the formula
  186. yourself, choose a sample then enter the three numbers for the formula
  187. respectively (as you do for transposition amounts), eg.  if you want to
  188. "add 1, multiply by 2, then divide by 3" every volume for a particular
  189. sample, you would enter:
  190.       1, 2, 3
  191.  
  192. then press <RETURN>.  The last two numbers cannot be negative, and the last
  193. number cannot be 0.
  194.  
  195.  
  196. Converting MODs
  197. ===============
  198. Use the MAPSAMPLES option to set samples to appropriate instruments.  If
  199. you get an error message which says that you have too many different
  200. instruments, then use the MAPSAMPLES option to reduce the number.
  201.  
  202.  
  203. The Instruments
  204. ===============
  205. A list of MIDI instruments is kept in the file "Mod2Midi.ins".  Each
  206. instrument on a separate line.  The first 128 lines must hold the
  207. instruments 0 to 127.  The lines after this hold the percussion instruments
  208. (no more than 128).  All instruments should have a code as the first thing
  209. on the line.  The code must consist of the letter "D" (if it is a
  210. percussion instrument) followed by a number from 0 to 127.
  211.  
  212. This file can be edited with a text editor to put in the instruments for
  213. your particular computer/keyboard/software etc.  The supplied instrument
  214. file contains