home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / sound / mus_play / st25.lzh / SoundTracker2.5.Docs < prev    next >
Text File  |  1991-02-20  |  12KB  |  299 lines
  1.  
  2.  
  3. Note: This Soundtracker is based on the MasterSoundtracker V1.0
  4.       by TIP/PROPHETS and mainly on Soundtracker V2.2 by Unknown/D.O.C
  5.  
  6. Soundtracker V2.5 by Spreadpoint - A Quick Clarification.
  7. ---------------------------------------------------------
  8.  
  9. Last changes done on: 08-27-89.
  10.  
  11. Update done by : MnemoTroN.
  12.  
  13. New playroutine and some explanations from : MAHONEY & KAKTUS
  14.  
  15. -------------------------------------------------------------------------
  16.  
  17. Some words:
  18. -----------
  19.  
  20. The  last  version  of Soundtracker (V2.4) had a big bug in it.  Every time a
  21. 'Sure?'-Requester   appears,   the   display  will  be  damaged  badly.   The
  22. 'Load'-Gadget  at  the  right  was  also infiltrated by bugs.  This had to be
  23. fixed  soon  and  here is the solution:  SOUNDTRACKER V2.5.  Some guys at the
  24. VF-Party  on  07-29-89  asked  me to put in some edit-options and I think the
  25. result will satisfy them.
  26. If  you've  seen the 'Noisetracker' by Mahoney & Kaktus of NorthStar you will
  27. find some of it's features built in here.  I thought these things are so good
  28. - they have to be included in this program.  The most important change is the
  29. new  playroutine,  which is optimized and features two new commands.
  30.  
  31. IMPORTANT:
  32. ----------
  33. Please  note that all repeats of old Soundtracker-songs have to be divided by
  34. two  in  order to sound right.  The new playroutine will play the sample with
  35. the  full  length the first time and then the loop-part.  With this method it
  36. is  possible to have an attack-phase in the sample.  The old Soundtracker did
  37. play the loop only.
  38.  
  39. Ok, but now....
  40.  
  41. New features:
  42. -------------
  43.         - New edit options:
  44.           - Track one half-step up/down
  45.           - Track one octave up/down
  46.           - One instrument up/down
  47.           - Kill instrument
  48.         - New disk-menu:
  49.           - Load Sample (with directory)
  50.           - All directories (song/module/sample) can be changed
  51.         - New playroutine (2 new commands)
  52.           by MAHONEY & KAKTUS
  53.  
  54. The Song.
  55. ---------
  56. Any piece of music written with Soundtracker 2.5 is build up from patterns.
  57. Soundtracker  holds  a  table  with information about the sequence in which
  58. these parts must be played.  With 'Position' you determine your position in
  59. the  table.   With  'Pattern'  you  define  what  pattern  to  play at that
  60. position.  'Length' defines the total size of the table.  The full sequence
  61. of Patterns is the Song.
  62.  
  63. The Keys.
  64. ---------
  65. The  original  (V1.8)  version  of  the  Soundtracker  had a German keymap.
  66. Version  2.5  supports a standard USA keymap and this ensures compatibility
  67. with  ALL  Amigas.  The keyboard has been extended, try typing on the whole
  68. key-rows.  The keys on your Amiga have been grouped to represent the layout
  69. of  a  two- octave piano-keyboard.  You can "shift" the keyboard one octave
  70. up  or down with the aid of the F1 and F2 keys, thus incrementing the range
  71. of the keyboard to three octaves.
  72.  
  73. Explanation of the options:
  74. ---------------------------
  75.  
  76. MAIN MENU:
  77. ----------
  78. Play     - will play the song
  79. Pattern  - play the current pattern
  80. Stop     - stops the song
  81. Edit     - edit a pattern
  82. Record   - edit pattern in real-time
  83. Clear    - will kill the song in memory
  84. Use Pset - will load a sample, which can be chosen by using the Preset-
  85.            gadget
  86. Filter   - will switch the Power-LED (and lowpassfilter on A500 and A2000) on
  87.            and off
  88. Disk Op  - switches to the Disk-Menu (see below)
  89. Print    - will print the Song to PRT: (right button to abort)
  90. Pset-Ed  - switches to the PresetList-Editor (see below)
  91.  
  92. The  small  gadgets  titled  from 1 to 4 represent the four audio channels of
  93. your Amiga computer.  When lit, the audio channel is enabled.
  94.  
  95. DISK MENU:
  96. ----------
  97. Load Song      - loads a song
  98. Save Song      - crunches and saves a song
  99. Delete Song    - deletes a song from the disk
  100. Load Module    - loads a module
  101. Save Module    - saves a module
  102. Delete Modules - deletes a modules from the disk
  103. Load Sample    - read a sample from any disk
  104. Save Sample    - save the selected sample to disk
  105. Format Disk    - formats a disk
  106.  
  107. PRESETLIST-EDITOR:
  108. ------------------
  109. Edit       - to edit an entry
  110. Insert     - inserts a sample into the PresetList
  111. Delete     - deletes a sample
  112. Read path  - reads the specified path and inserts the samples into the list
  113. Print Plst - lists the PresetList to PRT: (right button to abort)
  114. Save Plst  - saves the PresetList to disk
  115. Use Pset   - loads a selected sample into the memory
  116.  
  117. Press the right mousebutton to move up and down faster!
  118.  
  119. The  'Edit'-option  is  not  included  in the menu.  Just click on one of the
  120. entries  and  you  can  change  the  name  or  the  other  values.  To read a
  121. sampledisk  using 'Read path' you have to enter the path you want to read (in
  122. most cases 'df0:' to 'df3:').  Harddisk users may enter a volume-number which
  123. will  be  inserted  before  the  samplename.  Click on 'Volume' to change it.
  124. Disks with a name like 'ST-xx' will be automatically identified!
  125.  
  126. To  change  a  directory without reading it, move the cursor to the uppermost
  127. line  of  the  screen  over  one  of  the  options (song/module/sample).  The
  128. directory will change to this option.
  129.  
  130. All time key-commands:
  131. ----------------------
  132.             Tab - Play
  133.      Left Amiga - Play Pattern
  134.     Right Amiga - Edit Pattern
  135.           Space - Stop
  136.  
  137. While editing:
  138. --------------
  139.                Cursor-keys move cursor.
  140.        shift + Cursor-keys move cursor fast.
  141.          alt + Cursor-keys move cursor fastest.
  142.                F6  - Set cursor to first line of pattern.
  143.                F7  - Set cursor to 16th line of pattern.
  144.                F8  - Set cursor to 32th line of pattern.
  145.                F9  - Set cursor to 48th line of pattern.
  146.                F10 - Set cursor to last line of pattern.
  147.                DEL - Delete note under cursor.
  148.        shift + F3  - Cut track of current pattern and copy into a buffer.
  149.        shift + F4  - Copy track of current pattern into a buffer.
  150.        shift + F5  - Copy buffer to track of current pattern.
  151.          alt + F3  - Cut the whole pattern and copy into a buffer.
  152.          alt + F4  - Copy pattern into a buffer.
  153.          alt + F5  - Copy buffer to current pattern.
  154.  
  155. While using Soundtracker V2.5, HELP will show you these commands (and more).
  156.  
  157. A  small  word  about  the  +/-  gadgets:   pressing  the  left  AND  right
  158. mousebutton will in-/decrease the value faster !!
  159.  
  160. Sample zero function:
  161. ---------------------
  162. While  editing you're able to set the sample to the value zero (0!).  Press
  163. both mousebuttons at the position of the samplegadgets (plus, minus = +,-).
  164. Now  you  can  edit  the  pattern with the sample 0 to prevent difficulties
  165. according to the volume.
  166.  
  167. Instruments.
  168. ------------
  169. You  can  use  up to thirtyone different instruments in one music-piece.  All
  170. instruments  are listed in the preset-list.  The volume is always 64, but you
  171. can  change it to each value between 0 and 64.  To change the other values of
  172. each instrument you have to enter the preset-editor or use the gadgets in the
  173. program  (this  is  only  for  small changes.  use the preset-ed otherwise!).
  174. With  the  PresetEd  you can change the whole preset-list.  An instrument may
  175. have a maximal length of 64K !!
  176.  
  177. Notes:
  178. ------
  179.                C#1  0 3 C 2 3
  180.                /    |/  |  \|
  181.               /     /   |   Info
  182.              /     /  Command
  183.             /    Inst#
  184.          Note to
  185.          be played.
  186.  
  187.  
  188.  
  189. Note:     This is simply the note that is played with that particular
  190. -----     instrument.
  191.  
  192. Inst#:    This is the number of the instrument that is used to play that
  193. ------    note.  When the  instrument number  is zero, the last selected
  194.           instrument will be used.
  195.  
  196. Command:  This number tells Soundtracker what special functions shall be
  197. --------  performed while playing the note.
  198.  
  199. Info:     This byte contains the additional information for the commands.
  200. -----     
  201.  
  202. These functions are as follows:
  203.  
  204.     0 - Normal play or arpeggio.
  205.     1 - Portamento up.
  206.     2 - Portamento down.
  207.     3 - Tone-portamento
  208.     4 - Vibrato
  209.     A - Volume slide.
  210.     B - Position jump.
  211.     C - Set volume.
  212.     D - Pattern break.
  213.     E - Set filter on/off.
  214.     F - Set speed.
  215.  
  216.  $0 Arpeggio  -  $0 + second halfnote-add + third halfnote-add
  217.       This command will produce a one-channel chord. No comments.
  218.      C-3 00037   produces a minor-chord
  219.      C-3 00047   produces a major-chord
  220.  
  221.  $1 Portamento up  -  $1 + portamentospeed
  222.       This commans slides the pitch up.
  223.      C-3 00103   1 is the command, 3 is the speed.
  224.  
  225.  $2 Portamento down  -  $2 + portamentospeed
  226.       This command slides the pitch down.
  227.      C-3 00203   2 is the command, 3 is the speed.
  228.  
  229.  $3 Tone-portamento  -  destination-note + $3 + speed
  230.       This will automatically slide from the old note to the new. To keep on
  231.       sliding, just select the command 3. Try it out yourself, and I'm
  232.       sure you'll understand a little bit better.
  233.      C-3 00305   C-3 is the note to slide to, 3 the command and 5 the speed.
  234.  
  235.  $4 Vibrato  -  $4 + vibratospeed + vibratosize
  236.      C-3 00481   4 is the command, 8 is the speed of the vibrato and 1 is the
  237.       size of the vibrato.
  238.      To keep on vibratoing (?) just select the command 4.
  239.  
  240.  $A Volume-slide  -  $A + upslidespeed + downslidespeed
  241.      C-3 00A05   5 is the speed to turn down the volume
  242.      C-3 00A40   4 is the speed to slide it up.
  243.  
  244.  $B Position-jump  -  $B + song-position to continue at
  245.      C-3 00B01   1 is the place to restart the song at.
  246.       This command will also perform a pattern-break.
  247.  
  248.  $C Set volume  -  $C + new volume
  249.       Well, this old familiar command will set the current volume to your
  250.       own selected. The highest volume is $40. All volumes are represented
  251.       in hex. (Programmers do it in hex, you know!)
  252.      C-3 00C10   C is the command, 10 is the volume.
  253.  
  254.  $D Pattern-break  -  $D + nothing
  255.       Sure simple, this magic thing will end your pattern and go on with the
  256.       next one.
  257.      C-3 00D00   D in the command, all others are a waste of memory.
  258.  
  259.  $E Set filter  -  $E + filter-status
  260.       This command jerks around with the sound-filter on some A500 + A2000.
  261.       All other Amiga-users should keep out of playing around with it.
  262.      C-3 00E01   disconnects filter (turns LED off)
  263.      C-3 00E00   connects filter (turns LED on) * please keep LED off!
  264.  
  265.  $F Set speed  -  $F + speed
  266.       This will change the speed of your tune. (how fast your patterns will
  267.       roll ...) Speeds from $01 - $1f are allowed.
  268.      C-3 00F07   sets speed to 7
  269.  
  270. For  your  convenience  the  speed  will now be set to 6 everytime you load a
  271. song/module or clear the song.
  272.  
  273. The Playroutine.
  274. ----------------
  275. The  Playroutine  on  the Soundtracker disk is for using your music in demos,
  276. intros, games etc.  It was written using the Seka-assembler and the source of
  277. the routine can directly be incorporated in your demo/intro source.  When you
  278. are  finished  writing  your  music using Soundtracker V2.5, save it to disk.
  279. Use  the  function  'SAVE  MODULE'.   You  will  find  a file in the selected
  280. directory,  which  contains  all  songdata  and  samples.  Load with SEKA the
  281. source of the playroutine and enter the size of the saved module at the label
  282. 'mt_data'.  Assemble.  Now load the saved module to 'mt_data'.
  283.  
  284. How to play a song:
  285. -------------------
  286. At the beginning of your program, call the 'mt_init' routine.
  287. Jump to the 'mt_music' routine each vertical blank.
  288. To stop the song, jump to the 'mt_end' routine.
  289.  
  290. P.S.   :   All  you  Workbench-fanatics  can  start the Soundtracker from the
  291. Workbench  without  using utilities like XIcon.  Simply use the provided icon
  292. (or  draw your own), but remember:  don't forget to assign the ST-xx:  disks!
  293. Be  sure to close most windows on the Workbench because while Soundtracker is
  294. running,  the  Workbench  is  still  active (invisibly!).  Opened windows can
  295. cause some unexpected effects (although I fixed this partly).....
  296.  
  297. -----------------------------------------------------------------------------
  298.  
  299.