home *** CD-ROM | disk | FTP | other *** search
/ modiromppu / modiromppu.iso / PROGRAMS / TRACKERS / SADT / SADT.DOC < prev    next >
Text File  |  1995-05-28  |  33KB  |  839 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                      ▄▀▀▀▀▀▀▀▀▓▀▀▀▀▀▀▀▀▓   ▓▀▀▀▀▀▀▀▀▀▓▄▄
  8.                                     ▓ ▄█▓▀▀▀▀   ▄████▄ ▀▀█ █ ▒▓█ ▒▓█   █
  9.                                     █  ▀▀▀▀█▄  ▐██  ██▌  ▓ █ ▓██ ▓██▀▀ █▄▄
  10.                                     █  ▄▄▌ ██▌ ██▓  ███  ▓ █ ▓██ ▓██ ▐▄▄ ■▓
  11.                                     █ ██▓  ███ ██▓  ███  ▓▄▓ ███ ███  ███ █
  12.                                     █ ██▓  ███ ███▄▄███  ▄▄▄▄███ ███  ███ █
  13.                                     █ ███  ██▓ ███  ██▓ ▐██  ██▓ ███  ██▓ █
  14.                                     █ ███  ██▓ ███  ██▓ ███  ██▓ ███  ██▓ █
  15.                                     ▐▌▐██▒ ██▓ ███▒ ██▓ ███▒ ██▓ ▐██▒ ██▓ █
  16.                                      █ ▀█▓▄█▓▒ ███▓ █▓▒ ▀██▓▄█▓▒  ▀█▓▄█▓▒ █
  17.                                      ▓■▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▓▄▄▄▄▄▄▄▄▓
  18.                                      ──[ Surprise! Adlib Tracker v2.00 ]──
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                                         ┌──────────────────────────────┐
  48.                                         │                              │
  49.                                         │  Surprise! productions       │
  50.                                         │  Adlib Tracker Version 2.0   │
  51.                                         │  >>> Beta Release <<<        │
  52.                                         │                              │
  53.                                         │  Erik Pojar,                 │
  54.                                         │  Siegfriedgasse 55           │
  55.                                         │  1210 Wien                   │
  56.                                         │  Austria                     │
  57.                                         │                              │
  58.                                         │  +43 1 2574457               │
  59.                                         │  epojar@stud1.tuwien.ac.at   │
  60.                                         │                              │
  61.                                         └──────────────────────────────┘
  62.  
  63.                                                                       Page 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                Surprise! productions Adlib Tracker 2.0 Help file
  70.                -------------------------------------------------
  71.  
  72.  
  73.  
  74.                                    Contents:
  75.  
  76.  
  77.  
  78.                 What's new in Version 2.0.......................2
  79.                 General Stuff...................................3
  80.                 The Main Menu...................................4
  81.                 The Edit Mode...................................5
  82.                 Making Music....................................6
  83.                 The Instrument maker............................7
  84.                 Command summary.................................12
  85.                 File Format.....................................16
  86.                 Last Words & Adress.............................18
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.               This file was typed by Erik of Surprise! productions
  98.  
  99.  
  100.  
  101.  
  102.      What's new in Version 2.0                                        Page 2
  103.      -------------------------
  104.  
  105.      There have been quite a lot changes from previous versions. Here are
  106.      the highlights:
  107.  
  108.            - 90 x 30 characters textmode used. (VGA needed)
  109.            - General optical brush-up
  110.            - All 8 Oktaves of the Adlib can now be accessed
  111.            - Some errors in the handling of the effect commands were
  112.              removed. Now SADT SHOULD behave exactly like any Amiga-Tracker
  113.            - Now also supports the commands 4, 5 and 6. Commands 7 and E not :-(
  114.            - New file format (versions 7 to 9) which takes less space.
  115.            - Completely new Memory management. Free memory is shown
  116.            - now also supports BPM timing
  117.            - Default speed now is 125 BPM, speed 6
  118.            - Configuration menu lets you specify song-, instrument- and
  119.              module directory
  120.            - New edit functions
  121.            - Bugfix in the Amiga-Load function.
  122.              Now supports general 4-voice formats along with 6- and 8-voice
  123.              formats.
  124.            - Totally rewritten play routine in assembler.
  125.            - a totaly new and unique feature for the instrument handling was
  126.              implemented: The 'special arpeggio'. It let's you change the
  127.              frequency, volume and even the waveform of an instrument while
  128.              it's played.
  129.  
  130.  
  131.      General Stuff                                                    Page 3
  132.      -------------
  133.  
  134.      In the whole program (and in this doc too..) some (quite common?) pre-
  135.      fixes are used:
  136.  
  137.            [a]  means the 'a' key on your Keyboard
  138.            [A]  means the 'a' key + [Shift] on your Keyboard
  139.            [^A] means the 'a' key + [Control]
  140.            [@A] means the 'a' key + [Alt]
  141.  
  142.      I'm not going to explain every obvious function of the Editor. For ex-
  143.      ample, I won't tell you that Alt-Save means 'Save Song'. It's all in the
  144.      Main Menu, so keep your eyes open!
  145.  
  146.      This program should be keyboard driver independent. This means it should
  147.      not matter wether you use it with a german, english, french or any other
  148.      keyboard layout.
  149.      However, if you encounter some problems with the keyboard, switch to the
  150.      U.S. layout and everything should be just fine.
  151.  
  152.  
  153.  
  154.      The Main Menu                                                    Page 4
  155.      -------------
  156.  
  157.      The main menu is more or less self explaining, there are several functions
  158.      which are accessible through alt-key combinations or ctrl-key combinations.
  159.      For example Alt-L to load a song, or Ctrl-L to load an Amiga Module.
  160.  
  161.      However there are a few functions which don't show up in the main menu:
  162.  
  163.         * [@1]..[@9]:   Toggle Channel on / off
  164.           Control P:    Play from the beginning of the song
  165.         * Ctrl+Alt:     Fast forewind when playing
  166.           Cursor Keys:  Move around pattern
  167.           Tabulator:    Jump to next Channel
  168.           Shift Tab:    Jump to previous Channel
  169.           F5-F9:        Jump to 1st, 16th, 32th, 48th, 63th line of pattern
  170.           PageUp/Down:  Goto previous / next pattern
  171.         * Ctrl PgUp/Dn: Goto previous / next pattern (according to patternorder)
  172.         * [+],[-]:      switch instruments.
  173.           Space:        Toggle Edit / Menu mode.
  174.                         In Edit mode, the border is blue.
  175.           Delete:       Delete entry in current channel
  176.           R.Shift+Del:  Delete entry selectively:
  177.                         If the cursor is in the column for the notes, only
  178.                         the note is deleted, if it's in the column for the
  179.                         instruments, only the instrument is deleted, otherwise
  180.                         the effects.
  181.           Shift F1:     Shift Keyboard 1 Octave up
  182.           Alt F1:       Shift Keyboard 1 Octave down
  183.           Control F1:   Mark every 4th line (like in ScreamTracker..)
  184.           Shift F2:     Toggle linefeed for editing effect commands
  185.           F2:           Mark Block Begin
  186.           F3:           Mark Block end (the block is not displayed)
  187.           F4:           Paste Block
  188.           Shift F4:     Paste Commands in Block
  189.           Control F4:   Paste Notes in Block
  190.           F10           Release sustaining sound in current channel
  191.           Shift F5:     Insert blank line in current channel
  192.           Control F5:   Insert blank line in all nine channels
  193.           Shift F6:     Delete line in current channel
  194.           Control F6:   Delete line in all nine channels
  195.           Shift F7:     Transpose current channel one halfnote up
  196.           Control F7:   Transpose whole pattern one halfnote up
  197.           Alt F7:       Transpose current Note up, and move to next
  198.           Shift F8:     Transpose current channel one halfnote down
  199.           Control F8:   Transpose whole pattern one halfnote down
  200.           Alt F8:       Transpose current Note down, and move to next
  201.           F10           Release sustaining sound in current channel
  202.           F11/F12       Change BPM value
  203.  
  204.      The Funcions marked with * are also available while playing a song
  205.  
  206.      Note: The Control-S function (Save compressed song) is for internal
  207.      usage only. Sadt can NOT load compressed songs! So always save songs
  208.      uncompressed.
  209.  
  210.  
  211.      The Edit Mode:                                                   Page 5
  212.      --------------
  213.  
  214.      The Edit mode let's you edit a song...
  215.      All of the above functions are available via hotkey... In fact most
  216.      of the functions are only available in edit mode. All the deleting,
  217.      transposing, etc. is not available in non-edit mode.
  218.  
  219.      In non-edit mode you can still move around the patterns and play some
  220.      notes, but they won't show up in the patterns
  221.  
  222.  
  223.      Making music                                                     Page 6
  224.      ------------
  225.  
  226.      (this part of the doc is taken from the PT1.1 helpfile. I didn't see
  227.      the point in inventing it all again... ;-)
  228.  
  229.      Any piece of music written with the SADT is built up from patterns.
  230.      Each pattern is built up from 9 tracks, one for each of the adlib's
  231.      audiochannels.
  232.  
  233.      A pattern is 64 lines long. The magnified line is always the one you
  234.      edit. If you need shorter patterns, use the pattern break command.
  235.  
  236.      A Track is built up like this:
  237.  
  238.                    32   C-3  01  C20
  239.                    /    \_/  |/  \_/
  240.                  /     /     |      \
  241.               Pos   Note   Instr.  Effect command
  242.  
  243.      The C-3 is the note being played at patternposition 32.
  244.      01 is the instrument number, and the three last digits are the
  245.      effect command, in this case, set volume to 20 Hex.
  246.      (C is the command, 20 the value)
  247.      Values for instruments and effects are always hexadecimal.
  248.  
  249.      After you have edited all your patterns you have to determine the
  250.      pattern order. For that simply use the Order editor. Furthermore
  251.      you can define the length of a song, and a restart pos.
  252.      Here's an example:
  253.  
  254.      Let's say you have entered three patterns (Numbers 0, 1 and 2) and
  255.      wanto to play the pattern 2 twice, then pattern 0 and finally
  256.      pattern number 1 three times. afterwards the music should start with
  257.      the second pattern 2 again.
  258.      Here's what to do:
  259.      Edit the Pattern order like this:
  260.  
  261.                Position    Pattern number
  262.                   0              2
  263.                   1              2
  264.                   2              0
  265.                   3              1
  266.                   4              1
  267.                   5              1
  268.                   .              .
  269.                   .              .
  270.  
  271.  
  272.      Set Songlength to 6, and Restart to 1.
  273.  
  274.      To enter the notes SADT uses a piano-like keyboard layout.
  275.      Assuming you are using a US-Keyboard layout the keys would be:
  276.  
  277.      High Notekeys:
  278.                          2 3   5 6 7   9 0
  279.                         Q W E R T Y U I O P
  280.  
  281.      Low NoteKeys:
  282.                          S D   G H J   L ;
  283.                         Z X C V B N M , . /
  284.  
  285.  
  286.      The Instrument maker                                             Page 7
  287.      --------------------
  288.  
  289.      I'll just explain the basics how the FM chip works, I wont list all the
  290.      keys, just look at the menu that pops up.
  291.  
  292.      Still there are a few special keys I'd like to mention:
  293.  
  294.      [F10]           Releases a sustaining Note
  295.      [F2]            Copies the current Instrument into a buffer,
  296.      [F4]            Pastes this buffer. (real handy if you need several very
  297.                      similar instruments... just copy 'em, and then change 'em)
  298.  
  299.      But now let's really get to the FM instrument maker
  300.      O.K. Here we go: The adlib has two operator cells for each voice (channel)
  301.  
  302.              ∙ The Carrier
  303.              ∙ The Connector (often also called Modulator...)
  304.  
  305.      Each voice can work in
  306.  
  307.              ∙ Additive Synthesis (Frequency Modulation = Off)
  308.              ∙ Frequenzy Modulation (Freq. Mod. = On)
  309.  
  310.      mode. When using Additive Synthesis, each operator produces it's sound and
  311.      plays it simultaneousely...
  312.      When using Freq. modulation, the Connector changes the sound of the Carrier
  313.      (yep! it modulates the sound.. that's why it's also called modulator... ;-)
  314.  
  315.      O.K. here are the mere basics: for each Cell you must define:
  316.           ∙ Attackrate     (0-15, 0 = none 15 = fastest)
  317.           ∙ Decayrate      (0-15, 0 = none 15 = fastest)
  318.           ∙ Sustain level  (0-15, 0 = none 15 = fastest)
  319.           ∙ Release Rate   ( just guess what....       )
  320.  
  321.      This is how it works: first theres nothing, then the tone rises with
  322.      the speed of the <attackrate> to it's total level.
  323.      Afterwards it drops with the speed of <decayrate> to it's <sustain level>
  324.      And then drops with the speed of <release rate> to zero again
  325.  
  326.      If you set the flag
  327.           ∙ Sustaining sound
  328.  
  329.      to On, then the sound stays at the <sustain level> till the note is
  330.      released. (Just like when you keep a key pressed on an electric organ...)
  331.      To release a note press [F10]. Then the sound vanishes with the speed of
  332.      <release rate>
  333.  
  334.  
  335.      For each operator there are three possible waveforms:            Page 8
  336.  
  337.          0: Sinus           ----
  338.                          -       -
  339.                       /             \
  340.                     /                 \
  341.                    ---------------------\------------------/
  342.                                           \              /
  343.                                              -        -
  344.                                                 ----
  345.  
  346.          1: Half Sinus     ----
  347.                          -       -
  348.                       /             \
  349.                     /                 \
  350.                    ---------------------\------------------
  351.  
  352.  
  353.  
  354.          2: abs(Sinus)     ----                   ----
  355.                          -       -              -      -
  356.                       /             \        /            \
  357.                     /                 \    /                \
  358.                    ---------------------\/--------------------\
  359.  
  360.  
  361.  
  362.  
  363.          3: Sinus ?         --|                   --|
  364.                          -    |                -    |
  365.                       /       |             /       |
  366.                     /         |           /         |
  367.                    ------------------------------------------
  368.  
  369.      Volume
  370.      Of course, there's also volume control: volume ranges from 0 to 63
  371.      0 = silents (grin), while 63 = max. volume
  372.  
  373.      Level Scaling
  374.      Used to control the volume. Level Scaling is a Value between 0 and 3.
  375.      0 means, that the volume of the sound is not changed, while values >0
  376.      mean, that higher tones are played at a lower volume. If you set
  377.      Level Scaling to 3 (which is the max), the volume drops 6db each octave.
  378.  
  379.      Frequency Multiplier:
  380.      specify a value between 0 and 15. That's the multiplier for the frequenzy. If you set it to 15, you'll get really high pitch tones..
  381.      If you set it to 1, you get 'the real' frequency. If you set it to 0,
  382.      the frequency is multiplied by 0.5
  383.  
  384.      Tremolo:
  385.      If you set this flag to On, the Amplitude is changed in Vibrato-Style..
  386.  
  387.      Vibrato:
  388.      Also a flag. Set it to On, and you've got frequency vibrato..
  389.  
  390.      Sustainig Sound:
  391.      described above.
  392.  
  393.      Scaling:                                                         Page 9
  394.      If this flag is set to On, higher tones sound shorter...
  395.  
  396.      Freq. Modulation:
  397.      If this flag = Off, additive synthesis is used.
  398.      If it's set to On, freq. modulation is used.
  399.  
  400.      Feedback:
  401.      Define the strength of the feedback (values 0..7)
  402.  
  403.  
  404.      Now. That are the standard parameters of the Adlib-FM chip.
  405.      But with SADT 2.0 I introduced a new feature:
  406.  
  407.                       >>>> the special arpeggio <<<<
  408.  
  409.      The idea was change both the frequenzy and waveform of an instrument
  410.      while it's played.
  411.  
  412.      The Special arpeggio is controlled by these values:
  413.  
  414.      <Arpeggio>: is a pointer to the arpeggio list
  415.      <Arpeggio speed>: the speed at wich the arpeggio is executed.
  416.  
  417.      Set <Arpeggio> to a value > 0 to turn the spec. arpeggio on.
  418.  
  419.      To define the special arpeggio you have to edit the special arpeggio
  420.      list. Press [@E] to enter the sepcial Arpeggio editor.
  421.  
  422.      There are two columns:
  423.  
  424.          Halfnote add:
  425.             here you place the half-note add values just like with the
  426.             arpeggio command (0)
  427.             Halfnote adds range from 0 to 96
  428.  
  429.             If you place a value >= 100 it's not treated as a halfnote add
  430.             but as an absolute note. There are 8 octaves with 12 halfnotes
  431.             each => 96 notes all in all.
  432.             If you enter 112 in the half-note add column, this would be
  433.             the absolute note 112-100 = 12 (which is a C-1).
  434.             O.K. Absolute notes range from 100 to 195.
  435.  
  436.                                                                       Page 10
  437.          Command:
  438.            Here you place special commands or different waveforms
  439.            These commands are available:
  440.  
  441.            255 stop special arpeggio
  442.            254 arpeggio loop. The arpeggio continues at the line which
  443.                is entered in the halfnote add column
  444.            253 Release note. Releases a sustained sound
  445.            252 Set Volume. Sets the volume to the value in halfnote add.
  446.  
  447.            Furthermore you can also change the waveform:
  448.            The new waveform =
  449.               (carrier waveform + 1)*10 + connector waveform + 1
  450.            if you set carrier or connector waveform to 0 everything stays
  451.            the same.
  452.  
  453.            A few examples: (WF = waveform)
  454.  
  455.            Value in Command column          what it causes
  456.            --------------------------------------------------------
  457.                    0                       Waveforms don't change
  458.                   44                 Carrier WF = 3, Connector WF = 3
  459.                   34                 Carrier WF = 2, Connector WF = 3
  460.                   12                 Carrier WF = 0, Connector WF = 1
  461.                   23                 Carrier WF = 1, Connector WF = 2
  462.                   20                 Carrier WF = 1, Connector WF = unchanged
  463.                   30                 Carrier WF = 2, Connector WF = unchanged
  464.                    4                 Carrier WF = unchanged, Connector WF = 3
  465.  
  466.                                                                       Page 11
  467.      That's all there is about the special arpeggio. It's a very powerfull
  468.      function. It let's you create very 'spacy' sounds....
  469.  
  470.      O.K. here are a few documented examples:
  471.  
  472.      Let's say you want to have a constant arpeggio of 4 and 7 halfnote adds.
  473.      with usual commands you would do it like this:
  474.  
  475.               C-3 01 047
  476.               --- 00 047
  477.               --- 00 047
  478.                .  .   .
  479.                .  .   .
  480.  
  481.      Here' show it's done with special arpeggio. Set <arpggio> to 1
  482.      Now edit the arpeggio list:
  483.  
  484.             Line     Command         halfnote add
  485.              1          0                  0
  486.              2          0                  4
  487.              3          0                  7
  488.              4         254                 1        ( jump back to line 1 )
  489.  
  490.      So, the big advantage is that you can do longer arpeggios:
  491.  
  492.              1          0                  0
  493.              2          0                  1
  494.              3          0                  2
  495.              4          0                  3
  496.              5          0                  4
  497.              6         42                  3        ( also change waveform)
  498.              7          0                  2
  499.              8          0                  1
  500.              9         254                 5        ( jump back to line 5 )
  501.  
  502.      Remember that <arpeggio> is the pointer at which line to start in the
  503.      arpeggio list. So if it's set to 10, the arpeggio will start at line
  504.      10!
  505.  
  506.      Well. That's it. I know that my explanations are a bit clumsy, but if you
  507.      experiment just a little bit, you'll see how it works..
  508.  
  509.  
  510.      Command summary                                                  Page 12
  511.      ---------------
  512.  
  513.      Commands supported by SADT / Trackers
  514.  
  515.         Command #         Trackers:                          Sadt:
  516.  
  517.            0         Normal play / arpeggio          Normal play / arpeggio
  518.            1             Slide up                        Slide up
  519.            2             Slide down                      Slide down
  520.            3           Tone portamento                Tone portamento
  521.            4               Vibrato                        Vibrato
  522.            5       Tone Portam + Vol. Slide.       Tone Portam. + Vol. Slide
  523.            6         Vibrato + Vol. Slide             Vibrato + Vol. Slide
  524.            7               Tremolo                   *** NOT SUPPORTED ****
  525.            8       *** NOT SUPPORTED ****           Release Sustaining Note
  526.            9          Set Sample Offset               *** INTERNAL USE ***
  527.            A            Volume Slide                     Volume Slide
  528.            B            Position Jump                   Position Jump
  529.            C             Set Volume                       Set Volume
  530.            D           Pattern Break                    Pattern Break
  531.            E             E-Commands                   *** INTERNAL USE ***
  532.            F             Set Speed                        Set Speed
  533.  
  534.        NOTE: The Commands 7,8,9 and E are removed if they are encountered
  535.        when converting an Amiga module.
  536.        It's no use to play with the command 7. It's simply not supported.
  537.        The commands 9 and E however, are used for internal data compression.
  538.        So please keep your hands off of it, unless you know how to handle
  539.        them. (And since Erik / S!P is the only one who knows what exactly
  540.        they do.... ;-)
  541.  
  542.  
  543.        0 - Normal play or Arpeggio
  544.  
  545.             0xy : x-first halfnote add, y-second
  546.  
  547.             Arpeggio is used to simulate chords. This is done by rapidly
  548.             changing the piych between 3 different notes.
  549.  
  550.             Example:  C-3 00 047        C-Major chord:
  551.                       (C + E + G        Or C+4+7 Halfnotes)
  552.  
  553.  
  554.        1 - Slide Up
  555.  
  556.             1xx : upspeed
  557.  
  558.             This simply slides the frequenzy up. This command is called
  559.             as many times as the speed of the song.
  560.  
  561.             Example:  C-3 00 103        1 is the command, 03 the speed
  562.  
  563.             NOTE: Because of hardware differences the Amiga has different
  564.             frequenzy divisors than the adlib. This means that sometimes
  565.             (very seldom) frequenzy slides on the Adlib sound different
  566.             than on the Amiga.
  567.  
  568.  
  569.        2 - Slide Down                                                 Page 13
  570.  
  571.             2xx : downspeed
  572.  
  573.             This simply slides the frequenzy down. This command is called
  574.             as many times as the speed of the song.
  575.  
  576.             Example:  C-3 00 203        2 is the command, 03 the speed
  577.  
  578.             NOTE: Because of hardware differences the Amiga has different
  579.             frequenzy divisors than the adlib. This means that sometimes
  580.             (very seldom) frequenzy slides on the Adlib sound different
  581.             than on the Amiga.
  582.  
  583.  
  584.        3 - Tone Portamento
  585.  
  586.             3xx : up/down speed
  587.  
  588.             Usage: Destination Note + 3 + slidespeed.
  589.  
  590.             This command will automatically slide from the old note to
  591.             the new one.
  592.             You don't have to worry about which direction to slide, you
  593.             only need to set the slide speed. To keep on sliding, just
  594.             select the command 3 + 00
  595.  
  596.             Example:  A-2 00 000        First play a note
  597.                       C-3 00 305        C-3 is the note to slide to,
  598.                                         05 is the slidespeed.
  599.  
  600.             NOTE: Because of hardware differences the Amiga has different
  601.             frequenzy divisors than the adlib. This means that sometimes
  602.             (very seldom) frequenzy slides on the Adlib sound different
  603.             than on the Amiga.
  604.  
  605.             NOTE: This command does NOT work with special arpeggio instruments.
  606.             so you'd better use commands 1 or 2 instead.
  607.  
  608.  
  609.        4 - Vibrato
  610.  
  611.            4xy : x-speed y-depth
  612.  
  613.            Example: C-3 00 481          4 is the Command, 8 is the speed
  614.                                         1 is the depth
  615.  
  616.             To keep on vibrating, just select 4 + 00. To change the vibrato
  617.             you can alter the rate, depth or both.
  618.  
  619.  
  620.        5 - Tone Portamento & Volume slide
  621.  
  622.            5xy : x-upspeed y-downspeed
  623.  
  624.            This command will continue the current portamento and slide the
  625.            volume at the same time
  626.  
  627.            Example: C-3 00 503          3 is the speed to slide volume down
  628.                     C-3 00 540          4 is the speed to slide volume up
  629.  
  630.            NOTE: This command does NOT work with special arpeggio instruments.
  631.  
  632.        6 - Vibrato & Volume slide                                     Page 14
  633.  
  634.            6xy : x-upspeed y-downspeed
  635.  
  636.            This command will continue the current vibrato and slide the
  637.            volume at the same time.
  638.  
  639.            Example: C-3 00 603          3 is the speed to slide volume down
  640.                     C-3 00 640          4 is the speed to slide volume up
  641.  
  642.  
  643.        8 - Release Sustaining Note
  644.  
  645.            8?? : no parameters
  646.  
  647.            This command releases a sustaining sound. It will then die off
  648.            at the decay rate set for the instrument.
  649.  
  650.            Example: C-3 00 800          Play C-3 and release it immediately
  651.  
  652.            The command ignores all parameters, so it's the same if you use
  653.            800 or, for example, 815. But it's recommended that set the
  654.            parameters to zero, cause I might cook up another use for this
  655.            command later....
  656.  
  657.  
  658.        A - VolumeSlide
  659.  
  660.            Axy : x-upspeed, y-downspeed
  661.  
  662.            Example: C-3 00 A03          3 is the speed to slide volume down
  663.                     C-3 00 A40          4 is the speed to slide volume up
  664.  
  665.            The slide will be called as many times as the speed of the song.
  666.            The slower the song, the more the volume will be changed on each
  667.            note.
  668.  
  669.  
  670.        B - Position Jump
  671.  
  672.            Bxx : songposition
  673.  
  674.            Example: C-3 00 B01          B is the command,
  675.                                         01 the songposition to continue at.
  676.  
  677.            This command will also perform a Patternbreak. Please remeber
  678.            that the position must be entered as hex value.
  679.  
  680.  
  681.        C - Set Volume                                                 Page 15
  682.  
  683.            Cxx : volume, 00-40
  684.  
  685.            This command sets a new volume for the instrument. The volume
  686.            is a hex number. 40hex is 63 which is the maximum volume.
  687.            However, the adlib uses a logarithmic volume control while the
  688.            Amiga uses linear control. That means that if you set the volume
  689.            to 20 on the Amiga it's exactly half of the max. volume.
  690.            With an Adlib, a volume of 20 is already hardly hearable.
  691.            Therefore it's often needed to change the volume settings if
  692.            you convert an Amiga module.
  693.  
  694.            Example: C-3 00 C10          C is the command,
  695.                                         10 is the volume (16 decimal)
  696.  
  697.            NOTE: Set Volume sets the volume for both, the carrier and the
  698.            connector. This may alter the sound!
  699.  
  700.  
  701.        D - Pattern Break
  702.  
  703.            Dxx : break position in next patt
  704.  
  705.            This command just jumps to the next song-position, and continues
  706.            to play from the patternposition you sepcify.
  707.  
  708.            Example: C-3 00 D00          Jump to the next song position and
  709.                                         continue play from pattern-line 0
  710.  
  711.                     C-3 00 D32          Jump to the next song position and
  712.                                         continue play from pattern-line 32
  713.  
  714.  
  715.        F - Set Speed
  716.  
  717.            Fxx : speed (00-1F / 42-FF)
  718.  
  719.            This command will set the speed/BPM of the song.
  720.  
  721.            Values from 00 to 1F set the Songspeed.
  722.            Values from 42 to FF set the BPM.
  723.            Speed 00 stops a song.
  724.  
  725.            NOTE: On the Amiga the BPM timing started with the value 20 instead
  726.            of 42, but due to the PC's timer chip values less than 42hex are not
  727.            possible.
  728.  
  729.  
  730.      File Format:                                                     Page 16
  731.      ------------
  732.  
  733.      Have you ever wondered how the files are built up? Well. here is the
  734.      file formats I use:
  735.  
  736.       Offset    Length (Bytes)         Description
  737.      ----------------------------------------------------------------------
  738.         0            4                 'SAdT' These for bytes mark a Song.
  739.         4            1                 Version number (currently 9)
  740.         5           465                The 31 Instruments
  741.        470          496                The 31 Instrument names
  742.        966          128                Patternorder
  743.       1094           2                 Number of Patterns (NoP)
  744.       1096           1                 Length of Song
  745.       1097           1                 Restart Position
  746.       1098           2                 BPM
  747.       1100          256                Arpeggiolist
  748.       1356          256                Arpeggiocommands
  749.       1612          576                Trackorder
  750.       2188           2                 Aktive Channels Bits: 123456789xxxxxxx
  751.       2190        ???*192              Trackdata
  752.  
  753.    Trackorder is an 64*9 array that points to the tracks.
  754.    Track 0 is a empty track (not saved).
  755.  
  756.    each track is saved as follows:
  757.  
  758.    64 lines of:
  759.       nnnnnnni iiiieeee ppppPPPP  = 3 Bytes
  760.       (where n indicates a bit for the note,
  761.              i indicates a bit for the instruments,
  762.              e indicates a bit for the effect and
  763.              p/P indicates the effect-parameter bits.)
  764.       therefore 64*3 = 192 Bytes.
  765.  
  766.  
  767.      The Instrument Format:                                           Page 17
  768.  
  769.        Offset    Length (Bytes)         Description
  770.       -----------------------------------------------------------------------
  771.          0          11                  Instrumentdata
  772.         11           4                  Arpeggiodata
  773.  
  774.      O.K. here's how the instrument data is built up:
  775.  
  776.         Byte 1:
  777.            Bit    0: Frequenzy modulation / additiv synthesis
  778.            Bits 1-3: Feedback
  779.         Byte 2:
  780.            Bits 0-3: Freq. Multiplier     ─┐
  781.            Bit    4: Scaling               │
  782.            Bit    5: Sustaining Sound      ├ Connector
  783.            Bit    6: Vibrato               │
  784.            Bit    7: Amp. Vibrato         ─┘
  785.         Byte 3:
  786.            just like Byte 2, just for the Carrier
  787.         Byte 4:
  788.            Bits 0-3: Decay Rate
  789.            Bits 4-7: Attack Rate        Connector
  790.         Byte 5
  791.            Decy, Attack Carrier
  792.         Byte 6
  793.            Bits 0-3: Release Rate
  794.            Bits 4-7: Sustain Level       Connector
  795.         Byte 7
  796.            Release, Sustain level Carrier
  797.         Byte 8
  798.            Waveform Connector
  799.         Byte 9
  800.            Waveform Carrier
  801.         Byte 10
  802.           Bits 0-5: Volume
  803.           Bits 6-7: Level Scaling Connector
  804.         Byte 11
  805.           Volume, Level Scaling Carrier
  806.  
  807.      The Arpeggiodata consists of:
  808.  
  809.        ArpeggioStart, ArpeggioSpeed, CurrentPos, SpeedCount, each value is a
  810.        byte long.
  811.  
  812.  
  813.      Last Words & Adress:                                             Page 18
  814.      --------------------
  815.  
  816.      Well. That's it
  817.  
  818.      I guess I could go on for hours and hours, but enough is enough. I
  819.      gotta walk the dog, and then I'll go to bed.
  820.      If you have any suggestions for me how to enhance this program, then
  821.      just let me know.
  822.  
  823.      I really appreciate the big feedback this program has caused. If you
  824.      have sent me a letter which I haven't answered yet, just hang on!
  825.      Thanks for supporting a lousy coder...
  826.  
  827.        signed Erik / S!P, Vienna, 4.9.1994
  828.  
  829.        Contact me:
  830.  
  831.                Erik Pojar
  832.                Siegfriedgasse 55
  833.                1210 Wien
  834.                Austria (Europe)              (Tel/Fax: +43 (1) 257 44 57)
  835.  
  836.                email: epojar@stud1.tuwien.ac.at
  837.  
  838.  
  839.