home *** CD-ROM | disk | FTP | other *** search
/ Esprit de Apple Corps / EDAC-1.iso / MOD.Utilities / Info / Patch / PATCH.Docs < prev   
Text File  |  1995-10-06  |  7KB  |  142 lines
  1. PATtern CHanger
  2.  
  3. Version 1.0 / User Documentation
  4.  
  5. Written by Tony Morales, 2/24/94
  6.  
  7. Copyright (c) 1994 by Tony Morales, All Rights Reserved.
  8.  
  9.                              INTRODUCTION
  10.                                     
  11.     I originally never intended to release this utility.  It was meant
  12. as a proprietary piece of software for some MOD research.  However,
  13. after the overwhelming response from those who tested this program, I
  14. have decided to put it out as shareware, for everyone to enjoy.
  15.      
  16.     PATtern CHanger, (PATCH), is a utility which allows you to perform
  17. various actions on Amiga MOD pattern data structures.  Pattern data
  18. structures are simply collections of notes, (sometimes called blocks),
  19. that when combined together, produce a musical sequence.
  20.      
  21.                            SHAREWARE NOTICE
  22.                                     
  23.     You may distribute PATCH to as many people as you wish, as long as
  24. all files and documentation are retained.  If you use and enjoy PATCH,
  25. you should send $5.00 to the addresses at the end of this file.  If, for
  26. some reason, you are unable to send in your shareware fee, send me a
  27. letter telling me what you think of the program.  If you don't find any
  28. use for PATCH, please give it to a friend, who can make use of it.
  29.      
  30.                    INSTALLATION/SYSTEM REQUIREMENTS
  31.                                     
  32.     PATCH is very easy to install.  Just launch the file, "PATCH," from
  33. any application that is capable of running Applesoft BASIC programs.
  34. Make sure the file, "PATCH.BIN," is in the same folder as, "PATCH."
  35. PATCH requires an Apple IIgs to run, and will work fine under any memory
  36. configuration.
  37.      
  38.                              WHAT IT DOES
  39.                                     
  40.     PATCH will take any Amiga MOD music file, and allow you to adjust
  41. all of the notes in the sequence.  Currently, PATCH only allows you to
  42. incrment or decrment each note.  At first, this may sound like nothing
  43. special at all.  However, by giving PATCH the right parameters, you can
  44. often produce pleasantly-sounding alternatives to your favorite MODs.
  45.      
  46.                             CLARIFICATIONS
  47.                                     
  48.     If you don't have a good understanding of music, the next few
  49. paragraphs should clarify some key points, which you should know before
  50. attempting to use PATCH to alter a MOD.
  51.      
  52.     There are 12 basic notes in each musical octave, (C, C#, D, D#, E,
  53. F, F#, G, G#, A, A#, B).  If you hear someone speak of playing a song in
  54. the key of G, this means they are playing the song with note offsets
  55. relative to the note G.  For example, (G, B, D).  It is possible to play
  56. a piece of music in a different key, say key C.  This is the equivalent
  57. of the above example, played in the key of C, (C, E, G).
  58.      
  59.     If you are still totally confused, think of how many possible notes
  60. there are between each corisponding note in the examples.  There are 3
  61. notes between G and B, (first example), and there are 3 notes between C
  62. and E, (second example).  There are 2 notes between B and D, [go up an
  63. octave], (first example), and there are 2 notes between E and G, (second
  64. example).
  65.      
  66.     To play a song in a different key, you simply slide each note up or
  67. down x many notes, where x is the number of notes, (up or down the
  68. scale), it takes to reach the new key.  If you are still confused,
  69. consult someone who is fluent in music for details.  So, PATCH will take
  70. each note in a MOD and slide it up or down as many notes as you desire.
  71.      
  72.                            A QUICK TUTORIAL
  73.                                     
  74.     The following sections explain PATCH's powerful set of features.
  75. Before beginning, we'll assume you have some MOD files to practice with.
  76. If you don't have any MODs, you can get some from any Apple IIgs user
  77. who loves music.  Important!  You should always make a backup copy of
  78. your MODs before altering them with PATCH.  This way, if you make some
  79. alterations that don't sound good, you won't harm the original MOD.
  80.      
  81.     When you run PATCH, you will see a short title screen displaying
  82. copyright information.  You are then prompted to type in the pathname of
  83. the MOD you would like to work with.  If the MOD resides in a different
  84. directory than the one you ran PATCH from, you will need to type in the
  85. complete pathname, (/RAM5/MOD.BLAH for example).
  86.      
  87.     PATCH will then display the MOD's title, type, and number of
  88. patterns.  As was previously mentioned, patterns are like blocks of
  89. notes.  PATCH also shows you the number of the first and last pattern in
  90. the MOD.
  91.      
  92.     You are then prompted for the starting/ending patterns to work on.
  93. If you enter the same values as displayed, PATCH will convert the entire
  94. MOD.  You cannot enter an ending pattern less than the starting pattern
  95. and vice versa, and you cannot enter a negative pattern.
  96.      
  97.     Most MODs have 4 basic tracks, (or channels), to play notes on.
  98. PATCH prompts you whether or not it should operate on a particular
  99. track.  Type in Y for yes or N for no, at each of the track prompts, (1
  100. through 4).  Then, PATCH asks you if it should incrment or decrment the
  101. specified notes.  Type I or D, at this prompt.
  102.      
  103.     Finally, you are asked the offset to adjust the notes.  Here is
  104. when things can get tricky.  There is no way of knowing, other than by
  105. listening, which key a particular MOD was designed in.  The best advice
  106. here is to explore different values.  A value of 1 or 2 will usually
  107. raise, or lower, the MOD by 1 whole note.
  108.      
  109.     When you have entered this value, the conversion process will
  110. begin.  PATCH will inform you of each pattern it is currently
  111. converting.  Most MODs only support 3 octaves, so it is more than likely
  112. that a note, when adjusted, will fall outside the allowable octave
  113. range.  If this happens, PATCH will not touch the note, leaving it the
  114. way it was before.  This will result in a pattern that is partially
  115. converted.
  116.      
  117.     If this happens, PATCH will alert you to this, and give you the
  118. option of whether or not to save the pattern.  If you say no, that
  119. pattern will remain unconverted.  All good patterns are automatically
  120. written to disk.  This is why it is a good idea to backup the MOD before
  121. you alter it, because the chances are very high that your first session
  122. with PATCH will not produce a masterpiece.  Don't let this discourage
  123. you.  It is possible to do some nice things with MODs using PATCH, but
  124. it takes practice.
  125.      
  126.                             THE LEGAL STUFF
  127.                                     
  128.     PATCH is copyright 1994 by Tony Morales.  To legally use PATCH, you
  129. should send $5.00 to the addresses listed below.  After you send in your
  130. shareware fee, you will be entitled to use all upgrades without any
  131. additional costs.  Use PATCH at your own discretion.  The author will
  132. not be held responsible for any loss of data as a result from the
  133. operation of PATCH.
  134.      
  135.     PATCH has been thoroughly tested with a variety of MOD files, and
  136. should present no problems.  However, if you would like to report any
  137. bugs you find, or if you would like to offer suggestions, you can write
  138. to me at the following addresses:
  139.      
  140. Tony Morales               GEnie:
  141. 2260 Rock St, Apt K        HEXMAN
  142. Mountain View, CA  94043