home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / sound / protracker / !PTracker / !Help < prev    next >
Text File  |  1994-06-24  |  12KB  |  228 lines
  1.  
  2.                           ProTracker Release 0.5B
  3.                           -----------------------
  4.    By Owain Vaughan                                   Archimedes Freelancers
  5.    ----------------                                   ----------------------
  6.  
  7.  
  8. Thank you for using ProTracker, the ultimate public domain SoundTracker.
  9.  
  10. ProTracker is an 1-8 channel sound sequencing package that allows you to
  11. generate music that can be played on any computer with appropriate playback
  12. software. If you are familiar with the SoundTracker concept, then you will
  13. find ProTracker very powerful, and have the best editing features of any
  14. such program.
  15.   Once installed on the icon bar a SoundTracker module may be dragged to the icon to load the tune, or the ProTracker icon can simply be clicked on to
  16. start a new one. [See the file 'docs.fileformat' for details on the types
  17. of files that this version of ProTracker can load]
  18.  
  19. PT's icon bar menu options
  20. --------------------------
  21. Clicking MENU (middle button) over the iconbar icon will display PT's menu.
  22. It has five main options. The first, 'Info' displays the program information
  23. ie. version number, author, etc.
  24. The second entry 'About file' leads to a sub window containing information
  25. about the current tune in memory. 
  26. The third main menu entry, 'Options' leads to a submenu conatining nine
  27. further options. The first, 'Short names' saves new format ST Modules
  28. containing 20 character names, rather than 24 characters. The option is
  29. ticked when saving short names.
  30.   The second 'Save samp.s' leads to a further sub-menu which contains the
  31. 'All' option, and a writeable field. If the 'All' option is ticked this
  32. indicates that all 47 samples are saved in a module (whether they are used or
  33. not).If this option is un-ticked, PT will only save samples up to the last
  34. one used. If the writeable entry is ticked then PT will save exactly that
  35. many samples (whether they are used or not).
  36.   The next options, 'Sample load', and 'Old format' indicate what type of
  37. sample data a given file contains. They lead to a sub-menu with 'Logarithmic'
  38. and 'Linear'. Usually these options will not need to be changed, but, if
  39. after loading a sample, or old format tune, it sounds terrible, changing
  40. these options might help.
  41.   The next entry in the 'Options' menu is 'Clear'. This also leads to a
  42. further set of entries. This time they are 'Entire tune', 'Patterns' and
  43. 'Sample data'. Choosing one of these options will clear the appropriate
  44. part of the current tune.
  45.   The next two entries govern how PT looks when playing a tune. The first,
  46. 'FSA Active', allows the user to choose whether the Frequency Spectrum
  47. Analyser is displayed inside the program. The next option 'Track bars' allows
  48. the display of 'VU' bars on each track played. These options are ticked if
  49. active.
  50.  
  51. How to program the sequencer
  52. ----------------------------
  53. A ProTracker tune consists of a list of events that are to occur at
  54. particular times on the specified number of channels. An event is usually
  55. just a note (for pitch) and an instrument number (to identify which
  56. instrument is to be sounded). ProTracker has three octaves with 12 notes
  57. per octave and a possible of 47 instruments. The notes are named C-1 to B-1,
  58. C-2 to B-2 and C-3 to B-3 where the first part indicates the note and the
  59. second the octave. The instruments are named from 01-2F (in hex. Each is
  60. equivalent)
  61.   A completed piece of music will consist of a number of patterns connected
  62. together in the correct order to form a sequence. A pattern consists of
  63. anything from 1 to 64 events for each track. The tracks are organised into
  64. columns and the events into rows. Therefore the events to occur at the same
  65. time are placed on the same horizontal line.
  66.   Any event can also contain an effect command and its associated parameter
  67. (whether it contains a note or not). Thus, an event in ProTracker is
  68. composed of the following fields:
  69.  
  70.        <Note name>  <Instrument number>  <Effect command>  <Parameter>
  71.  
  72.        eg. C-101000,  D#221C00,  B-302303,  ---02VF8,   ---00000
  73.                        |  || |               |              |
  74.                     Note  || Parameter       |              |
  75.                           ||              No note        No sample
  76.                           |Command 
  77.                           |
  78.                     Instument
  79.  
  80.  *  If no note is to be played the 'Note name' field is shown as
  81.     three hyphens (---).
  82.  *  If the instrument is not to be changed the 'Instrument number' field
  83.     is shown as two zeros (00).
  84.  *  If no effect command is to be given, the 'Effect command' field
  85.     is shown as a zero.
  86.  
  87.  Therefore, the blank event when no note is being sounded and no command
  88.  given is displayed as ---00000
  89.  
  90. How to use instruments
  91. ----------------------
  92. In ProTracker instruments are basically sound samples. An instrument has
  93. several attributes:
  94.               
  95. Sample number : The number of the instrument      (&01-2F)
  96. Length        : The length of the sample in bytes (&00000-FFFFE)
  97. Volume        : The default volume                (&00000-000FF)
  98. Finetune      : The tuning system to use          (-8 to +7)
  99. Repeat offset : The start of the looping section  (&00000-FFFFE)
  100. Repeat length : The length of the looping section (&00002-FFFFE)
  101.  
  102. A normal sample will just finish after its length has run out.
  103. However a sample may loop itself to create a note of infinite length. To do
  104. this a sample may have repeat offset and repeat length values specified.
  105.   When this is done and the sample is played, the section from the start
  106. up to the repeat offset is played first, and the the piece defined by the
  107. offset & length is repeatedly played, until the note is stopped, or released.
  108.  
  109. Note: when no looping section is in use, the repeat offset must be 00000 and
  110.       the repeat length must be 00002.
  111.  
  112. ProTracker Tune effect summary
  113. -------------------------------
  114. There now follows a list of effects that can be used in ProTracker tunes.
  115. Effects marked with an asterisk are only partially implemented:
  116.  
  117. Effect  Name               Parameters                          Limits
  118. ------  ----               ----------                          ------
  119. 0       Arpeggio           Hex 1st halfnote, 2nd halfnote      (&0-F),(&0-F)
  120. 1       Portamento up      Amount to slide by every 1/50S      (&00-FF)
  121. 2       Portamento down    Amount to slide by every 1/50S      (&00-FF)
  122. 3       Tone Portamento    [Portamento speed]                  (&00-FF)
  123. 4       Vibrato            [Vibrato depth, vibrato speed]      (&0-F),(&0-F)
  124. 5       TP + VolSlide      Volume slide upspeed, downspeed     (&0-F),(&0-F)
  125. 6       Vibrato + VolSlide Volume slide upspeed, downspeed     (&0-F),(&0-F)
  126. 7       Tremolo            [Tremolo depth, tremolo speed]      (&0-F),(&0-F)
  127. 9       Set sample offset  Amount (bytes*&1000) to offset by   (&00-FF)
  128. A       Log VolSlide       Volume slide upspeed, downspeed     (&0-F),(&0-F)
  129. B       Pattern break      Decimal event number to jump to     (0-63)
  130. C       Set Log volume     Hex logarithmic volume              (&00-40)
  131. E  ***  Special effect     Hex effect number, parameter        (&0-F),(&0-F)
  132. G       Slide volume up    Amount to slide by every 1/50S      (&02-1E)
  133. H       Slide volume down  Amount to slide by every 1/50S      (&02-1E)
  134. J       Position jump      Hex sequence number                 (&00-7F)
  135. L       Line jump          Decimal event number                (0-63)
  136. M  ***  Sample mix         Hex sample number                   (&01-2F)
  137. P       Set stereo pos.    [Track no.], stereo position        (&1-8),(&1-7)
  138. R       Set sample rate    Hex sample rate in µS               (&11-3C)
  139. S       Set speed          Hex no. of 1/50S between events     (&00-1F)
  140. V       Set volume         Hex volume number                   (&00-FF)
  141. X       Extra commands     Hex effect number, parameter        (&0-F),(&0-F)
  142.  
  143. Note that effects 3,4,7 and P do not have to have parameters specified. If no
  144. parameter is given with a 3,4 or 7 command then the value of the last 3,4 or
  145. 7 command (which specified a value) will be used. If no track number is
  146. specified for a set stereo command then the command will affect the track on
  147. which the command is played.
  148.  
  149. Combined volume slide commands allow only the volume slide part of the
  150. command to be specified. These combined commands use the logarithmic scale,
  151. as used by the 'C' command. For instance:
  152.                                                                      
  153.    ---00501 would be the same as   ---00300 and ---00A01 simultaneously
  154.    ---00520 would be the same as   ---00300 and ---00A20 simultaneously
  155.    ---00500 is exactly the same as ---00300
  156.    ---00603 would be the same as   ---00400 and ---00A03 simultaneously
  157.    ---00680 would be the same as   ---00400 and ---00A80 simultaneously
  158.    ---00600 is exactly the same as ---00400
  159.  
  160. To make the volume slide up, give the parameter in the first nibble,
  161. and to make the volume slide down give it in the second nibble (as shown
  162. above). See command 'X' for linear equivalents of these combined commands.
  163.  
  164. The set speed command ('S') has 3 possible value ranges:
  165.                     
  166. &00     : Stops the tune
  167. &01-&1F : Sets number of 1/50S between events
  168. &20-&FF : Sets tempo of tune
  169. _____________________________________________________________________________
  170.  
  171. The 'E' command is used to specify a further sub-set of special effects as
  172. shown below:
  173.  
  174. Effect  Name                   Parameter
  175. ------  ----                   ---------
  176. E0x     Set filter status      0 - on, 1 - off (only works on some arcs)
  177. E1x     FineSlide pitch up     Add x to period
  178. E2x     FineSlide pitch down   Subtract x from period
  179. E3x *** Glissando control      0 - off, 1 - on (use with tone portamento)
  180. E4x *** Set vibrato waveform   0 - sine, 1 - ramp down, 2 - square
  181. E5x     Set finetune           finetune value
  182. E6x     Jump to/set loop       0 - set loop point, or play loop x times
  183. E7x *** Set tremolo waveform   0 - sine, 1 - ramp down, 2 - square
  184. E8x     NOT USED               0 - not used
  185. E9x     Retrig note            Re-trigger note every x/50S
  186. EAx     Fine VolumeSlide down  Add x to logarithmic volume
  187. EBx     Fine VolumeSlide up    Subtract x from logarithmic volume
  188. ECx     Note cut               Cut note after x/50S (set volume to 0)
  189. EDx     Note delay             Delay note by x/50S 
  190. EEx     Pattern delay          Delay pattern x notes
  191. EFx *** Invert loop/Funk rep.? 0
  192. _____________________________________________________________________________
  193.  
  194. The 'X' command is used to specify a further sub-set of extra commands as
  195. shown below:
  196.  
  197. Effect  Name                   Parameter
  198. ------  ----                   ---------
  199. X0x     Release sample loop    Release loop after x/50s
  200. X1x     Inter-note slide up    Halfnote to slide up to
  201. X2x     Inter-note slide down  Halfnote to slide down to
  202. X3x     TP  + linear vol up    Perform  3 + 00 and G + 0x
  203. X4x     Vib + linear vol up    Perform  4 + 00 and G + 0x
  204. X5x     TP  + linear vol down  Perform  3 + 00 and H + 0x
  205. X6x     Vib + linear vol down  Perform  4 + 00 and H + 0x
  206. X7x     NOT USED               0 - not used
  207. X8x     NOT USED               0 - not used
  208. X9x     NOT USED               0 - not used
  209. XAx     Fine VolumeSlide up    Add x to linear volume
  210. XBx     Fine VolumeSlide down  Subtract x from linear volume
  211. XCx     Gain sample            Gain logarithmic sample by x
  212. XDx     NOT USED               0 - not used
  213. XEx     NOT USED               0 - not used
  214. XFx     Set number of repeats  Restart tune x times (using restart position)
  215. _____________________________________________________________________________
  216.  
  217. Note:      As there is no standard definition for miscallaneous command 'EF'
  218.            it is not defined in this version of ProTracker.
  219. Note also: Contrary to popular belief, sample mix is NOT implemeted in
  220.            PT0.5, look forward to this in future versions!!
  221.  
  222.  .-------------------------------------------------------------------------.
  223.  |    See the on-line help pages in the program itself for more details    |
  224.  '-------------------------------------------------------------------------'
  225.  
  226.           Archimedes ProTracker is a product of Archimedes freelancers
  227.                         © 1992/1993/1994 Owain Vaughan
  228.