home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 2: Collection B / 17Bit_Collection_B.iso / files / 1441.dms / in.adf / PumaTracker.Doc < prev    next >
Encoding:
Text File  |  1987-09-30  |  9.2 KB  |  254 lines
  1.                       ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  2.                       ­         PUMA-TRACKER V0.99        ­
  3.                       ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­           (c) Agile'91
  4.                         Released In September 1991
  5.  
  6.                              The Documentation
  7.                              ~~~~~~~~~~~~~~~~~
  8.  
  9. I/ Introduction
  10.    ------------
  11.  
  12.     The aim of this utility is to achieve the best sound possible with
  13. the less memory and CPU time possible.
  14.     The module files are used on The Replay routine for ATARI. 
  15.     You can transfer it with DOS 2 DOS, and use it like that.
  16.     At this time, the replay-routine takes a maximum time of 15 scanlines
  17.  and a music takes an average of 6-8 Kbytes.
  18.  
  19.  
  20. II/ How to use the editor
  21.     ---------------------
  22.  
  23.     When you have skipped the intro, the screen appearing is the
  24. PATTERN-EDITOR SCREEN.
  25.     The SOND-DESIGNER SCREEN can be accessed by pressing ESC.
  26.  
  27.     Before editing a music, you must start by defining your instruments.
  28.  
  29.   A/ The SOUND-DESIGNER SCREEN (how to make a sound)
  30.      -----------------------------------------------
  31.  
  32.     YOU MUST DEFINE THE VOLUME AND THE FREQUENCY DATAS FOR EACH SOUND.
  33.  
  34.     1) Defining the envelope (Volume Data)
  35.        -----------------------------------
  36.  
  37.     Click in the box under 'VOLUME DATA' and then you can edit the volume
  38. sequence. ALL THE COMMANDS ARE IN HEXADECIMAL MODE.
  39.  
  40.     Here is the list of commands :
  41.     ------------------------------
  42.  
  43. *    C0-aa-bb-cc
  44.     ­ aa is the number of the sample (or waveform) used.
  45.     ­ Numbers between 00 and 09 included are samples which can be loaded
  46.           with the LOAD function (which will be explained later).
  47.     ­ Numbers between 0A and 33 are waveforms, it means samples of 32 bytes
  48.           already stored in the replay-routine.
  49.     ­ bb is the step to skip waveforms.
  50.         If bb=0 then there is no effect.
  51.         If you want to use a sample, you must set bb to 0.
  52.       cc is the number of waveforms to be played
  53.     Ex:    C0-0A-01-0F defines a synthetizer's sound.
  54.  
  55. *    A0-aa-bb-cc
  56.       This instruction makes the volume vary.
  57.         aa is the volume at the beginning
  58.         bb is the volume at the end
  59.         cc is the length of time to achieve the volume variation.
  60.     Ex:    A0-40-00-10 makes the volume vary from 64 to 0
  61.         in 16 VBL (units of time)
  62.  
  63. *    E0-00
  64.       This instruction stops the sound (It cuts the voice).
  65.  
  66. *    B0-aa
  67.       This instruction is the GOTO or LOOP command.
  68.       It permits to restarts a sound at any step of the volume sequence
  69.           (It's used for echo, make a never-ending sound or restart a
  70.         sound).
  71.       The aa number is the number of the line to reach multiplied by 4.
  72.     Ex :    C0-0A-01-0F
  73.         A0-40-00-10
  74.         A0-00-40-10
  75.         Here :
  76.         B0-00 loops on the first instruction.
  77.         B0-04 loops on the second instruction.
  78.         B0-08 loops on the third instruction.
  79.  
  80.     A SOUND MUST ALWAYS START WITH A C0 INSTRUCTION.
  81.     A SOUND MUST ALWAYS FINISH WITH AN E0 OR B0 INSTRUCTION.
  82.  
  83.     2/ Defining the frequency (Frequency Data)
  84.        ---------------------------------------
  85.  
  86.     Click in the box under 'FREQUENCY DATA' then you can edit the frequency
  87. of your sound.
  88.  
  89.     Here is a list of the available commands :
  90.     ----------------------------------------
  91.  
  92. *    D0-aa-bb-cc
  93.       This instruction keeps the frequency constant.
  94.       aa is the offset of the note multiplied by 2 (always even) and it's
  95.          added to the played note.
  96.       a value of 18 means that the frequency is transposed of 1 octave up.
  97.       bb is unused
  98.       cc is the length of time while the frequency doesn't vary.
  99.     Ex :    D0-00-00-01 plays the real note during 1 VBL (unit of time)
  100.         D0-02-00-01 plays the note transposed 1/12th of octave up.
  101.         D0-FE-00-01 plays the note transposed 1/12th of octave down.
  102.         This command allows you to make arpeggios...
  103.  
  104. *    A0-aa-bb-cc
  105.       This instruction makes the frequency vary.
  106.        aa is a value added to the frequency of the note at the beginning
  107.        bb is a value added to the frequency of the note at the end
  108.        aa and bb must be between 80 and 7F.
  109.        cc is the number of VBL...
  110.     Ex:    A0-50-00-20
  111.         makes a little slide from the actual frequency plus $50 down to
  112.         the actual frequency plus $00 (The sound becomes more sharpen).
  113.         A0-00-50-20
  114.         makes a little slide from the actual frequency plus $00 up to
  115.         the actual frequency plus $50 (The sound becomes more bass).
  116.  
  117.     3/ The Other Stuff
  118.        ---------------
  119.  
  120.     - SELECT SOUND can also be selected from the keyboard with F9 and F10.
  121.     - The octave of the sound can be changed by pressing F1 to F5.
  122.     - VIEW WAVEFORM displays all the look of the sample or waveform used
  123.     - LENGTH displays the number of bytes (in Hexa) for each sample or
  124.       waveform.
  125.     - Don't use SAVE and CLEAR, they ain't working yet !!!
  126.     - The LOAD option displays a new menu allowing to load samples.
  127.       You must SELECT a number of SAMPLE before loading it.
  128.       CANCEL exits this menu.
  129.       CLEAR doesn't work.
  130.  
  131.  
  132.   B/ THE PATTERNS-EDITOR SCREEN
  133.      --------------------------
  134.  
  135.     This screen is cut in two parts.
  136.  
  137.     1) The First One (Upper Part)
  138.        --------------------------    
  139.  
  140.        It contains the list of patterns for each voices. 
  141.        With some parametters like SPEED, OFFSET about instruments or note.
  142.  
  143.       - The left box contains the number of lines,
  144.        (like POSITIONS about 'Soundtracker'...)
  145.     
  146.       - The right box contains the Speed for each lines.
  147.        (You don't need to repeat the same speed on ever lines, use it like
  148.        Soundtracker...)
  149.  
  150.       - Then the four middle boxes contain the number of pattern, offset
  151.         about instrument, offset about note for each voice. These parameters
  152.         can be choosed in the second part of the screen (The lower part).
  153.     
  154.     How to use the two boxes 'Pos (Up-->Down)' and 'Patt (Down-->Up)'
  155.     -----------------------------------------------------------------
  156.  
  157.     If you press the first box, all parameters (Except the offset added to
  158. the instruments value) on the line selected (Upper Part) will be copied on the
  159. boxes (Lower Part). So you can show all sequence of music (Patterns) for every
  160. line of    'Positions Box'.
  161.  
  162.     If you press the second box, it's exactly the contrary that will happen.
  163.     Take care when using this function you can easily destroy your music !
  164.  
  165.       - PLAY (Upper Part) plays the song. Stop it by pressing again the left
  166.         mouse button.
  167.  
  168.       - LENGHT if you click on this box, the lenght from the file 'song'
  169.           actually will be appear.
  170.            This lenght can change when you edit your music or sound.
  171.            This function will help you to keep a cool size in memory. 
  172.  
  173.       - LOOP-TRACK 
  174.            At this line, the music will restart.
  175.  
  176.       - 'SONGNAME' is only to show it, you can enter anything here.
  177.         (See on the DISK screen the 'LOAD' & 'SAVE' options).
  178.  
  179.     2) The Lower Part, EDIT THE PATTERNS
  180.        ---------------------------------
  181.         
  182.       That's approximatly the same as SoundTracker.
  183.  
  184.     Enter the notes with the keyboard (Two octaves, choosen by pressing
  185.     F1 to F5).
  186.  
  187.     F6  Places your cursor on the first line of the pattern.
  188.     F7  Places your cursor in the middle of the pattern.
  189.      F8  Places your cursor at the end of the pattern.
  190.  
  191.     F9-F10 Select number from used sound, you can look it in the mouse
  192.            pointer.
  193.  
  194.     PLAY plays the 'Pattern' (Every pattern on every voice)
  195.  
  196.     Note that 3 effects are possible in the patterns:
  197.         '1' For the volume, type '140' <=> volume = $40 = 64
  198.  
  199.         '2' To slide the frequency down (Use it with a sound that don't
  200.             reset Frequency...)
  201.             Type '204'    <=> Frequency + 4 (Every vbl.)
  202.              '204'        ---------
  203.              '204'        ---------
  204.             Type '200'  to stop the effect
  205.  
  206.         '3' To slide the frequency up (Use it like the previous one...)
  207.  
  208.  
  209.     Some hints:
  210.     ­­­­­­­­­­­
  211.     You can use up to $80 patterns.
  212.     Don't forget that if you use the same patterns on some lines (on
  213. positions), when you change it, it will be changed on each lines...
  214.     Patterns are crunched and played like that, clear all effects unused.
  215.     Don't write about pattern $00 !
  216.     Don't clear a pattern if you use some patterns upper, it may cause some
  217. damages to your music.
  218.     Select the number of a pattern by voice, select offset from note.
  219.     Listen, when it's good, choose the POSITION-LINE (Upper Part), and click
  220. on the box 'Patt. Down-->Up'. This will copy the parameters...
  221.  
  222. III/ Credits for that program
  223.      ------------------------
  224.  
  225.     Improving of the program : Shocker, Flyspy, Exocet
  226.      Replay-Routine debugging : Flyspy
  227.       Documentations           : Shocker
  228.  
  229.     All the work behind that program and the documentation has been done
  230.     by the French AGILE Section. If you wanna contact us for any reason,
  231.                 just send a letter to the following address :
  232.  
  233.                                  ­ AGILE ­
  234.                                    BP 43
  235.                           13266 MARSEILLE CEDEX 08
  236.                                    FRANCE
  237.  
  238.         Or to...     ­ AGILE ­
  239.                                  Box  3081
  240.                               18103  LINDINGO
  241.                                    SWEDEN
  242.  
  243.                Or just take your phone and call our boards :
  244.  
  245.         STREETS OF FIRE   +46 755-10498    (Ministry+Mogwai)  SHQ (DEFJAM/AGILE)
  246.         THE GRAVEYARD     +44 91-5160560   (The Undertaker)   EHQ
  247.         ILLICIT ILLUSION  +1  717-399-3160 (The Mighty Quinn) WHQ
  248.         SANITARIUM        +1  416-575-9150 (Elektra)          CHQ
  249.         TONE TOWN         +1  414-781-3218 (Dictator)        USHQ
  250.         TWILIGHT ZONE     +49 511-456592   (Captain Midnight) GHQ
  251.         REIGN IN BLOOD    +49 203-409925   (Malzam&Andy)      GHQ
  252.  
  253.                                     /Shocker
  254.