home *** CD-ROM | disk | FTP | other *** search
/ Sound Sensations! / sound_sensations.iso / midifile / drmfix / drumfix.doc next >
Text File  |  1991-09-27  |  3KB  |  83 lines
  1. DrumFix v1.0 Copyright 1991 Thomas J. LeCompte
  2. All Rights Reserved.
  3.     
  4. Usage: DRUMFIX infile outfile [-m#] [-uFile] [-d#]
  5.     -m# is the internal map number
  6.         -m1 : Proteus to General MIDI
  7.         -m2 : General MIDI to Proteus
  8.         -m3 : Proteus to Yamaha
  9.         -m4 : Yamaha to Proteus
  10.         -m5 : Yamaha to General MIDI
  11.         -m6 : General MIDI to Yamaha
  12.         (Korg M-1,Alesis HR-16 use Proteus Map)
  13.  
  14.     -uMapfile reads a user-written map file.
  15.  
  16.     -d# is the channel of the drum track. (1-16,default=10)
  17.  
  18.  
  19. DrumFix is a program that attempts to solve the problem of every drum
  20. machine having a different mapping of sounds to MIDI events.  DrumFix 
  21. reads in a standard MIDI file, re-maps the drum sounds to a different
  22. machine, and writes out a second MIDI file.  It currently understands
  23. three machines: General MIDI, the Emu Proteus/1, and the Yamaha SY-22.
  24. (The Alesis HR-16 and the Korg M-1 supposedly use the same map as the
  25. Proteus, likewise, other Yamaha equipment probably uses the same map.)
  26. However, DrumFix is also extensible: it can read in a custom drum map
  27. as well, so you can convert from any drum machine to any other.  Two
  28. sample custom files are included: SAMPLE.MAP which transposes Proteus
  29. drum parts into a "sane" range of MIDI note numbers (i.e. near middle
  30. C) and GM-PRO.MAP is an external version of the internal General MIDI
  31. to Proteus conversion.
  32.  
  33. A custom map file looks like this:
  34.  
  35. ; Example.MAP : an example of a custom drum map for DrumFix
  36. ;
  37. ; Any line starting with a semicolon is a comment.
  38. ;
  39. ; DrumFix will generate a map, so that OldNote -> NewNote
  40. ;
  41. ;Old Note    New Note
  42. 20    68
  43. 21    69
  44. 39    87
  45. 40    88  ...etc...
  46.  
  47. Notes are MIDI note numbers in decimal; middle C = 60.
  48.  
  49. This code is preliminary, beta-test, and although I have done my best
  50. to exterminate the bugs, there still may be some laying around.
  51.  
  52. Known Shortcomings:
  53. 1. The input file and output file cannot be the same.
  54. 2. Output file name extensions (e.g. .MFF) must be specified.
  55.  
  56. Possible shortcomings:
  57. 1. Embedded SYSEX data has not been tested.
  58. 2. Probably cannot handle Format 2 MIDI files.
  59.  
  60.     I am particularly interested in how well the internal maps work.
  61. If you hear anything funny, please let me know - i.e. if what should be a
  62. bass drum is a kazoo, I want to know about it.  Also, I would like to have
  63. any useful custom maps that you might make; I can incorporate them as
  64. internal maps.  (By the way, there is no reason that the custom maps
  65. are required to be drum maps: you can use them to transpose, or to change
  66. a drum machine part into standard percussion notation, etc.)  Finally, any
  67. bugs or areas for improvement, please, PLEASE let me know, preferably
  68. via the CompuServe MIDI Forum, section 7.
  69.  
  70. Legal Stuff:  This software is mine.  I wrote it.  Although I normally
  71. would love to have it spread around, this program is not in it's final 
  72. form.  So, (please) do not share this version with anyone; wait until
  73. the bugs are all removed.  As soon as this happens, I will remove this
  74. version and replace it with the updated version.
  75.  
  76. Enjoy!
  77.  
  78. Special thanks to Kevin Weiner; his MIDITools made debugging DRUMFix a
  79. breeze.
  80.  
  81. Tom LeCompte                        CIS: 73667,1120
  82. 708/357-6246                    COM%"lecompte@fnal.com"
  83.