home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / LIONSSOUNDUTILSPACK.DMS / in.adf / docs / Soundtracker2.4.DOC < prev    next >
Encoding:
Text File  |  1989-03-06  |  11.2 KB  |  300 lines
  1.  
  2. Note: This Soundtracker is based on the MasterSoundtracker V1.0
  3.       by TIP/PROPHETS and mainly on Soundtracker V2.2 by Unknown/D.O.C
  4.  
  5. Soundtracker V2.4 - A Quick Clarification.
  6. ------------------------------------------
  7.  
  8. Last changes done on: 07-29-89.
  9.  
  10. Update done by : MnemoTroN.
  11.  
  12. -------------------------------------------------------------------------
  13.  
  14. New features:
  15. -------------
  16.         - Built-in Preset-Editor
  17.           with    - Read Path
  18.             - Print PLst
  19.         - Load Sample function
  20.         - Print Song option
  21.         - Filter switch
  22.         - Play-Timer
  23.  
  24. The Song.
  25. ---------
  26. Any piece of music written with Soundtracker 2.4 is build up from patterns.
  27. Soundtracker  holds  a  table  with information about the sequence in which
  28. these parts must be played.  With 'Position' you determine your position in
  29. the  table.   With  'Pattern'  you  define  what  pattern  to  play at that
  30. position.  'Length' defines the total size of the table.  The full sequence
  31. of Patterns is the Song.
  32.  
  33.  
  34. The Keys.
  35. ---------
  36. The  original  (V1.8)  version  of  the  Soundtracker  had a German keymap.
  37. Version  2.4  supports a standard USA keymap and this ensures compatibility
  38. with  ALL  Amigas.  The keyboard has been extended, try typing on the whole
  39. key-rows.  The keys on your Amiga have been grouped to represent the layout
  40. of  a  two- octave piano-keyboard.  You can "shift" the keyboard one octave
  41. up  or down with the aid of the F1 and F2 keys, thus incrementing the range
  42. of the keyboard to three octaves.
  43.  
  44. Explanation of the options:
  45. ---------------------------
  46.  
  47. MAIN MENU:
  48. ----------
  49. Play     - will play the song
  50. Stop     - stops the song
  51. Edit     - edit a pattern
  52. Record   - edit pattern in real-time
  53. Clear    - will kill the song in memory
  54. Use Pset - will load a sample, which can be chosen by using the Preset-
  55.            gadget
  56. Filter   - will switch the Power-LED (and lowpassfilter on A500 and A2000) on
  57.            and off
  58. Disk Op  - switches to the Disk-Menu (see below)
  59. Print    - will print the Song to PRT: (right button to abort)
  60. Pset-Ed  - switched to the PresetList-Editor (see below)
  61.  
  62. The  small  gadgets  titled  from 1 to 4 represent the four audio channels of
  63. your Amiga computer.  When lit, the audio channel is enabled.
  64.  
  65. DISK MENU:
  66. ----------
  67. Load Song      - loads a song
  68. Save Song      - crunches and saves a song
  69. Delete Song    - deletes a song from the disk
  70. Load Module    - loads a module
  71. Save Module    - saves a module
  72. Delete Modules - deletes a modules from the disk
  73. Save Sample    - save the selected sample to disk
  74. Format Disk    - formats a disk
  75.  
  76. PRESETLIST-EDITOR:
  77. ------------------
  78. Insert     - inserts a sample into the PresetList
  79. Delete     - deletes a sample
  80. Read path  - reads the specified path and inserts the samples into the list
  81. Print Plst - lists the PresetList to PRT: (right button to abort)
  82. Save Plst  - saves the PresetList to disk
  83. Use Pset   - loads a selected sample into the memory
  84.  
  85. Press the right mousebutton to move faster up and down!
  86.  
  87. To read a sampledisk using 'Read path' you have to enter the path you want to
  88. read  (in  most  cases  'df0:'  to  'df3:').   Harddisk  users  may  enter  a
  89. volume-number  which  will  be  inserted  before  the  samplename.   Click on
  90. 'Volume'  to change it.  Disks with a name like 'ST-xx' will be automatically
  91. identified!
  92.  
  93. While editing:
  94. --------------
  95.                Cursor-keys move cursor.
  96.        shift + Cursor-keys move cursor fast.
  97.          alt + Cursor-keys move cursor fastest.
  98.                F6  - Set cursor to first line of pattern.
  99.                F7  - Set cursor to 16th line of pattern.
  100.                F8  - Set cursor to 32th line of pattern.
  101.                F9  - Set cursor to 48th line of pattern.
  102.                F10 - Set cursor to last line of pattern.
  103.                DEL - Delete note under cursor.
  104.        shift + F3  - Cut track of current pattern and copy into a buffer.
  105.        shift + F4  - Copy track of current pattern into a buffer.
  106.        shift + F5  - Copy buffer to track of current pattern.
  107.          alt + F3  - Cut the whole pattern and copy into a buffer.
  108.          alt + F4  - Copy pattern into a buffer.
  109.          alt + F5  - Copy buffer to current pattern.
  110.  
  111. While using Soundtracker V2.4, HELP will show you these commands once more.
  112.  
  113. A  small  word  about  the  +/-  gadgets:   pressing  the  left  AND  right
  114. mousebutton will in-/decrease the value faster !!
  115.  
  116. Sample zero function:
  117. ---------------------
  118. While  editing you're able to set the sample to the value zero (0!).  Press
  119. both mousebuttons at the position of the samplegadgets (plus, minus = +,-).
  120. Now  you  can  edit  the  pattern with the sample 0 to prevent difficulties
  121. according to the volume.
  122.  
  123. Instruments.
  124. ------------
  125. You  can  use  up to thirtyone different instruments in one music-piece.  All
  126. instruments  are listed in the preset-list.  The volume is always 64, but you
  127. can  change it to each value between 0 and 64.  To change the other values of
  128. each instrument you have to enter the preset-editor or use the gadgets in the
  129. program  (this  is  only  for  small changes.  use the preset-ed otherwise!).
  130. With  the  PresetEd  you can change the whole preset-list.  An instrument may
  131. have a maximal length of 64K !!
  132.  
  133. Notes:
  134. ------
  135.                C#1  0 3 C 2 3
  136.                /    |/  |  \|
  137.               /     /   |   Info
  138.              /     /  Command
  139.             /    Inst#
  140.          Note to
  141.          be played.
  142.  
  143.  
  144.  
  145. Note:     This is simply the note that is played with that particular
  146. -----     instrument.
  147.  
  148. Inst#:    This is the number of the instrument that is used to play that
  149. ------    note.  When the  instrument number  is zero, the last selected
  150.           instrument will be used.
  151.  
  152. Command:  This number tells Soundtracker what special functions shall be
  153. --------  performed while playing the note.
  154.  
  155. These functions are as follows:
  156.  
  157.      0 - Normal play or arpeggio.
  158.      1 - Portamento up.
  159.      2 - Portamento down.
  160.      A - Volume slide.
  161.      B - Position jump.
  162.      C - Set volume.
  163.      D - Pattern break.
  164.      E - Set filter on/off.
  165.      F - Set speed.
  166.  
  167. Info:      This byte contains the additional information for the commands.
  168. -----     
  169.  
  170. Arpeggio:  Arpeggio is used for simulating accords. This is done by rapidly
  171. ---------  changing the  notes while  playing an instrument.  Arepggios are
  172.            selected  whenever the  info byte  has a  non-zero value  and no
  173.            other command is selected.
  174.            When arpeggios  are used,  Soundtracker looks  five times during
  175.            the play  of one note,  at the information contained in the info
  176.            byte. Each nibble  (4 bits) in this byte  defines how many notes
  177.            Soundtracker must add to the the note currently played.  In each
  178.            of the  five passes  Soundtracker  does  the following  with the
  179.            information in the info byte:
  180.        
  181.        0 - Play the current note (immediately).
  182.  
  183.            1 - Add the first nibble to the current note.
  184.  
  185.            2 - Add the second nibble to the current note.
  186.  
  187.            3 - Play the current note.
  188.  
  189.            4 - Add the first nibble to the current note.
  190.  
  191.            5 - Add the second nibble to the current note.
  192.  
  193.  
  194. Portamento:  Portamento is used for  'sliding' the frequency of the sample.
  195. -----------  If  portamento  is in use, the  information  contained in  the
  196.              the info byte will be added to (or subtracted from) the period
  197.              of the note playing in each of the five passes.
  198.  
  199.    Example:  D#2 3208  Slides down $08
  200.              --- 0208  Slides down $08
  201.              --- 0108  Slides up $08
  202.              --- 0210  Slides down $10 (=16)
  203.              etc.
  204.  
  205.    
  206. Volume slide: This function  uses the same  parameters as Portamento except
  207. ------------- for that it changes the volume.
  208.  
  209. Position jump:
  210. --------------
  211.          The position jump command will  do the same like the pattern break
  212.          command,  but the info byte  gives the playroutine  the no. of the
  213.          new position.
  214.  
  215. Example: E-2 3B04 - Break the pattern and jump to position 4
  216.          --- 0000
  217.          --- 0B06 - Break the pattern and jump to position 6
  218.  
  219.  
  220. Volume:  When command $0C (=12) is selected, the volume is set to the value
  221. -------  contained in  the info byte.  The volume will remain at this level
  222.          until the next SAMPLE is played. At this time, the volume is reset
  223.          to the default volume level of that sample.
  224.  
  225. Example: C#1 1C22 - Set volume to $22 (=34) and use instrument # 1 to
  226.                     play the C#1 note.
  227.          D-2 0000 - Use instrument # 1 to play the D-2 note.
  228.                     (Volume level remains at $22 (=34))
  229.          B-1 1000 - Use instrument # 1 to play the B-1 note and
  230.                     set volume to default value for that
  231.                     instrument.
  232.  
  233. Pattern break:
  234. --------------
  235.          Pattern break is used to create shorter patterns than 64 notes.
  236.          The note with the $0D command will be played and after that the
  237.          next pattern in the position-table will be played.
  238.  
  239. Example: A#3 1D00 - At this point the pattern interrupts.
  240.          --- 0D00 - same.
  241.          C-1 0D30 - same.
  242.  
  243.  
  244. Filter:  This Soundtracker version allows you to turn the lo-pass filter
  245. -------  on/off.
  246.  
  247. Example: G#2 1E01 - Turns the filter and the power-led off.
  248.          --- 0000
  249.          E-1 1E00 - Turns the filter and the power-led on.
  250.  
  251. Warning to all Amiga 1000 owners:  Don't play with the power-led because A500
  252. and A2000 owners will not be happy when they hear your song.
  253.  
  254.  
  255. Speed:   This function allows changing the speed during play.
  256. ------   You can only enter a speed from $01 to $0F.
  257.          Setting the info byte to zero doesn't effect anything.
  258.          The normal speed is 6.
  259.  
  260. Example: D-2 4F04 - Set speed to 4
  261.          --- 0000
  262.          E-1 0F00 - Nothing happens to speed.
  263.          --- 0FC3 - Set speed to 3
  264.          G-2 2F06 - Set normal speed
  265.  
  266.      For your convenience the speed will now be set to 6 everytime you
  267.      load a song/module or clear the song.
  268.  
  269. The Playroutine.
  270. ----------------
  271. The  Playroutine  on  the Soundtracker disk is for using your music in demos,
  272. intros, games etc.  It was written using the Seka-assembler and the source of
  273. the routine can directly be incorporated in your demo/intro source.  When you
  274. are  finished  writing  your  music using Soundtracker V2.4, save it to disk.
  275. Use   the   function   'SAVE   MODULE'.    You   will  find  a  file  in  the
  276. 'modules'-directory, which contains all songdata and samples.  Load with SEKA
  277. the  source  of the playroutine and enter the size of the saved module at the
  278. label 'mt_data'.  Assemble.  Now load the saved module to 'mt_data'.
  279.  
  280. How to play a song:
  281. -------------------
  282. At the beginning of your program, call the 'mt_init' routine.
  283. Jump to the 'mt_music' routine each vertical blank.
  284. To stop the song, jump to the 'mt_end' routine.
  285.  
  286. P.S.   :   All  you  Workbench-fanatics  can  start the Soundtracker from the
  287. Workbench  without  using utilities like XIcon.  Simply use the provided icon
  288. (or draw your own), but remember:  don't forget to assign the ST-xx:  disks!
  289.  
  290. -----------------------------------------------------------------------------
  291.  
  292. Last remark:
  293. ------------
  294. Some  people  encountered  a  problem  with  the  Keyboard  while  using  the
  295. Soundtracker with an A2000 and Harddisk.  I changed the Keyboard-Routine, but
  296. I  can't  test  the  change with a Harddisk.  A friend of mine owns a Skyline
  297. Harddisk with A.L.F. and never came across this problem...
  298.  
  299. -----------------------------------------------------------------------------
  300.