home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / ST_USER / 1990 / USERSP90.MSA / TEXT_PERCUSSA.DOC < prev    next >
Encoding:
Text File  |  1990-07-25  |  8.9 KB  |  204 lines
  1.                      Percussaman 4-track 16-instrument
  2.                 Digitally Synthesised Drum Sequencer Version 1.2
  3.                          written by Robert Withey
  4.  
  5.  
  6. Percussaman provides many of the functions of a powerful drum sequencer and it
  7. uses sounds sampled at 16kHz to produce a very high quality output. It attempts
  8. to squeeze every ounce of power there is out of your ST. Also included is a
  9. routine that will play the songs you create in your own programs. It plays the
  10. first .BEA file it finds while displaying the first .NEO screen it can find. If
  11. the program fails to find a .NEO screen, it will display a screen of text.
  12.  
  13.  
  14. Overview of the editor
  15. -----------------------
  16. The editor is accessed by using the mouse to point and click on icons. No
  17. windows are employed, and most of the GEM functions used have been
  18. reprogrammed. The program is user frinedly and the only keyboard entry required
  19. is for filenames when using the file selector.
  20.  
  21.     The editor works in a similar fashion to a pattern-based MIDI sequencer. It
  22. enables you to edit up to 140 patterns, and then sequence them in any order to
  23. produce up to about 15 minutes worth of sampled sound beat. The editor consists
  24. of four menus, and one of these enables the three sub-menus to be accessed.
  25.  
  26.  
  27. The main menu
  28. --------------
  29. The main menu contains three help screens which can be accessed through the
  30. three buttons along the top of the screen. These contain only brief summaries
  31. of the program's facilities. Clicking on EDIT MENU, BEAT MENU, or SONG MENU
  32. will take you to that menu. Clicking on ABOUT PERCUSSAMAN gives you copyright
  33. details, how long the program took to develop, and where to send any program
  34. development ideas.
  35.  
  36.  
  37. The Edit Menu
  38. --------------
  39. The edit menu enables you to design and test the basic beat patterns to build
  40. songs from. The main editing functions are quite simple, even though the two
  41. editing windows seem complicated at first. Clicking on any instrument name
  42. plays that instrument at full volume and it's a good idea to try them all
  43. first, before making any patterns.
  44.  
  45.     Clicking on a box in either of the editing windows will place or remove a
  46. hit, up to a maximum of four hits per column. This is a limitation of the
  47. playing routine and is restricted by the number of registers the processor has.
  48. The BL column is the beat length which shows how long a sound will last.
  49.  
  50.     When a hit is placed by an instrument with a beat length of greater than
  51. one, then a bar will show up indicating exactly how long the sound is. The tail
  52. of this bar also counts as hits, so if you try to play a CRASH CYMBAL followed
  53. imediately by four other instruments, then the computer will not accept the hit
  54. that exceeds the four-instruments-at-a-time limit.
  55.  
  56.     Clicking on CLEAR MSB A or CLEAR MSB B will clear the relevant main screen
  57. beat ready for a new beat. PLAY MSB A and PLAY MSB B play the relevant beat to
  58. check how it sounds so far. You can store beats by going back to the main menu
  59. and selecting beat menu.
  60.  
  61.  
  62. The beat menu
  63. --------------
  64. The beat menu handles the storage and retrieval of beats. The number in the
  65. bottom right-hand corner is the current beat and is altered by clicking on any
  66. of the 140 beat slots on the left. The number is the beat slot that the
  67. functions GET BEAT, PUT BEAT, ERASE BEAT, HEAR BEAT, LOAD BEAT, or SAVE BEAT
  68. act upon.
  69.  
  70.     This is the heart of the system, it enables you to store, retrieve, save
  71. and load beats. MSB:A is a toggle button that swaps between MSB:A and MSB:B,
  72. and this is the main screen beat that the functions described below operate on,
  73. in conjunction with the currently selected beat.
  74.  
  75.     GET BEAT takes the currently selected beat and puts it in the main screen
  76. beat indicated by the MSB:A/B selector. A rimshot sound will confirm your
  77. selection. PUT BEAT on the other hand takes the indicated MSB and places it in
  78. the currently selected beat slot. Again a rimshot will confirm selection. If
  79. anything was previously in the slot it will be overwritten by the new beat.
  80.  
  81.     ERASE BEAT erases the current beat. LOAD BEAT and SAVE BEAT load and save
  82. the current beat from and to floppy disk. These selections will each bring up a
  83. file selector from which a pathname is selected or typed in. This produces a
  84. 32-byte file with suffix .BEA.
  85.  
  86.     LOAD ALL and SAVE ALL load and save the entire bank of 140 beats in a
  87. 4,480-byte file with suffix .BBA. The beats are stored together and one beat
  88. can be accessed only by loading the entire file.
  89.  
  90.     HEAR BEAT plays the currently selected beat, unless of course, it contains
  91. nothing. In the table on the left, each of the 140 beats has a status letter
  92. beside its number. This is E or F and describes whether that beat is empty or
  93. contains something. This means that if you desperately need to deposit a beat
  94. somewhere, you only need to look for the first E, as this indicates an empty
  95. slot.HEAR BEAT enables you to search for a beat that you may have lost.
  96.  
  97.  
  98. The Song Menu
  99. --------------
  100. The song menu enables you to sequence the beats (link them together), to
  101. produce a song. The beats may be used as many times as you wish, not at all,
  102. and in any order. There is a time limit of just over 15 minutes for the whole
  103. song. This is divided into 232 beat slots, with each beat taking four seconds
  104. to play. The beat slots can be imagined as a schedule telling the computer
  105. which beat to play, and when. It basically consists of a list list:
  106.  
  107. Play beat 3, then beat 4, then beat 130 ...
  108.  
  109.     Any of the 140 beats can be put on this schedule, and it will be played in
  110. time. Putting in a beat number which is empty provides a four second break. Use
  111. the current beat selector arrows to choose a beat to place in the song.
  112. Clicking with the left button adjusts the value by one and clicking with the
  113. right button adjusts the value by 10.
  114.  
  115.     HEAR BEAT plays the current beat just as before in the beat menu. ADD BEAT
  116. turns the mouse pointer into a query pointer which is used to place the current
  117. beat number in the schedule. Anything previously there will be overwritten. If
  118. you click with the right button the cursor will revert to a normal arrow and
  119. the add function will be aborted.
  120.  
  121.     REMOVE BEAT places a zero entry, ignoring the current beat number. This
  122. indicates the end of a song and will also erase an entry if you mess it up (and
  123. stop the song). If the table looks something like this:
  124.  
  125. +-----+-----+-----+-----+-----+-----+-----+-----+
  126. | 001 | 003 | 004 | 002 | 002 | 001 | 003 | 023 |
  127. +-----+-----+-----+-----+-----+-----+-----+-----+
  128. | 004 | 003 | 002 | 002 | 005 | 005 | 004 | 000 |
  129. +-----+-----+-----+-----+-----+-----+-----+-----+
  130. |     |     |     |     |     |     |     |     |
  131.  
  132.     Then PLAY SONG will play beats 1, 3, 4, 2, 2, 1, 3, 23, 4, 3, 2, 2, 5, 5, 4
  133. and then stop.
  134.  
  135.     LOAD SONG+BEATS and SAVE SONG+BEATS will load or save the song and
  136. associated beats from or to floppy disk. The beats are saved as well because of
  137. the way that a certain set of beats will only make a good song with the song
  138. data that was developed with them. The file size is 4,712, with a .SON suffix.
  139.  
  140.  
  141. Further Details
  142. ----------------
  143. The current beat selected in the song or beat menu carries through. That is, if
  144. you select beat 004 on the beat menu and then go to the song menu, the current
  145. beat will be 004.
  146.  
  147.     Occasionally, the computer will start bleeping I don't know what causes
  148. this, but it can be stopped by pressing a key.
  149.  
  150.  
  151.                         *         *         *
  152.  
  153.  
  154. File Formats
  155. -------------
  156. Three file types are output from the main program: individual beats (.BEA),
  157. entire beat banks (.BBA), and songs along with the associated beats (.SON).
  158.  
  159.  
  160. Individual Beats (.BBA):
  161. ------------------------
  162. Size of file: 32 bytes
  163. Format: 16 words utilising one bit for each instrument per word. Each word is
  164. for one column of the MSB table, and a set bit shows a hit, whereas a reset bit
  165. means a non-hit. Loading a file with more than 4-bits set per column doesn't
  166. causes any side effects.
  167.  
  168.  
  169. Entire Beat Banks (.BBA):
  170. -------------------------
  171. Size of file: 4480 bytes
  172. Format: 140 successive beats using the same format as above. The first entry is
  173. beat 001, the second entry is 002, the third 003, and so on.
  174.  
  175.  
  176. Songs (.SON):
  177. -------------
  178. Size of file: 4,712 bytes
  179. Format: The first 4,480 bytes is the same format as above for the .BBA files
  180. and the remaining 232 bytes contain byte sized entries for the song table. A
  181. zero value marks the end of a song and a non-zero value means that that beat
  182. will be played in sequence. A value greater the 140 will produce unpredictable
  183. results.
  184.  
  185.  
  186.                         *         *         *
  187.  
  188.  
  189. Enhancements
  190. -------------
  191. If you have any ideas to enhance Percussaman then send details to the address
  192. below. I would be very grateful for any suggestions.
  193.  
  194. Robert Withey
  195. 1a Crowthorne Farm
  196. Pinewood Avenue
  197. Crowthorne
  198. Berkshire
  199. RG11 6RS
  200.  
  201.  
  202.  
  203.  
  204.