home *** CD-ROM | disk | FTP | other *** search
/ Audio 4.94 - Over 11,000 Files / audio-11000.iso / amiga / utils / gmdmmacr.lha / dmcs_gmMacro.readme next >
Text File  |  1993-11-20  |  6KB  |  133 lines
  1.                       DMCS_GMMacros
  2.  
  3. I.  INTRODUCTION
  4.                      
  5. This readme file contains three AREXX macros that assist users of
  6. DMCS who have General Midi protocol instruments.  The three macros
  7. are:
  8.  
  9. NumPatch.dmcs takes a number as input and returns the name of the
  10. associated instrument patch.
  11.  
  12. PatchNum.dmcs allows you to get the patch number given the name
  13. of the instrument.  You may search for the desired instrument in a 
  14. variety of ways.
  15.  
  16. DrumNum.dmcs allows you to insert a note that corresponds to a 
  17. specified drum sound.  You may search for the drum name in a variety 
  18. of ways.
  19.  
  20. These macros should be helpful in several situations.  They are invaluable
  21. for entering  scores that are to be played on your GM instrument.  You 
  22. no longer need to constantly refer to your manual to pick out patch
  23. numbers and drum note numbers.  It is also helpful when you read in a GM
  24. Standard Midi File.  You can quickly find out which instruments are used
  25. in the song.
  26.  
  27. In order to use these macros copy them to your REXX: directory.  From DMCS
  28. use the Macro Execute Command or assign it to a function key.  If you are 
  29. confused, please refer to the DMCS manual.
  30.  
  31. Before I describe the macros in detail I have to get the legal stuff out
  32. of the way.  These programs are freeware and may be freely redistributed.
  33. I would appreciate it if my name stays with the file. Who knows, this
  34. may be my fifteen minutes of fame.  Commercial redistribution is 
  35. welcome, but I would appreciate knowing about it.  (Actually, if
  36. anyone from EA is listening, it would be a good idea to gather these
  37. little tidbits that people are generating and include them with the next
  38. release.)
  39.  
  40. Here is an individual description of each macro.
  41.  
  42. II  NUMPATCH.DMCS
  43.  
  44. This is the easiest macro to use and understand.  Use it when you are in a 
  45. situation where you need to find the GM instrument patch name when you 
  46. know the number.
  47.  
  48. Execute the macro.  You will be prompted for the number.  Enter the number
  49. and hit 'Return' or the Done button.  In a few moments a requester will
  50. show up that will tell you the name of the instrument.  Click the Button to
  51. continue.  Note that in DMCS you can execute these macros at any time, even
  52. while the Set Instrument Requester is showing.  This is when you will
  53. usually need it.
  54.  
  55. III  PATCHNUM.DMCS
  56.  
  57. This macro is the opposite of NumPatch.  Use it when you know the name
  58. of the instrument you want but don't have the patch number.  When it
  59. first comes up it asks for the name of the instrument.  If you know it,
  60. enter it and the patch number will be displayed.  If you click 'Help' you
  61. will be presented with three choices: Search, List or Group.
  62.  
  63. 'Search' allows you to enter a string that will be matched.  If you enter a
  64. single letter it will assume that you want all instruments that start with
  65. that letter.  If you enter a string, all instances of that string will be
  66. matched.  In other words, if you enter 'harp' it will find 'harp' and
  67. 'harpsichord.' Use of spaces and quotes in the search string are 
  68. undefined.
  69.  
  70. If you select 'List', you will be presented with a list of all the names
  71. in order.  Click on the numbered box that corresponds with the name and
  72. the corresponding patch will be displayed.  Click 'Next' to get the next
  73. list.  If you reach the end without making a selection the macro exits.
  74.  
  75. 'Group' allows you to select one of the sixteen groups or categories of
  76. instruments that are defined in the General Midi Specification.  You
  77. are first allowed to select from the list of groups which then leads
  78. you to a list of instruments within that group.  This function is much
  79. quicker than searching the list of all 128 names!
  80.  
  81.  
  82. If the program finds the name you want, a requester will appear with 
  83. the patch number.
  84.  
  85. IV  DRUMNUM.DMCS
  86.  
  87. This macro inserts the drum note from the name of the drum.  Use it
  88. to build up rhythm patterns.  The list and search functions are similar
  89. to patchnum.dmcs, but there is no group search.
  90.  
  91. The main difference is that when the name is found, it inserts the note of
  92. the correct pitch at the insertion point.  I suggest inserting into a bass
  93. clef.  By entering, say, sixteenth notes, you can insert a pattern of drums
  94. and then go back and insert rests in between.  You have to set the midi
  95. channel of the staff to 10 and enable midi to hear your rhythm track.
  96.  
  97. V  MODIFYING THE MACROS
  98.  
  99. At some time you might want to make changes to the instrument lists.
  100.  
  101. I have named the instruments and drums based on my Boss Dr. Synth 
  102. and an internet document on General Midi that I received.  I would
  103. not be surprised if you wanted to change the names to suit your taste.
  104. This is very easy and the programs can be modified to add instruments
  105. or even be used for non-GM instruments with a little effort.  Use a text
  106. editor that does not embed "control characters" in the file.  If you use
  107. your word processor make sure that it is in text only mode.  At the
  108. beginning of each macro you will find a bunch of statements like:
  109.  
  110. name.1 = "THIS IS A NAME" ; name.2    = "THIS IS ANOTHER"
  111.  
  112. name is the stem variable and the .1 is the index and represents
  113. the number of the patch as listed in the manual for your instrument.
  114. The letters in quotes are the names that are assigned to the instrument
  115. or whatever makes sense to you.  In order to make changes simply add new
  116. numbers or change the text inside the quotes.  In patchnum.dmcs and 
  117. numpatch.dmcs the indexes 1 and 128 are hard-coded in the searches so
  118. if you add new names you will need to look for those numbers in the DO
  119. LOOPs and change them.  Since all 128 patches are used for General Midi,
  120. you probably won't need to change them anyway.
  121.  
  122. Drumnum.dmcs is a little different.  You almost certainly will have extra
  123. or different sounds that will need to be changed.  Simply add, modify or
  124. delete my sounds.  When you are done change the highnote and lownote
  125. variables to represent the new limits and away you go.
  126.  
  127. I hope that these macros are useful.  It is my first attempt at AREXX, so
  128. they might not be the most elegant.  But I did manage to find a use for
  129. the CLIPLIST!
  130.  
  131. If you would like to reach me my GENIE address is K.BARKLEY.
  132. My Internet address is keith@technet.macom.com.
  133.