
                           Extreme's Tracker 

                                          
                                           
                                          
                                         
                                         

͸
   This is a GUS ONLY tracker. If you have another soundcard, go get a GUS!   
;

This is a quick doc of Extreme's Tracker v0.7 Beta. This release is a
SAVEABLE version, meaning you can save AMS, MOD and SMP files as many
times as you wish (v0.6 only allowed one AMS save).

If you find this beta useful, please let us know; it encourages us to
continue working hard on this program. Donations are very welcome!

The coders of this tracker (Baldric and Zyric) are very busy at the moment,
as school takes a hell of a lot of time. Consequently, we are not left with
nearly as much time as we'd like, to sit in front of our beautiful screens, 
coding this tracker.

Happy composing,

Baldric/EXTREME




This small doc is divided into the following parts:


 * Keys
 * Summary of features
 * New Commands
 * News
 * Info
 * Trouble Shooting
 * Known bugs
 * Tips
 * Future
 * Contact
 * Credits

 Keys 

These are the keys supported in the tracker: (I may have forgotten some...)


      F1        -       Decrease Octave
      F2        -       Increase Octave

Shift F3        -       Cut Channel to buffer
Ctrl  F3        -       Cut Commands to buffer
Alt   F3        -       Cut Pattern to buffer

Shift F4        -       Copy Channel to buffer
Ctrl  F4        -       Copy Commands to buffer
Alt   F4        -       Copy Pattern to buffer

Shift F5        -       Paste Channel-buffer to Channel
Ctrl  F5        -       Paste Command-buffer to Channel
Alt   F5        -       Paste Pattern-buffer to pattern

      F6-F10    -       Go to the stored patternposition
Shift F6-F10    -       Store current patternposition on selected F-key
Alt   F6-F10    -       Play pattern from the stored patternposition
Ctrl  F6-F10    -       Record from the stored patternposition

      Del       -       Delete note under cursor
Shift Del       -       Delete note+command under cursor
Alt   Del       -       Delete command under cursor

Shift Return/
      Ins       -       Insert blank note at cursorposition and move the others
                        down. Notes beyond patternposition 63 will be lost!
Shift Backsp/
Shift Ins       -       Delete note above cursorposition and move the others up.
                        You can NOT do this if you're at patternposition 0!

Alt   Return    -       As above, but with pattern
Alt   Backspace -       As above, but with pattern
 
Ctrl  Return    -       Push cmds one down
Ctrl  Backspace -       Drag cmds one up

Shift 0-9       -       Store current command on selected key
Alt   0-9       -       Insert all commands in current track
Ctrl  0-9       -       Insert one command in current track

Alt   ,         -       Copy all commands above cursor to current row.
Alt   .         -       Copy all commands above cursor to current row
                        and add one to the value.
Alt   -         -       Copy all commands above cursor to current row
                        and subract one from the value.

Ctrl  ,         -       Copy command above cursor to current row
Ctrl  .         -       Copy command above cursor to current row
                        and add one to the value.
Ctrl  -         -       Copy command above cursor to current row
                        and subract one from the value.

Ctrl  A         -       Mute/Unmute current channel
Ctrl  B         -       Mark Block Beg
Ctrl  C         -       Copy from BlockBeg to CursorPos, Move to buffer
Ctrl  D         -       Delete block, drag notes up
Ctrl  E         -       Increase CommandNr on current channel
Ctrl  I         -       Insert block, push notes down
Ctrl  K         -       Kill rest of channel
Ctrl  M         -       Ramp command data from Blockbeg to CursorPos.
Ctrl  N         -       Re-mark last block
Ctrl  O         -       Contract Channel
Ctrl  P         -       Paste BlockBuffert To CursorPosition
Ctrl  Q         -       Unmute all channels
Ctrl  R         -       Restore F6-F10 positions (0,16,32,48,63)
Ctrl  S         -       Solo channel (Mute all except current channel)
Ctrl  U         -       Expand Channel
Ctrl  W         -       Decrease CommandNr on current channel
Ctrl  X         -       Cut from BlockBeg to CursorPos, Move to buffer

Alt   C         -       Go to Config Screen.
Alt   D         -       Go to Disk Option.
Alt   E         -       Go to Descriprion Editor.
Alt   K         -       Kill current sample in current channel
Alt   O         -       Contract Pattern
Alt   P         -       Go to Position Editor.
Alt   S         -       Go to Sample Editor.
Alt   U         -       Expand Pattern
Alt   Z         -       Zoom/Unzoom pattern

Shift ArrLeft   -       Decrease Current Position
Shift ArrRight  -       Increase Current Position
Ctrl  ArrLeft   -       Decrease Current Sample
Ctrl  ArrRight  -       Increase Current Sample
Alt   ArrLeft   -       Decrease Current Pattern
Alt   ArrRight  -       Increase Current Pattern

      Home      -       1 press: Go to first row. 2 press: Go to first channel

       End      -       Go to last row

      Space     -       Toggle edit. Stop all voices

    Keypad Del  -       Kill Sample

      Enter     -       Play Current row, advance

      Backspc   -       Play Current row, don't advance

      Arrows    -       Move around in the patterndata

      Esc       -       PullDownMenu

      Tab       -       Next Channel
Shift Tab       -       Prev Channel

Right Ctrl      -       Play Mod
Right Alt       -       Play Pattern
Right Shift     -       Record Pattern

Ctrl  Ctrl      -       Play Mod from current row
Ctrl  Alt       -       Play Pattern from current row
Ctrl  Shift     -       Record Pattern from current row

PGUP            -       Move 8 notes up
PGDN            -       Move 8 notes Down

<               -       Increase RowAdder
>               -       Decrease RowAdder


 Transpose:
 

 <CAPS LOCK> Plus keys below:

   Sample/Track        Sample/Pattern     All/Track           All/Pattern
   ----------------------------------     -------------------------------
   1 - Note Up         2 - Note Up        3 - Note Up         4 - Note Up
   Q - Note Down       W - Note Down      E - Note Down       R - Note Down
   A - Octave Up       S - Octave Up      D - Octave Up       F - Octave Up
   Z - Octave Down     X - Octave Down    C - Octave Down     V - Octave Down


 Select Samples With Numeric KeyBoard:

          0 - Select Sample 0
    1st row - Select Sample 1-4
    2nd row - Select Sample 5-8
    3rd row - Select Sample 9-C
    4th row - Select Sample D-F

Pressing a shift key simultanious with above:
         <CAPS LOCK> Sample 10-1F
         <SHIFT>     Sample 20-2F
         <CONTROL>   Sample 30-3F
         <ALT>       Sample 40-4F


 Summary of features 

To give you a small taste of what Extreme's Tracker is capable of, we present a
little list of features that become available to you when using this program:

   * 32 GUS Channels
   * 255 Samples
   * 65536 Patterns
   * 65536 Positions
   * 7 Commands on each note
   * 8 Octaves
   * Separate panpot for each sample
   * Variable C-2 frequency for each sample
   * More Effect Commands 
   * Packed patterndata and samples
   * Configurable to match FastTracker/ScreamTracker/Protracker etc standards
   * Over 50 different options in the config.
   * All key shortcuts are reconfigurable
   * Longer samplenames/songname
   * Separate names on each channel and each pattern for easier identification
   * Special Module Description Editor for entering long descriptions of
     your music tune
   * Sample Editor
   * Position Editor
   * Advanced Split Keyboard Feature
   * MIDI styled keyboard (let's you press several keys simultaniously)
   * Loads AMS, MOD, S3M, STM, IFF, SMP and DP3
   * And of course alot more for you to discover!


 New Commands 

 8 0x    PanPosition (0-f)
E8 00    Break SampleLoop
10 00    Play Sample Forwards
10 01    Play Sample BackWards
10 02    Enable Bidirectional Loop (only on looped samples)
11 xx    Extra Fine Slide Up (4 times finer than normal)
12 xx    Extra Fine Slide Down (4 times finer than normal)
13 xy    Retrig with volslide (compare with E9)
         The x value tells if there should be a volumeslide between the retrigs.
           0: 0    (No volumeslide)           8: 0 (No volumeslide)
           1: -1                              9: +1
           2: -2                              A: +2
           3: -4                              B: +4
           4: -8                              C: +8
           5: -16                             D: +16
           6: 2/3 times the original volume   E: 3/2 times the original volume
           7: 1/2 times the original volume   F: 2 times the original volume
15 xx   Just Like 5, but with 2 times finer volslide.
16 xx   Just Like 6, but with 2 times finer volslide.
1A xx   2 times finer volslide than A.
1E 1x   Just like E1, but this uses all octaves.
1E 2x   Just like E2, but this uses all octaves.
1E Ax   2 times Finer volslide than EA.
1E Bx   2 times Finer volslide than EB.
21 xx   Just like 1, but this uses all octaves.
22 xx   Just like 2, but this uses all octaves.

 News 

 * Extreme's Current Memberlist is:

 Coders:
   Baldric
   LEV
   Zyric

 Musicians:
   Gibson
   MPS
   ToneDeaf

 Graphicians:
   Gibson
   Mikie
   TAP

 Sysop:
   Ivanhoe


 Info 

   This tracker is coded in 100% assembly and it runs under TRAN'S Pmode 2.5.
   It contains over 40,000 lines of source code.


 Trouble Shooting 

Problem:
        You get FATAL IRQ messages when loading/saving a tune.
Solution:
      * Change IRQ and/or DMA channel in the config
      * Disable DMA transfer in the config.
        (IRQ errors may disappear if you restart the tracker...)


Problem:
        The graphics looks weird somewhere in the tracker, or the update is
        very slow.
Solution:
      * Unload all TSR programs that may affect the graphics (try a clean boot)
      * Buy a faster Graphics card (if update is slow)
      * If it still doesn't look good, contact the programmers!


Problem:
        The tracker won't work or behaves very unstable under DPMI.
Solution:
      * There may be weird problems under some DPMIs.  Many DPMI drivers out
        there are anywhere from a little to extremely buggy.  If you suspect
        your DPMI driver, try running without it, or under a different DPMI
        driver.

Problem:
        The QEMM's Stealth function doesn't seem to work with the tracker.
Solution:
      * Remove the Stealth feature, or run another Memory manager.

Problem:
        I can't increase some of the memory settings in the config.
Solution:
      * The memory allocation routines are "smart" so you cannot increase more
        than you have available memory. Try to decrease some other setting and
        then try again.


If something else fails, try to remove the configfile and run again!


If you have any other problems, contact Baldric!


 Known Bugs 

   The dragbar routine calculation is not correct when using many
   channels in zoom mode.

   The sample function is NOT fully tested yet, and may behave weird.

   The MIDI function may behave strange at startup sometimes. That's because I
   haven't figured out how to send commands to the MIDI port yet (I know how to
   do it, but it doesn't work) So the tracker may not know what state the MIDI-
   device is in.

 Tips 

 * If you don't like the graphics in the tracker, you can change it to a plain
   background in the config under "colors". Lower the marble's "(I)ntensity"
   using the dragbar!

 * Check out the <config> <options> carefully! There are a lot of switches to
   satisfy your needs. (If anything annoys you in the tracker, check the
   config. There may be a switch for it. If not, contact Extreme and we will
   consider adding it in the next version.)


 Future 

What's planned in the next major release? (0.8) Well, there are some
enhancements we are going to include. First of all, an instrument editor,
like in FT2 but better. We're gonna include user defined patternlength, XM/XS
support, more config options, more samp.ed functions. etc.


 Contact 

Comments, Ideas, Suggestions, Anything:


Baldric (Patrik Oscarsson)
   Bondstorps Wrdshus
      562 91 Mnsarp
          Sweden

  Voice: +46(0)393-40012
  E-Mail: da94ospa@hj.se

 Credits 

Code:
 Baldric & Zyric
Graphics:
 TAP,Zyric,Rubber Duck,Baldric
Music: (the included tune)
 MPS

Guys to Thank (A-Z): (If I've forgotten someone, SORRY and let me know!!!)

Adam Seychell - GUS IRQ/DMA info
Andreas Wessman - Ideas, Bugtesting, MIDI info.
Daniel Falk, a.k.a Leinad - BugTesting, Ideas.
Emil Gustavsson - Bugtesting
Joshua C Jensen - Some info on commands
MPS/Extreme - Bugtesting
Marc Brown, a.k.a Maruku - Bugtesting, many useful ideas.
Michiel Ouwehand - GUS ClickRemoval dox
Mr Destroyer - GUS info
Thomas Pytel, a.k.a TRAN - Protected Mode Header
ToneDeaf/Extreme - Ideas, Great bugtesting!
Vicious - Ideas, Bugtesting, Info on PT commands and PT in general.

