home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / d / drummer / Documents / Docs < prev   
Encoding:
Text File  |  1995-04-10  |  12.3 KB  |  305 lines

  1.                         -----------
  2.                         The Drummer
  3.                            ©1995
  4.                         Mike Goatly
  5.                         
  6.                           Release
  7.                             1.0
  8.                         (8th April)
  9.                         -----------
  10.                     
  11. ---->Contents:
  12.  
  13.     1:Introduction
  14.     2:Editing patterns
  15.     3:Editing a sequence
  16.     4:Sequence commands
  17.     5:Copyright and other important stuff
  18.  
  19. ---->1:Introduction.
  20.  
  21.     'The Drummer' is a Drum Sequencer.  It isn't a drum
  22. machine, (although something of that nature may be added at
  23. a later stage), but it can be used to produce similar results.
  24.  
  25.     Anyone who has used a music sequencer, such as Coconizer,
  26. SoundTracker or ProTracker (There are many more....), will
  27. get to grips with 'The Drummer' quickly.
  28.  
  29.     This is the first released version of 'The Drummer', so
  30. there may (will) be bugs in it.  There also features that 
  31. would be nice to add (such as a search and replace function
  32. for the pattern editors, so you can change one sample number
  33. throughout that pattern type without having to do it manually)
  34. But I need to know if there is going to be anyone using it
  35. before I spend more time on it.  
  36.     So let me know if there are any improvements you would
  37. like to see (don't ask for an interrupt driven version - 
  38. without the PRM or basic manuals, I haven't a clue how to
  39. do it), and I might be able to help you.
  40.  
  41.     For details of how to contact me, see part 6.
  42.     
  43.     Speed note: 'The Drummer' was written on a Risc PC, with a
  44. 256 colour display and I don't really know how much slower it 
  45. will run using an ARM3 processor.  If it really is a problem 
  46. (I suspect the command check every line of the sequence might 
  47. be) I'll try to do something about it.  Let me know.
  48.     
  49.  
  50. ---->2:Editing patterns
  51.  
  52.     Patterns are the building blocks of sequences, and there
  53. are five windows concerned with the editing of them, the
  54. Bassdrum Pattern Editor, the Snaredrum Pattern Editor, the
  55. Hi-Hat Pattern Editor, the Miscellaneous pattern editor and
  56. the Pat. Controller (Pattern Controller).
  57.  
  58.   -The Bassdrum, Snaredrum, Hi-Hat and Misc. pattern editors:-
  59.   
  60.     These four windows are all operated in exactly the same 
  61. way, the only difference between each of them being that they
  62. have their own set of samples.
  63.  
  64.     The icons from left to right are: 
  65.     
  66.         The radio icon: This signifies whether that pattern
  67.             type can be heard when the patterns are played.
  68.             (On=can be heard, Off=cannot be heard)
  69.             
  70.         The white boxes: Each window contains 2 lines of 
  71.             these.  Clicking inside one of them with the 
  72.             left mouse button will set or unset the current
  73.             sample, at full volume (a circle containing the
  74.             sample's number will appear in the box that you
  75.             clicked over).  
  76.  
  77.             Clicking the right mouse button over a sample 
  78.             that has been set decreases the volume it will 
  79.             be played at.  When it reaches volume 1, (you 
  80.             can see when this is, by checking the 'pat. 
  81.             control' window - see later in this section)
  82.             the volume will wrap to 8 (maximum).
  83.  
  84.         The current pattern number box:  This box contains
  85.             the current pattern number for that window.  you
  86.             can change the pattern number by clicking in the
  87.             box and typing in a new one, followed by return,
  88.             or you can use the arrow buttons to flick through
  89.             the patterns one by one.
  90.             
  91.         The current sample box.  This box displays the current
  92.             sample for that window.  Clicking on the sample
  93.             name will test the sample, whilst clicking on the
  94.             menu box next to it will bring up the samples
  95.             available for that window.  Selecting one of these
  96.             changes the current sample to the one selected.
  97.  
  98.   -The Pat. Control window-
  99.   
  100.     This window mainly controls the playing of the current
  101. patterns.  Click on 'Play patterns' to start playing the
  102. current patterns.  Once the patterns are playing, you can
  103. perform all the usual editing funtions, such as altering them,
  104. changing the current patterns, etc.  Click on 'Stop playing'
  105. to stop the patterns playing.
  106.     When the mouse pointer is moved over a note, information
  107. for that sample is put into this window.  From top to bottom:
  108. The sample name, where the sample came from (Bassdrum, Snare,
  109. Hi-Hat or Misc), what the actual sample number is (not much
  110. use really) and the volume of the sample (from 1-8, 8 being
  111. loudest).
  112.  
  113.   -Pattern menus-
  114.   
  115.     There are some basic editing features available for the
  116. patterns, and these are accessable through the menu system.
  117. Opening a menu over one of the pattern windows lets you:
  118.  
  119.         Copy:  Puts a copy of the current pattern in that 
  120.                window into the pattern copy buffer.
  121.         Paste: Pastes the contents of the pattern copy buffer
  122.                onto the pattern of the current window,
  123.                overwriting the old one.  Patterns can be cut
  124.                and pasted between windows.
  125.         Cut:   Puts the current pattern into the pattern copy
  126.                buffer, and moves the patterns above it down,
  127.                to fill the gap.
  128.         Clear: Clears the current pattern.
  129.         Insert:Inserts a blank pattern before the current one
  130.                of that window.
  131.  
  132.  
  133. ---->3:Editing a sequence
  134.  
  135.  
  136.     There are two main windows associated with this, the 
  137. Sequence Editor, and Seq. Controller (Sequence controller).
  138.  
  139.     A sequence is a collection of lines of patterns.  These 
  140. lines are not necessacerily played sequentially, because 
  141. special command words can be used to control how the sequence
  142. is to be played. (See next section)
  143.  
  144.     The sequence can have up to 50 lines only.  You can scroll
  145. through the lines by clicking on the up and down arrows to the
  146. left of the sequence line numbers on the Sequence Editor 
  147. window. Each line consists of 4 patterns, a tempo and a 
  148. command line.
  149.  
  150.     To edit a line of the sequence click in the first box of 
  151. the desired line, and enter the desired pattern number of that
  152. type to be played on that line.  You can skip between boxes by
  153. pressing the tab button, or by using the up/down cursor keys.
  154. You can edit the tempo and command boxes of the line in the
  155. same manner.
  156.  
  157.     For more information of the command box, see the next
  158. section.
  159.  
  160.     The radio icons below each pattern type signify whether
  161. that pattern type is to be heard when the sequence is being
  162. played.
  163.  
  164.     You can control the playing of the sequence using the 
  165. 'Seq. Control' window.  'Play' resets the counter (see next
  166. part), and starts the sequence from line 1.  Stop halts the
  167. playing of the sequence, Fast forward/Rewind moves the 
  168. sequence forward or back a line, respectively.  (These only
  169. work if the sequence is playing).  Continue plays the sequence
  170. from the line that is currently at the top of the window.
  171.  
  172.     If the menu is opened anywhere on the Sequencer window, a
  173. menu opens, containing the following:
  174.  
  175.             Song info > Info about the currently loaded song.
  176.                         This is editable, so you can put your
  177.                         name to a sequence.
  178.  
  179.             Tempo     > Brings up a window where you can edit
  180.                         the default tempo.  From here you can
  181.                         set all of the tempos to a given 
  182.                         number.
  183.             
  184.             Play, stop and continue - as the Seq. Control 
  185.             window.
  186.             
  187.     If the menu was opened over a line the following functions
  188. become available from the menu:
  189.  
  190.             Cut      > Copies the selected line into the
  191.                        sequence copy buffer, then moves all of
  192.                        the later lines down a line, to fill in
  193.                        the gap.
  194.             Copy     > Copies the selected line into the
  195.                        sequence copy buffer.
  196.             Paste    > Pastes the contents of the sequence 
  197.                        copy buffer onto the selected line.
  198.             Insert   > Inserts a line before the selected one.
  199.             Clear    > Clears the selected line.
  200.             
  201.  
  202. ---->4:Sequence commands
  203.  
  204.     The commands are generally used to pass the current 
  205. playing position of the sequence to another point.
  206.  
  207.     You can have multiple commands on one line by separating
  208. them with a semi-colons. (;)
  209.  
  210.     The current command list is:
  211.     
  212.     Goto <line_number>              - Jumps to the line
  213.                                       <line_number>.
  214.                                       It is illegal to have 
  215.                                       more than one 
  216.                                       unconditional Goto on
  217.                                       a given line.
  218.                                               
  219.     Stop                            - Used to automatically 
  220.                                       stop the sequence 
  221.                                       playing.  (The sequence
  222.                                       will not stop until it
  223.                                       reaches line 50
  224.                                       otherwise)
  225.                                       
  226.     Loop <number>                   - Loops the line <number>
  227.                                       of times.
  228.                                       
  229. -----The counter
  230. The counter can be used mainly to repeat sections of a 
  231. sequence a set number of times, before moving onto a new part,
  232. but it can be used for more complicated sequences.
  233.  
  234. The counter is automatically reset to 0 when the sequence is 
  235. played, but not when it is 'continued'.
  236.  
  237.     ResetCounter                    - Resets the counter to 0.
  238.  
  239.     Inc <number>                    - Increments the counter
  240.                                       by <number>.
  241.                                       
  242.     Dec <number>                    - Decrements the counter
  243.                                       by <number>.
  244.                                       
  245.     If <expression> Goto <line>     - Conditional Goto, where
  246.                                       the <expression> can be
  247.                                       anything that would give
  248.                                       a true or false answer.
  249.                                       e.g. Counter=1,
  250.                                            Counter>5,
  251.                                            (Counter is the
  252.                                            variable name for
  253.                                            the counter)
  254.                                       (You can have as many
  255.                                       unconditional goto's on
  256.                                       a given line as you
  257.                                       like.  You can have one
  258.                                       conditional goto with
  259.                                       them too, if you want.)
  260.                                       
  261.                                       
  262. ---->5:Copyright and other important stuff
  263.  
  264. 'The Drummer' is Copyright 1995 Mike Goatly, and is currently
  265. Public domain.  This means you can copy it to your little
  266. heart's content, just so long as:
  267.         1:There is no finantial gain on your part (except for 
  268.           minimum admin. charges)
  269.         2:All the files you recieved with your copy remain
  270.           intact, and present in the new copies.
  271.           
  272. The two modules 'Stasis' and 'StasisRaw' are public domain
  273. modules written by Andy Southgate (©1995).  They are party of 
  274. a package called GameSuite.  I highly recommend it to anyone
  275. who programs only in basic and needs to add a bit of speed to
  276. their new games!
  277.  
  278. If you want to see improvements made to 'The Drummer' then you
  279. should write to me, and let me know!  It would be nice to hear
  280. from people who actually have a use for it!
  281.  
  282. If you have any decent samples of drums I could use, I would
  283. be grateful if you would send them to me.  I am trying to get
  284. hold of some first hand samples myself.  I will release 
  285. another version if I can get better ones.
  286.  
  287. Lastly, if you create any good sequences, send me a copy!  I
  288. may add them the the sequences directory in later releases!
  289.  
  290. You can contact me by
  291.  
  292.         Snail mail:           or Email:
  293.         
  294.         Mike Goatly,          M.P.Goatly@Herts.ac.uk
  295.         20 Ely Road,                (Until July 1998)
  296.         St. Albans,
  297.         Hertfordshire,
  298.         AL1 5NA
  299.         England
  300.         
  301. I hope you can find a use for 'The Drummer'.
  302.  
  303. Enjoy!
  304.  
  305. Mike.