home *** CD-ROM | disk | FTP | other *** search
/ Large Pack of OldSkool DOS MOD Trackers / it209.zip / IT.DOC < prev    next >
Text File  |  1996-12-02  |  109KB  |  2,129 lines
  1.  
  2.  
  3. .  ..s..s.s.ssss.
  4. :  ::$::$:$:$$$$$
  5. `  ``²``²`²`²²²²'.$$$     .$$$ $$$$$$$$$$ .$$$   .$$ .$$$ .$$$$$$$$$$ .$$$$$$$$
  6.    .  . . .$$$$ .$$$$    .$$$$ $$$   .$$'.$$$'  .$$'.$$$'.$$$$'  .$$'.$$$' .$$'
  7.   .  . . .$$$$'.$$$$$   .$$'.$ $$$  .$$'.$$$'  .$$'.$$$'.$$$$'  .$$'.$$$' .$$'
  8.  .  . . .$$$$'.$$$$'$  .$$'.$$ $$$ .$$'.$$$'  .$$'.$$$'.$$$$'      .$$$'
  9. .  . . .$$$$'.$$$$'.$ .$$' $$$ $$$$$$'.$$$'  .$$'.$$$' $$$$$$$$$$'.$$$$$'
  10.   . . .$$$$'.$$$$' $$.$$'  $$$ $$$   .$$$'  .$$'.$$$'        .$$'.$$$'  ..
  11.  . . .$$$$'.$$$$'  $$$$'   $$$ $$$  .$$$'  .$$'.$$$'   .$   .$$'.$$$' .$$'
  12. . . .$$$$'.$$$$'   $$$'    $$$ $$$ .$$$'  .$$'.$$$'   .$$  .$$'.$$$' .$$'
  13.  . .$$$$'.$$$$'    $$'     $$$ $$$ $$$$$$$$$' $$$$$$$$$$$ $$$'.$$$$$$$$' .cC!
  14.  
  15.         ..                                                           ..
  16.     .s$$$$$. .sssssssssssssssssssssssssssssssssssssssssssssssssss. .$$$$$s.
  17.    `$$.  `$$.   .ssss. .ssss. .ssss. .sss. .s  ss .sss. .ssss.    .$$'  .$$'
  18.     `$$   `$$   ²ss.`$ $. ``$ $' .$$ $. `$ $$.s²' $. `$ $. ``$    $$'   $$'
  19.   ds.`$ ds.`$     $$ ' $$ss²' $ss²$$ $$    $$S    $$²   $$ss²'    $'.sb $'.sb
  20.  $$$$.$ $$$.$     $$   $$`²s. $   $$ $$..$ $$`²s. $$..$ $$`²s.    $.$$$ $.$$$$
  21.  Y$$$$'.$$$$'.cC! ²²   ²²  ²² ²   ²² `²²²' ²²  ²² `²²²' ²²  ²²    `$$$$.`$$$$Y
  22.   `²'   `²'  `²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²²'  `²'   `²'
  23.      
  24.  
  25.                                  User's Manual
  26.  
  27.  
  28.  
  29.  1. Introduction
  30.   1.1  What is Impulse Tracker?
  31.   1.2  About Impulse Tracker
  32.   1.3  Running Impulse Tracker
  33.   1.4  Technical information about Impulse Tracker
  34.  
  35.  2. Using Impulse Tracker
  36.   2.1  Playing songs
  37.   2.2  Pattern editor
  38.   2.3  Order list, channel panning & volume
  39.   2.4  Samples
  40.   2.4.1 Information about samples
  41.   2.4.2 Sample functions
  42.   2.5  Instruments
  43.   2.6  Song Variables
  44.   2.7  Hey! This program looks like Scream Tracker 3!!!
  45.   2.8  Gravis UltraSound users.
  46.  
  47.  3. Before you write to me (Important notes)
  48.  
  49.  4. For the software programmers & hardware manufacturers
  50.  
  51.  5. Closing words
  52.  
  53.  6. How to get the latest version of Impulse Tracker
  54.  
  55.  7. Legal stuff
  56.  
  57.  
  58.  1. Introduction
  59.         If you are familiar with tracker programs, then you could probably
  60.         skip through most of this document. (I strongly suggest that ANYONE
  61.         print out SUMMARY.DOC though, for a list of effects and editing
  62.         commands.) For those of you who have had experience with Scream
  63.         Tracker 3, read section 2.7. This should detail most of the major
  64.         differences between Scream Tracker 3 and Impulse Tracker. For those
  65.         of you who are unfamiliar with tracker programs it would probably be
  66.         best to print out this document, and then refer to it as you work
  67.         with the program.
  68.  
  69.         Check out the file UPDATE.DOC. If this document contains conflicting
  70.         information with what's listed in UPDATE.DOC, then follow what
  71.         UPDATE.DOC contains, as I may have forgotten to update this text.
  72.  
  73.   1.1  What is Impulse Tracker?
  74.         Impulse Tracker is a program used to create high quality music
  75.         without the requirements of specialised, expensive equipment. The
  76.         hardware requirements should be easily met: Any IBM 386+ compatible
  77.         computer (although a 486+ is recommended), and a VGA or higher video
  78.         card. If you want to hear sound, you'll need one of the following:
  79.  
  80.             ■ Sound Blaster 1.xx, 2.xx (8 bit, mono)
  81.             ■ Sound Blaster Pro, 16 (16 bit, stereo)
  82.             ■ Sound Blaster AWE 32 (16 bit, stereo, hardware mixing)
  83.             ■ Pro Audio Spectrum (8 bit, stereo)
  84.             ■ Pro Audio Spectrum 16 (16 bit, stereo)
  85.             ■ Windows Sound System card (16 bit, stereo)
  86.             ■ Gravis UltraSound (16 bit, stereo, hardware mixing)
  87.             ■ Interwave based board (eg. GUS PnP, WAVExtreme 32, Dynasonix Pro
  88.                                      16 bit, stereo, hardware mixing)
  89.             ■ DAC on LPT1/LPT2 (8 bit, mono)
  90.             ■ PC Speaker (very final option, not recommended)
  91.  
  92.         Note that stereo effects (including surround sound) can only be
  93.         experienced on software mixed stereo cards. Hardware mixed soundcards
  94.         support panning, but do not support surround sound.
  95.  
  96.         You'll need about 500k of conventional memory to get the program
  97.         running - about 600k to have it load almost any song (as long as you
  98.         have an EMM driver - samples are stored in EMS when possible, otherwise
  99.         the songs that you are able to load will be limited even further!).
  100.         If you use EMM386.EXE, add "H=255" at the end of it to prevent
  101.         "Out of memory" messages when you still have EMS remaining. If
  102.         you're using some other memory manager, check it's documentation
  103.         to see how to increase the number of "memory handles".
  104.  
  105.         Impulse Tracker supports direct control over 64 channels, and can
  106.         load and play the following formats: S3M, MTM, MOD and of course,
  107.         IT. At the moment, modules can only be saved in the IT and S3M
  108.         formats.
  109.  
  110.         The number of channels playable on hardware mixed soundcards is
  111.         limited by the hardware. Check DRIVERS.DOC for specific details
  112.         on your soundcard hardware.
  113.  
  114.         The Gravis UltraSound can only play 32 channels, although this
  115.         shouldn't be too much of a limitation. Note that if you put notes
  116.         in channels 33->64 in sample mode using a Gravis, you WILL NOT hear
  117.         these notes! (There's an explanation of sample mode much later on,
  118.         just keep it in mind if you own a Gravis UltraSound - it shouldn't
  119.         cause any problems.) The same restriction applies for the Sound
  120.         Blaster AWE 32, but to 30 channels. (ie. notes in channels 31->64
  121.         will not cause any sound)
  122.  
  123.  
  124.   1.2  About Impulse Tracker.
  125.         Impulse Tracker began simply as an extension to Scream Tracker 3
  126.         (which should be quite obvious to Scream Tracker 3 users, due to
  127.         the interface.) At first, I only intended a couple of extra
  128.         features (eg. proper panning and a couple of other interesting
  129.         functions), but with the release of Fast Tracker 2, it became obvious
  130.         that there were many areas in which Scream Tracker could be improved.
  131.         In spite of all the limitations of Scream Tracker 3 (in comparison
  132.         to Fast Tracker 2, which offered Volume/Panning Envelopes, 16-bit
  133.         samples, Samples > 64k, an in built sampler, proper stereo panning
  134.         on SB16, etc. etc), there were still more .S3M releases than there
  135.         were .XM releases! And the reason must have been within the way
  136.         you WRITE music with Scream Tracker 3. That's why I've used the same
  137.         simple and QUICK interface that Scream Tracker 3 offered. And I've
  138.         tried to provide some of the power of Fast Tracker 2 - Read about the
  139.         power that you can have with the use of instruments in section 2.5
  140.  
  141.         The Tracker was written in 100% Assembler. All the routines are of
  142.         my own coding (That's why some of them suck so much :) ).
  143.         The program was written on and off during 1995, but most of the
  144.         work was completed in the summer holidays of '96. The source code
  145.         is over 100,000 lines long and occupies over 3MB. The Tracker runs
  146.         entirely in text mode (!) with some neat remapping of characters
  147.         (that's why I haven't been able to use colours to help in some places
  148.         ie. making the volume envelope nodes a different colour would have
  149.         made it easier to use!).
  150.  
  151.   1.3  Running Impulse Tracker.
  152.  
  153.         Impulse Tracker uses EMS. If you want to be able to load large songs,
  154.         you need the following lines in your CONFIG.SYS file (on your boot
  155.         drive)
  156.  
  157.                 DEVICE=<path>\HIMEM.SYS
  158.                 DEVICE=<path>\EMM386.EXE RAM H=255
  159.  
  160.         eg. if the files are in your C:\DOS directory, you need this:
  161.  
  162.                 DEVICE=C:\DOS\HIMEM.SYS
  163.                 DEVICE=C:\DOS\EMM386.EXE RAM H=255
  164.  
  165.  
  166.         If you use QEMM, use the following line instead:
  167.  
  168.                 DEVICE=<path>\QEMM.SYS DMA=64, HANDLES=255
  169.  
  170.         If you want to run Impulse Tracker in Windows 95, check out WIN95.DOC
  171.  
  172.         To find out details about the driver for your soundcard, check through
  173.         DRIVERS.DOC.
  174.  
  175.         Most users should not require any command line switches, however
  176.         the following are available:
  177.  
  178.           SFilename.Drv - Sets sound driver to use. eg. IT /sITIW.DRV
  179.                           this may become necessary as new sound drivers
  180.                           are released.
  181.  
  182.           S#      Set sound card
  183.                    S0 = No sound card (silent mode)
  184.                    S1 = PC Speaker
  185.                    S2 = Sound Blaster
  186.                    S3 = Sound Blaster 2
  187.                    S4 = Sound Blaster Pro
  188.                    S5 = Sound Blaster 16
  189.                    S6 = Sound Blaster AWE 32
  190.                    S7 = Gravis UltraSound
  191.                    S8 = Interwave
  192.                    S9 = Pro Audio Spectrum
  193.                    S10 = Pro Audio Spectrum 16
  194.  
  195.                   If this parameter is omitted, then a (hardware) detection
  196.                   routine is used. Check DRIVERS.DOC for specific information
  197.                   on the various drivers.
  198.  
  199.           Axxx    Set Base Address of sound card (hex)
  200.           D#      Set DMA of sound card (decimal)
  201.           I##     Set IRQ of sound card (decimal)
  202.  
  203.           M#####  Set Mixspeed. Values are accepted between 0->65535,
  204.                   however, the soundcards have hardware limits which will
  205.                   override the command line switch. Again, check DRIVERS.DOC
  206.                   for specific information on your sound driver.
  207.  
  208.           L###    Limit number of active channels
  209.  
  210.                   When you limit the number of channels, you are limiting the
  211.                   number of notes that you can hear on playback. In a "Sample"
  212.                   controlled song (explained later), the result is that if you
  213.                   play a 16 channel piece with the limit at 4 channels, then
  214.                   you will lose the last 12 channels! Even if the first 4
  215.                   are not playing anything. In an instrument controlled song,
  216.                   the result is that you will hear 4 notes at most, which can
  217.                   be controlled from any of the 64 channels, excess notes will
  218.                   be lost. (The reason for this is within the channel
  219.                   allocation routines.)
  220.  
  221.                   Note that the Gravis UltraSound cannot play more than 32
  222.                   channels. If you limit the number of channels to a lower
  223.                   value, the quality of the output will increase. (This is
  224.                   due to the nature of the card - all the sound processing
  225.                   is done BY the card, so you could have 32 channels on
  226.                   any processor).
  227.  
  228.                   If you are new to tracking and didn't understand what I was
  229.                   just talking about, hilight this section with a marker
  230.                   (you've printed this out, right?), and in your dabblings,
  231.                   if you notice that some notes aren't being played, reread
  232.                   this section. It should make sense by then, and the reason
  233.                   hopefully lies in the above paragraphs.
  234.  
  235.           V1      Override VGA detection routine.. in case you DO have a
  236.                   VGA and the program doesn't recognise it.
  237.  
  238.           V2      Use this switch if you get garbled stuff appearing on your
  239.                   screen (mainly matrox users)
  240.  
  241.           R       Reverse stereo channels.
  242.                   This is only really useful on the SB16. (Swaps left/right
  243.                   outputs). The Sound Blaster Pro stereo setting routines
  244.                   aren't accurate, and will sometimes set the left to left
  245.                   and right to right (how it's supposed to be), and
  246.                   sometimes set the left to right and right to left (how
  247.                   it's not supposed to be :) ).
  248.  
  249.           C       Control playback in DOS Shell.
  250.                   When this option is on, the following keys will operate
  251.                   within the DOS Shell:
  252.  
  253.                    Right-Alt:   Stop playback
  254.                    Right-Ctrl:  Play song (if not already playing)
  255.                    Grey Plus:   Increase global volume
  256.                    Grey Minus:  Decrease global volume
  257.  
  258.                   Warning: There are problems on some computers with this
  259.                            enabled! If your keboard locks up, it may be
  260.                            necessary to press the left ctrl/alt to "unfreeze"
  261.                            it... sometimes (other times.. I don't know!)
  262.  
  263.          F        Disable file colour distinctions.
  264.                   When this is on, all file colours will appear the same as
  265.                   the background colour. This is just to make it easier to
  266.                   redo the palette to your liking more easily.
  267.  
  268.   1.4 Technical Information
  269.  
  270.         Formats supported
  271.           Modules:
  272.             MOD (M.K., M!K!, 4CHN, 6CHN, 8CHN, xxCH, FLT4, FLT8)
  273.             MTM (MMEdit files)
  274.             S3M (Scream Tracker 3 files)
  275.             XM  (Fast Tracker 2 files)
  276.             IT  (Impulse Tracker 1.xx, Impulse Tracker 2.xx files)
  277.  
  278.           Samples:
  279.             S3I (Scream tracker sample, 8 bit or 16 bit)
  280.             IFF (Fast tracker 2 sample, 8 bit or 16 bit)
  281.             WAV (Microsoft WAV, 8 bit or 16 bit)
  282.             Wxx (TX Wave format samples)
  283.             ITS (Impulse tracker sample, 8 bit or 16 bit)
  284.             RAW (Raw sample information, assumed 8 bit)
  285.             MOD (Samples from almost all .MOD formats)
  286.             PTM (Samples from Poly Tracker modules)
  287.             669 (Samples from 669 and 669 Enhanced modules)
  288.             FAR (Samples from Farandole composer modules)
  289.             MTM (Samples from MMEdit modules)
  290.             S3M (Samples from Scream Tracker 3 modules)
  291.             XM  (Samples from Fast Tracker 2 modules)
  292.             IT  (Samples from Impulse Tracker 1.xx, 2.xx modules)
  293.  
  294.           Instruments:
  295.             XI  (Instruments from Fast Tracker 2)
  296.             ITI (Instruments from Impulse Tracker)
  297.             XM  (Instruments from Fast Tracker 2 modules)
  298.             IT  (Instruments from Impulse Tracker 1.xx, 2.xx modules)
  299.  
  300.         Modules
  301.           99 Samples maximum
  302.           99 Instruments maximum
  303.          200 Patterns maximum (from 32-200 rows per pattern)
  304.          256 Orders maximum
  305.           64 Channels under direct control
  306.          256 Channels maximum for virtual control (64 max default)
  307.  
  308.         Samples
  309.           8/16 bit samples
  310.           Maximum size around 4MB
  311.           No Loop/Forwards/Ping pong loop
  312.  
  313.         Instruments
  314.           25-point Volume/Panning/Pitch envelope
  315.           Default pan for instruments (optional)
  316.           Pitch pan separation
  317.           Virtual controls (*REALLY* worth understanding)
  318.  
  319.  
  320.  2. Using Impulse Tracker
  321.         Before any specific details of how to use the tracker, it may be
  322.         worth knowing these few "editing" keys:
  323.  
  324.       When using Thumbbars.
  325.        Pressing Left and Right arrows will shift the values left/right
  326.        Holding down Ctrl while pressing left/right will move them quicker
  327.        And Shift-Left/Right will move them even quicker....
  328.        But just typing in a number will get you directly to the desired point!
  329.  
  330.       String (text) entry.
  331.        Nothing special here (and the routines need to be rewritten), but
  332.        pressing Ctrl-Backspace will clear the entire text..
  333.  
  334.       Numerical entries (of the 7 digit or 3 digit variety)
  335.        Pressing '+' or '-' will increase/decrease the value by 1. This is
  336.        especially useful when modifying loop values.
  337.  
  338.   2.1  Playing songs
  339.         If you are like most of us, you would have run the program first,
  340.         and probably figured out how to do this yourself. Songs are simply
  341.         loaded by pressing F9 at any time (to invoke the file load menu)
  342.         and then selecting a song by pressing Enter. You can also type the
  343.         first few characters of a filename, and a "search" will be made for
  344.         the first match.
  345.  
  346.         Note that on all the file menus in Impulse Tracker, you can also
  347.         delete files by pressing Delete.
  348.  
  349.         After loading a song, use F5 to play it and F8 to stop. The Info
  350.         Page should appear, and you can cycle through views using
  351.         PgUp/PgDn. Separate view windows can be created by pressing Insert
  352.         (and removed by pressing delete) and these separate windows can
  353.         each have a different view method.
  354.  
  355.         Details (ranges follow in brackets):
  356.          Frequency - the speed (pitch) at which the sample is played in
  357.                      samples per second
  358.          Position  - the offset in a sample (in bytes)
  359.          Smp       - The sample currently being played (1->99)
  360.          FVl       - The final volume of the sample, taking into account
  361.                      all the scaling factors (viz global volume, sample vol,
  362.                      envelope volume, channel volume and fadeout) (0->128)
  363.          CV        - Channel volume (0->64)
  364.          SV        - Sample volume (0->64)
  365.          VE        - Envelope volume (0->64)
  366.          Fde       - Fadeout component (0->512)
  367.          Pn        - Panning (0->64, Su = surround)
  368.          PE        - Panning envelope value (0->32)
  369.          NNA       - The current NNA (Cut/Con/Off/Fde)
  370.          Tot       - The total number of active virtual channels 'owned' by
  371.                      the channel
  372.  
  373.         If you're looking for some songs to play, check out the following
  374.         places:
  375.          ftp.cdrom.com/pub/demos/music [huge collection!]
  376.           for .IT files, go to ftp.cdrom.com/pub/demos/music/songs/1996/it
  377.  
  378.         Let me know of any other good music module distribution sites, so
  379.         that I can include them here!
  380.  
  381.   2.2  Pattern editor (F2)
  382.         The pattern editor allows you to edit patterns. For those of you
  383.         who are familiar with music, patterns can be thought of as "bars",
  384.         and the order in which these "bars" are played is determined by
  385.         order list. For those of you who are not familiar with music,
  386.         consider patterns as a collection of notes. Impulse Tracker
  387.         supports up to 200 different patterns - it *IS* quite a lot more
  388.         than it may initially sound!
  389.  
  390.         Each pattern can range in length between 32 and 200 rows. You can
  391.         change this value by using the "Pattern Editor Configuration" screen by
  392.         pressing F2 when alredy in the Pattern Editor. The other options
  393.         available are the base octave (explained later), the skip value (also
  394.         explained later), the row hilight major and minor (which determines
  395.         the distance between the emphasized rows) and the command/commandvalue
  396.         link/split option, which determines whether when editing, the cursor
  397.         should move downwards when entering an effect, or across to the
  398.         effect value columns.
  399.  
  400.         The pattern editor appears normally as 5 'channel' columns as such:
  401.  
  402.         ┌─────────────┬─────────────┬─────────────┬─────────────┬─────────────┐
  403.         │C-5 01 23 A02│E-5 02 64 D01│∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│
  404.         │∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│
  405.         │∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│
  406.         │∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│
  407.         │∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│
  408.         │∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│∙∙∙ ∙∙ ∙∙ .00│
  409.                         ^   ^  ^  ^
  410.      Component Columns: 1   2  3  4
  411.  
  412.         What the component columns mean:
  413.          1) The first column contains the note and octave of the note.
  414.             Notes are entered by using the keyboard as such:
  415.  
  416.     (Note)         C# D#    F# G# A#    C# D#    F# G# A#    C# D#
  417.                 │ │ ││ │ │ │ ││ ││ │ │ │ ││ │ │ │ ││ ││ │ │ │ ││ │ │
  418.                 │ │ ││ │ │ │ ││ ││ │ │ │ ││ │ │ │ ││ ││ │ │ │ ││ │ │
  419.     (What you   │ │S││D│ │ │G││H││J│ │ │2││3│ │ │5││6││7│ │ │9││0│ │
  420.      type)      │ └┬┘└┬┘ │ └┬┘└┬┘└┬┘ │ └┬┘└┬┘ │ └┬┘└┬┘└┬┘ │ └┬┘└┬┘ │
  421.                 │ Z│ X│ C│ V│ B│ N│ M│ Q│ W│ E│ R│ T│ Y│ U│ I│ O│ P│
  422.                 └──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┘
  423.     (Note)        C  D  E  F  G  A  B  C  D  E  F  G  A  B  C  D  E
  424.                  (Octave 0)           (Octave 1)           (Octave 2)
  425.  
  426.             (For those of you with AZERTY keyboards, you will find that
  427.              the keys should work as positioned on the keyboard, rather
  428.              than having to figure out QWERTY equivalents)
  429.  
  430.             The octave of the note is determined by adding the BaseOctave
  431.             to the Octave of the note played. The BaseOctave can be
  432.             adjusted by pressing the Grey keys '/' or '*' or using
  433.             Ctrl-Up Arrow or Ctrl-Down Arrow.
  434.  
  435.             The range of notes is from C-0 to B-9. The 'middle' note is
  436.             considered as C-5
  437.  
  438.             Pressing '1' on the note column will enter a notecut command.
  439.             This causes any note in the column to immediately stop.
  440.  
  441.             Pressing '`' (the note below ESC) on the note colume will enter a
  442.             noteoff command. This causes all sustain points to be released
  443.             (Explained in samples and instruments in more detail.)
  444.  
  445.             At the bottom of the channel is an 'edit mask'. This highlights
  446.             what will be affected when you type anything in. Note that
  447.             typing a note in can affect more than just a note - normally
  448.             it's set to enter an instrument and volume with it! You can easily
  449.             tell IT to enter an effect with it also by changing the
  450.             channel mask with ',' (comma) on columns 2, 3 and 4.
  451.  
  452.                 Examples of interpretation:
  453.  
  454.                 │C-4 01 ∙∙ .∙∙│ - will play note C octave 4, instrument 1
  455.                 │D-4 ∙∙ ∙∙ .∙∙│ - will play note D, octave 4, instrument 1
  456.                 │∙∙∙ 02 ∙∙ .∙∙│ - Will play note D, octave 4, instrument 2
  457.                 │E-4 ∙∙ ∙∙ .∙∙│ - will play note E, octave 4, instrument 2
  458.                 │G-6 12 ∙∙ .∙∙│ - will play note G, octave 6, instrument 12
  459.  
  460.          2) The second column contains the sample/instrument, depending on
  461.             whether the tracker is operating in sample mode, or instrument
  462.             mode. Valid ranges are from 01->99 (decimal).
  463.  
  464.          3) The third column contains the volume or panning of the note.
  465.             To toggle between entry of volumes and panning, press '`'
  466.  
  467.             Volumes.
  468.             0 is the softest (ie. nothing) and 64 (decimal!) is the loudest.
  469.             If no volume is specified, then the default volume for the sample
  470.             is used. (Note that effects *CANNOT* raise the volume above 64)
  471.  
  472.             The volume scale works linearly - ie. one note played at a
  473.             volume of 64 will be the same 'loudness' as 4 of the same note,
  474.             one played at a volume of 10, another at a volume of 30,
  475.             another at a volume of 20 and another at a volume of 4.
  476.              (10+30+20+4 = 64)
  477.             But if you have a choice, always go for the single note (it
  478.             will require less processing (occupy less channels), and also
  479.             sound better in quality, due to roundings that occur in processing
  480.             softer volumes).
  481.  
  482.             Panning.
  483.             Panning controls appear in a different colour to the volume
  484.             controls. For panning in this column, 0 represents far left, and
  485.             64 represents far right. If you have an Xxx effect at the same
  486.             time, the Xxx will take precedence over this column.
  487.  
  488.             It is more efficient filesize-wise to use a panning control in
  489.             this column rather than in the effect column.
  490.  
  491.             Volume, Panning & Effect??
  492.             OK. So you want to do something tricky. Well, it's possible to
  493.             get all 3 of these how you want with a little meddling with
  494.             the channel volume control - just place one before the row with
  495.             an appropriate value (remember that the range is 0->40 HEX) such
  496.             that the channel volume scales the default volume to the desired
  497.             value.... What I mean is that if you want to play a note at volume
  498.             32, pan 48, with vibrato H81, then you can do the following:
  499.  
  500.                 │∙∙∙ ∙∙ ∙∙ M20│ - Set channel volume to HALF.
  501.                 │C-4 01 48 H81│ - The 48 is a pan command - this assumes that
  502.                                   the default volume for sample/instrument 1
  503.                                   is 64.
  504.  
  505.          4) The final column contains effect data. For those of you who are
  506.             just starting, I would advise you to leave this section until
  507.             later, when you have already dabbled with entering notes, and
  508.             want some special features. It's easy to get caught up with all
  509.             these special features and you can 'overdo' the effects.
  510.             And it will sound absolutely pathetic. Trust me, I know -
  511.             I've done it :)
  512.  
  513.             Effects are entered by typing 'a'-'z', then a hex value
  514.             (see later for an explanation of hex numbers) as the final two
  515.             entries. The effects allow you to a wide variety of functions
  516.             that are otherwise impossible to obtain.
  517.  
  518.             Due to the repetitive nature of some effects, there is a
  519.             'memory' so that instead of typing:
  520.  
  521.                 ∙∙∙ ∙∙ ∙∙ G12     It is easier to   ∙∙∙ ∙∙ ∙∙ G12
  522.                 ∙∙∙ ∙∙ ∙∙ G12     use:              ∙∙∙ ∙∙ ∙∙ G00
  523.                 ∙∙∙ ∙∙ ∙∙ G12                       ∙∙∙ ∙∙ ∙∙ G00
  524.                 ∙∙∙ ∙∙ ∙∙ G12                       ∙∙∙ ∙∙ ∙∙ G00
  525.                 ∙∙∙ ∙∙ ∙∙ G12                       ∙∙∙ ∙∙ ∙∙ G00
  526.                 ∙∙∙ ∙∙ ∙∙ G12                       ∙∙∙ ∙∙ ∙∙ G00
  527.                 ∙∙∙ ∙∙ ∙∙ G12                       ∙∙∙ ∙∙ ∙∙ G00
  528.  
  529.            The following effects 'memorise' their previous values:
  530.             (D/K/L), (E/F/G), (HU), I, J, N, O, S, W
  531.  
  532.            Note: Bracketed commands share the same 'memory' value. So
  533.  
  534.                 ∙∙∙ ∙∙ ∙∙ E12   can be written as:  ∙∙∙ ∙∙ ∙∙ E12
  535.                 ∙∙∙ ∙∙ ∙∙ F12                       ∙∙∙ ∙∙ ∙∙ F00
  536.                 ∙∙∙ ∙∙ ∙∙ E12                       ∙∙∙ ∙∙ ∙∙ E00
  537.                 ∙∙∙ ∙∙ ∙∙ F12                       ∙∙∙ ∙∙ ∙∙ F00
  538.                 C-4 01 ∙∙ G12                       C-4 01 ∙∙ G00
  539.  
  540.                 Commands H and U are linked even more closely.
  541.                 If you use H00 or U00, then the previous vibrato, no matter
  542.                 whether it was set with Hxx or Uxx will be used. So:
  543.  
  544.                 ∙∙∙ ∙∙ ∙∙ H81    Is the same as:    ∙∙∙ ∙∙ ∙∙ H81
  545.                 ∙∙∙ ∙∙ ∙∙ U00                       ∙∙∙ ∙∙ ∙∙ H81
  546.                 ∙∙∙ ∙∙ ∙∙ U83                       ∙∙∙ ∙∙ ∙∙ U83
  547.                 ∙∙∙ ∙∙ ∙∙ U00                       ∙∙∙ ∙∙ ∙∙ U83
  548.                 ∙∙∙ ∙∙ ∙∙ H00                       ∙∙∙ ∙∙ ∙∙ U83
  549.  
  550.             Hex Numbers
  551.                 Instead of using a decimal system (ie. base 10), it is more
  552.                 natural for the computer to work with hexadecimal (often
  553.                 abbreviated to simply 'Hex') - numbers which operate in base
  554.                 16. The first 9 numbers in hex are denoted by '1' to '9' and
  555.                 the next 6 are denoted by 'A' to 'F'. So if you count in hex,
  556.                 it will be as follows: (0), 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B,
  557.                 C, D, E, F, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 1A, 1B,
  558.                 1C, 1D, 1E, 1F, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 2A etc.
  559.  
  560.                 To convert a hex number to decimal, multiply the 'tens' column
  561.                 by 16 and add the value of the second column. ie. 32 Hex =
  562.                 3*16+2 = 50 decimal. 2A hex = 2*16+10 = 42. (because A = 10)
  563.                 The maximum number that you can represent with two Hex digits
  564.                 is FF = 255 decimal.
  565.  
  566.                 Hope that this makes SOME sense :)
  567.  
  568.         Effects.
  569.  
  570.           Axx   Set Speed.
  571.  
  572.                 I prefer to think of this command as "Set Frames per Row".
  573.                 Normally, the tracker operates at around 50 frames a
  574.                 second. If the rows were played at this speed, then a huge
  575.                 amount of space would be required to enter the pattern data.
  576.                 Instead, setting the 'speed' of the song will cause the
  577.                 tracker to wait on the current row for 'xx' frames. Hence,
  578.                 setting the speed at 50 (decimal = 32hex) will cause each
  579.                 row to last about a second - quite a long time! The default
  580.                 is A06. The initial speed can be set in the variables
  581.                 screen on F12.
  582.  
  583.                 If two Axx commands are given in the same row, then the
  584.                 command in the higher channel (by number) will take effect.
  585.  
  586.           Bxx   Jump to order.
  587.  
  588.                   Causes the song to jump to order xx (hex). This is often
  589.                   used to create looping songs.
  590.  
  591.                   If two Bxx commands are given, then the command in the
  592.                   higher channel will take effect.
  593.  
  594.           Cxx   Break to row.
  595.  
  596.                   The Command Cxx signifies the end of the current pattern,
  597.                   and also that the next pattern should be played from row
  598.                   xx (hex)
  599.  
  600.                   If two Cxx commands are given... you know :)
  601.  
  602.           D0x   Volume slide down
  603.  
  604.                   The volume slide down command causes the volume of the
  605.                   note to be reduced by x for each frame after (for that
  606.                   row). ie. If you have a note at volume 64, with command
  607.                   D01 and speed A06, then the final volume will be 64-5=59.
  608.                   A note at volume 32 with command D02 at speed A05 will
  609.                   result in a volume of 24.
  610.  
  611.                   For greater S3M compatibility, D0F will cause the volume
  612.                   to drop by 15 EVERY frame, instead of just off-note frames.
  613.  
  614.                   Here's a full frame-by-frame description which should provide
  615.                   greater understanding:
  616.  
  617.                         At 'speed' 4:
  618.                          C-4 01 .. D04
  619.  
  620.                   What this does is:
  621.                     Frame 1: Plays C-4 with instrument 1
  622.                     Frame 2: Lowers the volume by 4
  623.                     Frame 3: Lowers the volume by 4
  624.                     Frame 4: Lowers the volume by 4
  625.  
  626.           Dx0   Volume slide up.
  627.  
  628.                   Operates exactly the same way as D0x, but slides the
  629.                   volume up by 'x'. Volumes cannot exceed 64 (checked
  630.                   and limited internally).
  631.  
  632.                   For greater S3M compatibility, DF0 will cause the volume
  633.                   to rise by 15 EVERY frame, instead of just off-note frames.
  634.  
  635.           DFx   Fine volume slide down.
  636.  
  637.                   Takes the volume down by x at the start of the row.
  638.  
  639.           DxF   Fine volume slide up.
  640.  
  641.                   Takes the volume up by x at the start of the row.
  642.  
  643.           Exx   Pitch slide down
  644.  
  645.                   The pitch will slide down with speed xx (hex). In linear
  646.                   frequency mode, a pitch slide down by a particular value
  647.                   will always cause the same "pitch interval" - this does
  648.                   not occur in Amiga frequency mode. Valid ranges for xx
  649.                   are between 0 and 0DFh (as > 0E0h will be interpreted as
  650.                   fine slides)
  651.  
  652.           EFx   Fine pitch slide down
  653.  
  654.                   Slides the pitch down by x at the start of the row.
  655.  
  656.           EEx   Extra fine pitch slide down
  657.  
  658.                   Same as EFx, but 4 times finer. (ie. EE4 is equivalent to
  659.                   EF1)
  660.  
  661.           Fxx   Pitch Slide up
  662.           FFx   Fine Pitch slide up
  663.           FEx   Extra fine pitch slide up
  664.  
  665.                   Operates in the same manner as the Exx commands, but
  666.                   slides the pitch up. If the pitch gets 'too high', then
  667.                   the channel is turned off.
  668.  
  669.           Gxx   Portamento to note.
  670.  
  671.                   This command requires 2 parameters: A note to slide to
  672.                   and a speed. Example:
  673.  
  674.                         C-4 01 ∙∙ .00
  675.                         G-4 01 ∙∙ G08
  676.                         ∙∙∙ ∙∙ ∙∙ G00
  677.                         ∙∙∙ ∙∙ ∙∙ G00
  678.  
  679.                   This will cause the note C-4 to slide to G-4 with speed 8.
  680.  
  681.                   You *CAN* change the sample that the note is sliding to.
  682.                   It is a good idea to make sure that the C5Speed of the
  683.                   samples is similar, if you want to try this! The new sample
  684.                   will play from it's beginning.
  685.  
  686.           Hxy   Vibrato with speed x, depth y
  687.  
  688.                   Causes the frequency to osciallte with depth 'y' at speed
  689.                   'x' which causes an interesting effect. Don't get carried
  690.                   away with it though! If you specify EITHER x or y as 0, then
  691.                   the previous value will be used.
  692.  
  693.           Ixy   Tremor with ontime x, offtime y.
  694.  
  695.                   Causes the volume of the instrument to remain normal for
  696.                   x frames, then sets the volume to 0 for y frames.
  697.  
  698.           Jxy   Arpeggio with halftones x, y.
  699.  
  700.                   This causes the note to quickly cycle through three notes -
  701.                   the note playing, a note x halftones above, and a note y
  702.                   halftones above. This causes an effect similar to old
  703.                   C-64 chords.
  704.  
  705.                   Example: C-4 01 ∙∙ J47 will cause the notes C-4, E-4 and
  706.                   G-4 to be cycled.
  707.  
  708.           Kxx   Dual command: Vibrato + Dxx (Volume slide)
  709.  
  710.                   Note: The vibrato could have been set with either Hxx or
  711.                         Uxx
  712.  
  713.           Lxx   Dual Command: G00 + Dxx (Portamento to and Volume slide)
  714.  
  715.           Mxx   Set channel volume
  716.  
  717.                   Each channel has a volume range from 0->40h. The lower
  718.                   the value, the softer the notes in the channel. This
  719.                   command is convenient for making 'echoes'... you won't have
  720.                   to modify the echoing channel from the original, except
  721.                   for placing a M20 at the top of it!
  722.  
  723.                   Values greater than 40h are ignored at playtime.
  724.  
  725.           N0x, Nx0, NFx, NxF  Slide channel volume commands
  726.  
  727.                   These commands work in the same manner as the slide
  728.                   volume commands, but operate on the channel volume,
  729.                   rather than directly on the note volume.
  730.  
  731.           Oxx   Set sample offset.
  732.  
  733.                   This will cause a sample to be played from offset xx00h.
  734.                   This is useful to skip past the first part of a sample
  735.                   which may have a loud hit, or to start a speech sample
  736.                   half way through.
  737.  
  738.                   If you specify a value PAST the end of a sample, then the
  739.                   command is ignored.
  740.  
  741.                   Note to programmers: Oxx for 16-bit samples will move
  742.                   to the xx00h*2 position in the sample - ie. the 'xx00th'
  743.                   sample.
  744.  
  745.           P0x, Px0, PFx, PxF  Slide panning commands.
  746.  
  747.                   These work in the same maner as the slide volume
  748.                   commands, but operate on the channel panning. P0x slides
  749.                   the panning right, while Px0 slides the panning left.
  750.  
  751.           Qxy   Retriggers a note after y frames with volume modifier x.
  752.  
  753.                   This will cause a sample to be replayed from it's
  754.                   beginning after every y frames. 'x' can be any of the
  755.                   following:
  756.  
  757.                         Value           Effect on volume each retrig.
  758.                          0                No change
  759.                          1                  -1
  760.                          2                  -2
  761.                          3                  -4
  762.                          4                  -8
  763.                          5                  -16
  764.                          6                  *2/3
  765.                          7                  *1/2
  766.                          8                No change
  767.                          9                  +1
  768.                          A                  +2
  769.                          B                  +4
  770.                          C                  +8
  771.                          D                  +16
  772.                          E                  *3/2
  773.                          F                  *2
  774.  
  775.           Rxy   Tremelo with speed x, depth y
  776.  
  777.                   This command acts similarly to the vibrato command, but
  778.                   affects the note volume, instead of the pitch. If you specify
  779.                   EITHER x or y as 0, then the previous value will be used.
  780.  
  781.           S3x   Sets vibrato waveform to x
  782.           S4x   Sets tremelo waveform to x
  783.           S5x   Sets panbrello waveform to x
  784.  
  785.                   Values for x: 0 = sine wave
  786.                                 1 = square wave
  787.                                 2 = Ramp down
  788.                                 3 = Random!
  789.  
  790.           S70   Past note cut
  791.           S71   Past note off
  792.           S72   Past note fade
  793.  
  794.                   With the loss of 1-1 correspondence of editing channels
  795.                   to internal playing channels, these commands provide
  796.                   control over notes that have already been played by a
  797.                   channel.
  798.  
  799.                    Example:
  800.                         Consider the following situation, where instrument
  801.                         1, notes C-4 & D-4 map to a looped sample, and the
  802.                         New Note Action is set to continue.
  803.  
  804.                         C-4 01 64 .∙∙
  805.                         D-4 01 64 .∙∙
  806.                         E-4 01 64 .∙∙ <--- Use S70 here!
  807.  
  808.                   Ordinarily, control would be lost over C-4 and D-4, but
  809.                   using command S70 at the point indicated, the notes C-4
  810.                   and D-4 would be stopped immediately when the note E-4
  811.                   plays.
  812.  
  813.                   Similarly, note off commands and Fadeout commands can
  814.                   also be issued.
  815.  
  816.                   Note: You *MUST* be in instrument mode for these
  817.                         to have any significance.
  818.  
  819.           S73   Set NNA to note cut
  820.           S74   Set NNA to continue
  821.           S75   Set NNA to note off
  822.           S76   Set NNA to note fade
  823.  
  824.                   These options allow you to override the default NNA for a
  825.                   particular NOTE (ie. it does not affect the instrument)
  826.                   See section 2.5 for an explanation of NNAs.
  827.  
  828.                   Note: You *MUST* be in instrument mode for this to work.
  829.  
  830.           S77   Turn Volume envelope off.
  831.  
  832.                   Stops the processing of the volume envelope. This is for the
  833.                   times that you don't want to use the volume envelope that
  834.                   you've created.
  835.  
  836.           S78   Turn volume envelope on.
  837.  
  838.                   Sometimes, you'll decide that it's better not to use the
  839.                   volume envelope for most cases, but you may just want to
  840.                   use it a few times - this is the command that lets you
  841.                   do that!
  842.  
  843.                   Note: You *MUST* be in instrument mode for this to work.
  844.  
  845.           S8x   Set panning position
  846.  
  847.                   Set panning position, S80 is leftmost, S8F is rightmost.
  848.                   This is an obsolete command, provided only for ST3
  849.                   compatibility. Use command Xxx instead.
  850.  
  851.           S91   Set surround sound!
  852.  
  853.                   For those of you who are lucky enough to have a dolby
  854.                   surround sound decoder (myself not included - so if ya
  855.                   wanna send me something.....), this *should* cause the
  856.                   sound to come from the surround speaker. This is a
  857.                   pseudo-panning command, and issuing either Xxx or S8x
  858.                   will cause the surround sound to be reset.
  859.  
  860.                   If you try and play Surround Sound on a GUS, it will be
  861.                   played as a central pan. :(
  862.  
  863.           SB0   Set loopback point
  864.           SBx   Loop x times.
  865.  
  866.                   This pattern space-saving feature will cause the pattern
  867.                   to be looped x times back to the last SB0. Note that you
  868.                   can only loop within the pattern! Also, each channel has
  869.                   it's own loop-back information... so you HAVE to have the
  870.                   SB0 and SBx in the same channel for it to operate.
  871.  
  872.           SCx   Note cut after x frames
  873.  
  874.                   This will cause a note to be immediately stopped after x
  875.                   frames. It is similar to issuing a "^^^" in the note column,
  876.                   just that it has a finer control
  877.  
  878.           SDx   Note delay for x frames
  879.  
  880.                   Actually, this command works like "interpretation" delay
  881.                   for x frames. Any data - note, sample/instrument or volume
  882.                   in the channel will not be interpreted until x frames into
  883.                   the row.
  884.  
  885.           SEx   Pattern delay for x rows
  886.  
  887.                   This will cause a "pause" on the row for effectively x rows
  888.                   longer.
  889.  
  890.                   Note that if TWO pattern delay commands are issued, then
  891.                   the only the command in the higher channel will be considered.
  892.  
  893.           Txx   Set tempo to xx
  894.  
  895.                  Valid ranges are between 21h and 0FFh. The higher the
  896.                  value, the faster the playback. This essentially
  897.                  determines the time length of each frame, by the following
  898.                  formula:
  899.  
  900.                         Frames per minute = 24*Tempo
  901.  
  902.           Uxy   Fine vibrato with speed x, depth y
  903.  
  904.                  Same as vibrato, but 4 times finer.
  905.  
  906.           Vxx   Set Global volume
  907.  
  908.                  Valid ranges are between 0 and 80h. All notes playing are
  909.                  affected by this change.
  910.                  Values greater than 80h are ignored at playtime.
  911.  
  912.           W0x, Wx0, WFx, WxF  Slide global volume
  913.  
  914.                  Similar to the Dxx commands, but operate on the global
  915.                  volume. Useful when fading out songs.
  916.  
  917.           Xxx   Set panning position
  918.  
  919.                  Sets the panning position anywhere from left to right (X00
  920.                  is left, XFF is right).
  921.  
  922.           Yxy   Panbrello with speed x, depth y.
  923.  
  924.                  What the hell is panbrello? Well, it's a word that I coined
  925.                  late one night after a friend suggested that there should
  926.                  be a random pan position command. I decided.. why not - I'll
  927.                  make the vibrato/tremelo equivalent of panning! And so you
  928.                  have here, 'panbrello.' What this does is instead of
  929.                  oscillating frequency (pitch) or volume, it oscillates the
  930.                  panning position about the 'set' panning position for a
  931.                  channel. This is for you techno freaks out there who want
  932.                  another function to stuff around with! :)
  933.  
  934.                  The random pan position can be achieved by setting the
  935.                  waveform to 3 (ie. a S53 command). In this case *ONLY*, the
  936.                  speed actually is interpreted as a delay in frames before
  937.                  another random value is found. so S14 will be a very QUICK
  938.                  panbrello, and S44 will be a slower panbrello. With any
  939.                  other waveform, the higher the value for x, the faster the
  940.                  panbrello, like vibrato and tremelo. If you don't know what
  941.                  I'm talking about, check out the stereo-indicators on the
  942.                  info page (don't forget that you have to be in stereo mode!)
  943.  
  944.                  If you specify EITHER x or y as 0, then the previous value
  945.                  will be used.
  946.  
  947.          5) Editing Functions
  948.  
  949.              For a complete list of available functions, check the help screen
  950.              for the pattern editor (on F1)
  951.  
  952.            Ctrl-Backspace       IMPORTANT! This one will save you a lot of
  953.                                 frustration - it's a 10-stage listed Undo
  954.                                 function!
  955.  
  956.            Grey Plus    Advance to next pattern
  957.            Grey Minus   Goto previous pattern
  958.            Shift-GPlus  Advance 4 patterns
  959.            Shift-GMinus Go back 4 patterns
  960.            Ctrl-GPlus   Go to the next order's pattern
  961.            Ctrl-GMinus  Go to the previous order's pattern
  962.  
  963.            Alt-Delete   Remove an entire row from the pattern
  964.            Alt-Insert   Insert an entire row into the pattern
  965.  
  966.            '.'          erase data.
  967.            Space        will enter the previous data for that column.
  968.            '4'          play the note under the cursor.
  969.            '8'          play entire row.
  970.            Ctrl-F6      play pattern from the current row.
  971.            Ctrl-F7      Set playback mark - this will be the position that
  972.                         subsequent playback will occur when you press F7.
  973.                         Remove the mark by pressing Ctrl-F7 on the row
  974.                         that is already 'marked.'
  975.  
  976.            Alt-0 -> 9   Quick select "skip value"
  977.                         The skip value is the number of rows that the
  978.                         editor advances by when a note is entered - this
  979.                         makes it easy to enter notes on alternate rows
  980.                         (press alt-2 first!)
  981.  
  982.                         If the skip value is 0, then the editor will
  983.                         advance to the next channel (making it easier to
  984.                         enter chords)
  985.  
  986.                         If the skip value is 0, AND template mode is on,
  987.                         then entering a note will cause the editor to
  988.                         advance by the length of the template block.
  989.  
  990.            Alt-Enter     Store current pattern in memory
  991.            Alt-Backspace Restore current pattern
  992.  
  993.          6) Block Functions
  994.            Alt-B        Mark top left of block
  995.            Alt-E        Mark bottom right of block
  996.            Alt-L        Mark entire column (channel)
  997.            Alt-L*2      Mark entire pattern
  998.            Alt-D        Mark the minor row hilight number of rows. Pressing
  999.                         this repeatedly doubles the length of the block.
  1000.                         eg. Pressing Alt-D once may mark out 16 rows,
  1001.                         pressing it twice will mark 16 rows.
  1002.  
  1003.            Alt-A        Transpose all the notes in the block a semitone
  1004.                         down If no block is marked, then the current note
  1005.                         will be transposed a semitone down.
  1006.            Alt-C        Copy marked block into the clipboard
  1007.            Alt-F        Double the length of the selected block
  1008.            Alt-G        Halve the length of the selected block
  1009.            Alt-I        Toggle Template mode... read part 8
  1010.            Alt-J        Volume Amplifier... modify the volume controls
  1011.                         between 0 and 200%
  1012.            Alt-K        Slide volume... if you want to manually control a
  1013.                         fadeout, or fadein, then set the volumes at the
  1014.                         extreme ends of the blocks, then press Alt-K ONCE!
  1015.            Alt-K*2      Remove all volume controls in the selected block
  1016.            Alt-M        Mix clipboard with pattern data.. try it out, and
  1017.                         you'll understand (it's like an advanced paste
  1018.                         command - it'll only copy the data IF there is nothing
  1019.                         on the row it is copying to.)
  1020.                         Pressing this two times will copy the data if there's
  1021.                         nothing in the same FIELD (not just same row).
  1022.            Alt-N        Toggle Multichannel mode.. Multichannel mode allows
  1023.                         you to select for each channel whether it should be
  1024.                         part of the multichannel list. If you enter a note
  1025.                         while on a channel which is in the multichannel
  1026.                         list, then the editor will advance to the next
  1027.                         channel.
  1028.            Alt-N*2      Multichannel menu.
  1029.            Alt-O        Overwrite pattern data with clipboard. Like paste,
  1030.                         but without the "insert" part :)
  1031.            Alt-P        Paste clipboard into pattern at current position
  1032.            Alt-Q        Transpose all the notes in the block a semitone up
  1033.                         If no block is marked, then the current note will
  1034.                         be transposed a semitone up.
  1035.            Alt-S        Set all the instrument (sample) values to the
  1036.                         current instrument (sample) within a block
  1037.            Alt-U        Unmark block / release clipboard from memory.
  1038.            Alt-V        Set all the volume controls to the current
  1039.            Alt-W        Remove all volumes not associated with a note/inst
  1040.            Alt-X        Slide command value. Similar to Alt-K (slide
  1041.                         volume). This command can be convenient to slide
  1042.                         the panning from one position to another, or to
  1043.                         slide global volume effects, channel volume, sample
  1044.                         offsets... whatever...
  1045.  
  1046.            Alt-X*2      Erase all effect data in the selected block!
  1047.            Alt-Y        Swap selected block with a samesized/shaped block
  1048.                         starting at the current position. Swap blocks
  1049.                         CANNOT overlap.
  1050.            Alt-Z        Cut current block.
  1051.                         Warning: If you don't have enough memory, the
  1052.                         current block WILL be erased, although there is no
  1053.                         record of it in the clipboard....
  1054.  
  1055.          7) Track View functions
  1056.  
  1057.             Sometimes you just want to know what you've put in those tracks
  1058.             that are currently off the screen... these functions allow you
  1059.             to do just that!
  1060.  
  1061.             Alt-T       Cycle Track view mode.
  1062.             Alt-R       Remove all track views
  1063.             Alt-H       Remove track view divisions (allows you to view 36
  1064.                         channels!)
  1065.             Ctrl-0      Remove current track from track view
  1066.             Ctrl-1->5   Quick select a track view for current channel.
  1067.  
  1068.          8) Templates
  1069.  
  1070.             Templates are an invention to make entering repeated
  1071.             'sequences' easier. Often, you may want to enter a note with
  1072.             the same effects following each note. eg.
  1073.  
  1074.                 C-4 01 00 D10   }
  1075.                 ∙∙∙ ∙∙ ∙∙ D00   }
  1076.                 ∙∙∙ ∙∙ ∙∙ D00   } Enter this....
  1077.                 ∙∙∙ ∙∙ ∙∙ D00   }
  1078.                 ∙∙∙ ∙∙ ∙∙ D02   }
  1079.                 ∙∙∙ ∙∙ ∙∙ D00   }
  1080.                 D-4 01 00 D10     }
  1081.                 ∙∙∙ ∙∙ ∙∙ D00     }
  1082.                 ∙∙∙ ∙∙ ∙∙ D00     }
  1083.                 ∙∙∙ ∙∙ ∙∙ D00     }
  1084.                 ∙∙∙ ∙∙ ∙∙ D02     }
  1085.                 ∙∙∙ ∙∙ ∙∙ D00     } Use the templates to enter this!
  1086.                 E-4 01 00 D10     }
  1087.                 ∙∙∙ ∙∙ ∙∙ D00     }
  1088.                 ∙∙∙ ∙∙ ∙∙ D00     }
  1089.                 ∙∙∙ ∙∙ ∙∙ D00     }
  1090.                 ∙∙∙ ∙∙ ∙∙ D02     }
  1091.                 ∙∙∙ ∙∙ ∙∙ D00     }
  1092.                 etc..
  1093.  
  1094.             With templates, this can be done by entering the first 'block',
  1095.             then marking it and copying it into the clipboard (using
  1096.             Alt-C). Toggle the template mode by pressing Alt-I to Template:
  1097.             Overwrite, then go to the start of the second block, and press
  1098.             the key for D-4 (normally X). The whole block will be filled
  1099.             in! This is easiest to understand if you print this section out
  1100.             and try it in the editor.
  1101.  
  1102.             The templates can also include other notes, which will be
  1103.             translated accordingly, and can span several channels.
  1104.  
  1105.             A VERY neat use of templates is to enter multiple notes:
  1106.             (eg. octaves, different samples...)
  1107.  
  1108.                 C-4 01 32 .00    C-5 02 32 .00  } Enter this...
  1109.                 G-4 01 32 .00    G-5 02 32 .00      }
  1110.                 D#4 01 32 .00    D#5 02 32 .00      }
  1111.                 C-4 01 32 .00    C-5 02 32 .00      } And use Templates here!
  1112.                 G-4 01 32 .00    G-5 02 32 .00      }
  1113.                 D#4 01 32 .00    D#5 02 32 .00      }
  1114.  
  1115.  
  1116.   2.3  Order List, Channel panning & volume. (F11)
  1117.           After creating patterns, the tracker has to know what order to
  1118.           play them back in. The order list is the means by which this is
  1119.           done. Another wording of the Order List which may make it simper
  1120.           to understand is the "Pattern sequence list." ie. the sequence in
  1121.           which the patterns are played back.
  1122.           Simply enter the patterns into the list in the order they
  1123.           should be played, and voila! - you have a new piece of music.
  1124.           (as long as you have something in the patterns, of course!). The
  1125.           "---" marks the end of a song, and "+++" is simply a marker which
  1126.           is skipped (for ST3 support). Pressing N on a row will enter the
  1127.           previous order's pattern+1. eg. Entering 000, then pressing 'n' 5
  1128.           times will enter 000 (which you typed), then 1, 2, 3, 4 and 5.
  1129.  
  1130.           Initial channel panning and volume is the panning and volume that
  1131.           each channel is set to whenever the song is reset. It will not
  1132.           affect anything currently playing. On the panning list, you can
  1133.           also mute channels by pressing spacebar. Pressing S will select
  1134.           the initial 'panning' as surround sound. The initial channel
  1135.           volumes can be accessed by pressing F11 once you are already on
  1136.           the Order list and channel panning screen.
  1137.  
  1138.   2.4  Samples
  1139.  
  1140.   2.4.1 Information about Samples
  1141.          Samples are the raw sound information. They can be of *anything*
  1142.          you like - normally a musical instrument of some sort, but you
  1143.          could have voice samples or sound effects too!
  1144.  
  1145.          Impulse Tracker accepts 8-bit or 16-bit samples. It can import
  1146.          several different formats, which are detailed in section 1.4
  1147.  
  1148.          If you import a 16-bit file which isn't recognised, you have to
  1149.          use the following steps:
  1150.  
  1151.                 1) Press Alt-A (to convert signed/unsigned) and convert the
  1152.                    data.
  1153.                 2) Press Alt-Q (to toggle to 16-bit) and DON'T convert
  1154.                    the data
  1155.                 3) If the sample is unsigned, you will then need to convert
  1156.                    it AGAIN by pressing Alt-A (and selecting yes to convert
  1157.                    data)
  1158.  
  1159.          Samples have the following information: A name, a default volume,
  1160.          a global volume, vibrato information, loop information and a
  1161.          frequency
  1162.  
  1163.          The default volume of a sample is the volume at which a sample is
  1164.          played, IF no volume is specifier.
  1165.  
  1166.          The global volume is the modifier by which ALL occurrences of the
  1167.          current sample are scaled by.
  1168.  
  1169.          Vibrato information - the vibrato speed is the speed at which the
  1170.          vibrato oscillates. Although it is possible to enter values 0->64,
  1171.          the best effects are obtained by entering values around 24-48. The
  1172.          vibrato depth determines the maximum deviation from the mean
  1173.          frequency. The vibrato rate determines how quickly the vibrato is
  1174.          applied. Higher values cause the vibrato to be applied more
  1175.          quickly, a low value like 1 can take many seconds before the
  1176.          vibrato is noticed.
  1177.  
  1178.          Loop information. Samples can be looped to provide a continuous
  1179.          sound. The loop beginning and the loop end must be specified, and
  1180.          the loop method (either forwards or ping pong) must be set.
  1181.          (Toggle by pressing spacebar). The loop boundaries can also be
  1182.          modified using '+' or '-' (even while the sample is playing!)
  1183.  
  1184.          Sustain loops are the loops used as long as no note off command is
  1185.          encountered. In the sample tester, releasing a key provides a note
  1186.          off command to the player. Once a note off command is issued, the
  1187.          normal loops apply. The idea behind sustain loops originated after
  1188.          listening to some synthesizers which provided 'after note' sounds
  1189.          - like fingers lifting off guitar strings. With sustain loops, you
  1190.          can have a guitar sound in the sustain loop, with the end of the
  1191.          sample containing the 'finger off' sound. This way, you should be
  1192.          able to achieve a new degree of realism. The best way to do this
  1193.          is to have a reasonably small sustain loop, and a section after it
  1194.          containing the note-off sound, possibly looped. (The sustain loop
  1195.          should ideally be less than 1/20th of a second, so that you have
  1196.          reasonably good control over the timing of the note-off, but this
  1197.          is not always possible)
  1198.  
  1199.            Example: If you have a sample with no sample loop, but a sustain
  1200.                     loop around bytes 19000-20000, then while no noteoff
  1201.                     command is issued, then the sample will loop between
  1202.                     19000 and 20000. Once a noteoff command is received,
  1203.                     then the sample will be played until it's end and then
  1204.                     will stop.
  1205.  
  1206.                     If you have a sample of length 64000 with a ping pong
  1207.                     loop around the whole sample (0->64000) and a sustain
  1208.                     ping pong loop around bytes 20000-30000, then the
  1209.                     sample will loop backwards and forwards between 20000
  1210.                     and 30000 until a noteoff command is received, after
  1211.                     which it will loop between 0 and 64000 (backwards and
  1212.                     forwards).
  1213.  
  1214.            It is recommended that you do NOT have a ping pong sustain loop
  1215.            going to a forwards loop or no loop and that if you DO have a
  1216.            sustain loop AND a normal loop, that the sustain loop lies
  1217.            within the normal loop (for ping pong), or that the normal loop
  1218.            end is after the sustain loop end (for forward's loop) (think
  1219.            about what you're asking it to do in these cases carefully...
  1220.            it should make sense - the tracker can still handle the cases
  1221.            when this is not adhered to, but the resulting note-off effect
  1222.            can vary greatly depending on timing and pitch!)
  1223.  
  1224.          The frequency of a sample determines its pitch. The higher the
  1225.          frequency, the higher the pitch. The frequency can be doubled or
  1226.          halved by pressing Alt-Grey Plus/Minus to cause an octave
  1227.          rise/decrease. For the technically inclined out there, the
  1228.          frequency is the number of bytes per second that have to be played
  1229.          for a C-5. You can increase the frequency by one semitone by
  1230.          pressing Ctrl-Grey Plus or decrease it by a semitone with
  1231.          Ctrl-Grey Minus.
  1232.  
  1233.          To load in a sample, go to the entry in which you want to load it
  1234.          then press enter. The sample library should appear. You can test
  1235.          out any sample just by "playing" notes on the keyboard while you
  1236.          are on top of the sample. Load a sample into the sample list by
  1237.          pressing enter. Of course, if you don't have any samples, no
  1238.          samples will appear :)
  1239.  
  1240.          Where can I get samples from??
  1241.  
  1242.          You can steal ('rip') samples from modules by going to the sample
  1243.          in the sample list, then pressing Alt-O. Scream Tracker 3 samples
  1244.          can be saved by pressing Alt-T (vibrato, global volume + susloop
  1245.          information lost) or raw samples can be saved by pressing Alt-W
  1246.          (all variables lost!)
  1247.  
  1248.          Warning: Be careful where you rip samples from!! Some people don't
  1249.          welcome it at all! And in some cases, sample ripping may be a breach
  1250.          of copyright - this mainly a concern when you use commercial samples)
  1251.  
  1252.          There are also many great sample 'packs' available... try a local
  1253.          music BBS, or the bigger FTP sites.
  1254.  
  1255.          Some synthesizers have patch files (eg. Kurzweil 2000 as .KRZ) which
  1256.          are available through the internet. You can download these, and
  1257.          convert them with an appropriate utility (I recommend Convert 1.4 -
  1258.          convrt14.zip on ftp.cdrom.com/pub/demos/programs/convert and use
  1259.          it to convert the files to .S3I format - even for 16 bit samples).
  1260.          I don't know what sort of copyright these samples have. *YOU* have
  1261.          to read any text accompanying the files to find this out.
  1262.  
  1263.          Finally, you can make your OWN samples! With a sampler (eg.
  1264.          Digiplay 3.0) or with some other tracker (eg. Fast Tracker 2), you
  1265.          are able to record information through the microphone socket of
  1266.          the computer!
  1267.  
  1268.          Note: The length of a sample is *NOT* necessarily the number of bytes
  1269.          it occupies! The length quoted is the quantity of SAMPLE INFORMATION.
  1270.          If you have an 8 bit sample, then the size in bytes IS the same as
  1271.          the length. If you have a 16-bit sample, then the size in bytes
  1272.          is DOUBLE the length.
  1273.  
  1274.   2.4.2 Sample Functions
  1275.  
  1276.          Alt-A and Alt-Q provide basic sample-conversion functions. Alt-A
  1277.          will convert a sample to or from unsigned to signed format. Alt-Q
  1278.          will allow you to change a sample between 8 and 16 bits.
  1279.  
  1280.          If you want to remove the part of a sample before a loop or after the
  1281.          end of a loop, you can use Pre-loop cut sample (Alt-B) or Post-Loop
  1282.          cut sample (Alt-L)
  1283.  
  1284.          To reverse a sample, use Alt-G. This can produce interesting effects.
  1285.  
  1286.          If you are working to a size limit, check out the functions Alt-E
  1287.          and Alt-F. These functions allow you to resize the sample to whatever
  1288.          size you would like! (Note that there is a reduction in quality
  1289.          associated with a reduction in size). Alt-E will resize the samples
  1290.          WITH interpolation, Alt-F will resize the samples WITHOUT
  1291.          interpolation.
  1292.  
  1293.          To decrease the volume of a sample, the best way for 8 bit samples
  1294.          is to reduce the Sample's GLOBAL volume. For 16-bit samples, it's
  1295.          better to just attenuate the sample (ie. use Alt-M to 75%). The
  1296.          sample will retain greater quality if you follow these guidelines.
  1297.  
  1298.          Alt-M is used to amplify a sample to between 0 and 400%. The default
  1299.          value for Alt-M which appears is the maximum the sample can be
  1300.          modified without creating clipping distortions.
  1301.  
  1302.          To exchange two samples *in the sample list only*, use Alt-X. To
  1303.          swap two samples *even in the pattern data*, use Alt-S.
  1304.  
  1305.   2.5  Instruments
  1306.  
  1307.          For those who have never used a tracker before, I strongly suggest
  1308.          that you skip this section for now - learn how to 'use' samples
  1309.          first. After that, you'll should be able to understand and hopefully
  1310.          fully appreciate the power that instruments can provide.
  1311.  
  1312.          To enable instruments, go to the song variables (F12), and press
  1313.          on the "Instruments" button after then "Control" prompt. This *MUST*
  1314.          be done in order to use ANY instrument function (including special
  1315.          note effects, viz S7x).
  1316.  
  1317.          The instrument parameters are split into four screens - one for
  1318.          each of general options, volume options, panning options and pitch
  1319.          options. To select the appropriate screen, just whack enter on any
  1320.          of the four buttons at the top of the instrument list.
  1321.  
  1322.          Instruments are collections of samples (or just a single sample).
  1323.          The translation of samples is controlled by the column in the
  1324.          centre of the screen on the general options page which shows what
  1325.          note/sample pair a single instrument note will be translated to.
  1326.          Example: If you're on instrument 1, and the note translation table
  1327.          appears as such:
  1328.  
  1329.                 C-5│C-5 01
  1330.                 C#5│C-5 02
  1331.                 D-5│D-4 03
  1332.                 D#5│D#4 03
  1333.  
  1334.          Then entering "C-5 01" into a pattern will cause sample 1 to be
  1335.          played at pitch C-5, "C#5 01", wil cause sample 2, to be played a
  1336.          pitch C-5, "D-5 01" will cause Sample 3 to play at D-4, "D#5 01"
  1337.          will cause Sample 3 pitch D#4 to play... get the idea?
  1338.  
  1339.          Why would you want to combine several samples into one instrument?
  1340.          Well, one very good reason is that it makes it easier to enter
  1341.          drum parts - you no longer have to change the 'instrument' if you
  1342.          want another sample. And also, combining them into one instrument
  1343.          makes them easier to manage - you can specify a volume envelope,
  1344.          NNA or FadeOut which will apply for ALL of the samples in the
  1345.          list.
  1346.  
  1347.          Another reason is if you want a very high quality sounding
  1348.          'instrument.' If you wanted to go overboard, you could sample
  1349.          every single note on a piano separately, and set up the note
  1350.          translation table to point to each sample accordingly - you'd
  1351.          get a very, very nice sound - if you don't run out of memory
  1352.          first. Or patience :)
  1353.  
  1354.          When you save an instrument to disk, all the related samples are
  1355.          stored with it. This means that you can setup a 'drum kit' instrument,
  1356.          and to load it into another song, you only need to select that
  1357.          instrument and all the samples will be loaded for you.
  1358.  
  1359.          The Fadeout value for each instrument determines how quickly the
  1360.          volume of the instrument decays under any of the following
  1361.          conditions:
  1362.            1) NNA "FadeOut" is selected, and another note is played. (see
  1363.               later in this section for info about NNAs)
  1364.            2) The end of a volume envelope is reached.
  1365.            3) A note off command is encountered, without a volume envelope.
  1366.            4) A note off command is encountered, and the 'normal' volume
  1367.               envelope loop is on.
  1368.  
  1369.          The larger the fadeout value, the quicker the volume decays.
  1370.  
  1371.          Each instrument also has an associated volume/pan/pitch envelope!
  1372.          The volume envelope is editing by selecting the node (left/right
  1373.          arrows) then picking it up (with enter), moving it around (using
  1374.          arrows, or Alt-Arrows for quicker control), then pressing enter
  1375.          again to "put down the node". Nodes can be inserted or deleted
  1376.          (with the keys insert and delete!). Note that the envelope will
  1377.          only be used if the envelope flag is set to "on" (just below the
  1378.          envelope graph)..
  1379.  
  1380.          Remember that you have to be in instrument mode for this all to work!
  1381.  
  1382.          There are 3 pieces of information for each Envelope graph -
  1383.          the node number (hopefully obvious), the time of the node (the
  1384.          number of 'ticks' or 'frames' that elapse before the node point)
  1385.          and the value of a node (also hopefully obvious). So the x-axis
  1386.          is time, and the y-axis is volume/pan/pitch - simple, really!
  1387.  
  1388.          You can also specify envelope loops and sustain loops. These
  1389.          operate in the same manner as the sample loops, but the numbers
  1390.          refer to node numbers.
  1391.  
  1392.          The powerful feature of this tracker, though, is not the
  1393.          envelopes by themselves - it's the New Note Actions! What these
  1394.          options do is allow you to select what should happen to an
  1395.          instrument when another note is played in the same column. If NNA
  1396.          "Cut" is selected, then the previous note will immediately be
  1397.          stopped (like in all other trackers). If NNA "Continue" is
  1398.          selected, then the note will continue playing! This is especially
  1399.          useful for Drum Parts, where there may be a long-ish snare sample
  1400.          - you can go on ahead and put a bass drum in the very next row
  1401.          after it - the snare drum will still complete playing! NNA "Note
  1402.          Off" issues a note off command to a note when a new note is played
  1403.          in the channel. This is particularly useful in combination with
  1404.          volume envelopes and volume envelope sustain loops. NNA "Note
  1405.          Fade" causes the current note to fade out with the fadeout value
  1406.          when a new note is played.
  1407.  
  1408.         WARNING!!
  1409.          New Note Actions are EXTREMELY powerful, but they CAN cause
  1410.          problems if you are not careful. Selecting NNA Fade with a fade
  1411.          value of 0, or note continue with a looped sample (no volume
  1412.          envelope) or anything which can cause a quick build up of
  1413.          allocated channels can easily hang a slow computer (or even a
  1414.          quick one, for that matter!) I tried to put checks against this,
  1415.          but they always triggered too late - "past the point of no return"
  1416.          where the CPU becomes so bogged down with processing the
  1417.          information, that it can't do or try to do anything else. (The
  1418.          tracker has *MANY* calculations to do - the most time consuming
  1419.          are the mixing routines, which require the processor to process as
  1420.          many bytes as the mixing speed per second for EACH note ie. a
  1421.          mixing speed of 44kHz means that for each note playing, 44000
  1422.          calculations have to be made EVERY second... so with 64 channels
  1423.          'active' at the maximum mixing rate for a SB16, almost 3 MILLION
  1424.          calculations have to be done EVERY second to produce the sound (in
  1425.          mono)!!! (My 486 can cope with this, but my 386 just dies!)
  1426.  
  1427.         Duplicate Check Type (DCT) / Duplicate Check Action (DCA)
  1428.            DCT = Off/Note/Sample/Instrument, DCA = Cut/Off/Fade
  1429.  
  1430.          When the duplicate check type is enabled, then repetitions of the same
  1431.          instrument¬e/sample (or just repititions of the same instrument)
  1432.          pair in a particular channel will cause the previous occurence of
  1433.          the instrument¬e/sample pair to be cut or faded (depending on
  1434.          the DCA)
  1435.  
  1436.           Example: If the DCT is set to note, and DCA is set to Cut, then the
  1437.                     asterixed notes will cut out the tilda notes
  1438.         ┌───────────────┬───────────────────┬───────────────────────────────┐
  1439.         │  C-4 01 ~     │     C-4 02 ~      │   C-4 03 }                    │
  1440.         │  D-4 01       │     C-4 02 *   ~  │   D-4 03 } Nothing get's cut. │
  1441.         │  C-4 01 *     │     C-4 02     *  │   C-4 02 }                    │
  1442.         └───────────────┴───────────────────┴───────────────────────────────┘
  1443.  
  1444.         This option was included to help limit the number of active channels,
  1445.         and is especially useful for drum tracks.
  1446.  
  1447.         Another nifty application of Duplicity checks is the following
  1448.         example: You can have a separate sample for each string of a guitar
  1449.         and setup and instrument to accomodate this. Setting the NNA to
  1450.         continue, the DCT to sample and the DCA to fade (with a relatively
  1451.         quick fadeout) means that whenever you play a new note, the previous
  1452.         note will continue to play on. BUT! If a previous note of the same
  1453.         instrument has the same sample as the new note being played, then
  1454.         it will be faded out - this closely relates to what you hear when
  1455.         someone plays a guitar - when they play the same string, they have
  1456.         to put their fingers down on the string, which causes the last note
  1457.         *on that string* to fade out.
  1458.  
  1459.         I sincerely hope that these options do not cause the death of brilliant
  1460.         4 channel music - that would be a great shame! There is truly an art in
  1461.         making a decent sound in as few channels as possible! (If you're new to
  1462.         this sorta thing, then it'll grow upon you...)
  1463.  
  1464.         For interest's sake...
  1465.          Channels are turned off internally under any of the following
  1466.          conditions:
  1467.           1) The end of a sample is reached (quite obvious)
  1468.           2) When the end of a volume envelope is reached, and the final
  1469.              envelope volume is 0
  1470.           3) When the fadeout value for a channel causes it to become silent.
  1471.           4) When a duplicate note is played when DNT is set to Note and DCA is
  1472.              set to cut for the instrument.
  1473.           5) When a notecut is issued (obvious)
  1474.           6) When a channel is moved to the background (using NNAs)
  1475.              AND the volume is 0.
  1476.  
  1477.          Out of all the functions provided for the Samples and Instruments,
  1478.          perhaps the only one that requires explanation is the "Update
  1479.          Pattern Data" function. This function was written for people who
  1480.          have already written music in MOD/S3M/MTM formats, and want to
  1481.          combine their percussion parts into a single instrument. The way
  1482.          to do this is to set up the instrument->note/sample table, and
  1483.          then use the "Update Pattern Data" function. What this does is
  1484.          search through all the patterns for all occurrences of the
  1485.          note/sample pairs that appear in the instrument->note/sample
  1486.          table, and replace it with the appropriate note/INSTRUMENT pair.
  1487.          Sounds quite complicated... sorry :)
  1488.  
  1489.                 Example:
  1490.                   If you originally have the following setup
  1491.  
  1492.                 Sample 1 = Bass Drum
  1493.                 Sample 2 = Snare Drum
  1494.                 Sample 3 = Closed Hihat
  1495.                 Sample 4 = Open Hihat
  1496.  
  1497.                   And the following column within any pattern:
  1498.  
  1499.                         C-5 01 ∙∙ .∙∙
  1500.                         C-5 03 ∙∙ .∙∙
  1501.                         C-5 03 ∙∙ .∙∙
  1502.                         C-5 03 ∙∙ .∙∙
  1503.                         C-5 02 ∙∙ .∙∙
  1504.                         C-5 04 ∙∙ .∙∙
  1505.                         C-5 01 ∙∙ .∙∙
  1506.                         C-5 04 ∙∙ .∙∙
  1507.                         C-5 01 ∙∙ .∙∙
  1508.  
  1509.                   You can combine these four samples into one instrument by
  1510.                   creating the instrument->note/sample table with the
  1511.                   following entries: (say for instrument 10)
  1512.  
  1513.                         C-5│C-5 01
  1514.                         C#5│C-5 ∙∙        <--- just an empty slot...
  1515.                         D-5│C-5 02
  1516.                         D#5│C-5 ∙∙
  1517.                         E-5│C-5 03
  1518.                         F-5│C-5 04
  1519.  
  1520.                   And using the update pattern data command will produce the
  1521.                   following
  1522.  
  1523.                         C-5 10 ∙∙ .∙∙
  1524.                         E-5 10 ∙∙ .∙∙
  1525.                         E-5 10 ∙∙ .∙∙
  1526.                         E-5 10 ∙∙ .∙∙
  1527.                         D-5 10 ∙∙ .∙∙
  1528.                         F-5 10 ∙∙ .∙∙
  1529.                         C-5 10 ∙∙ .∙∙
  1530.                         F-5 10 ∙∙ .∙∙
  1531.                         C-5 10 ∙∙ .∙∙
  1532.  
  1533.   2.6  Song Variables
  1534.  
  1535.         Most of the options on this screen should be quite obvious, but they
  1536.         are explained here for clarity.
  1537.  
  1538.         Song Name - should be obvious. Shove whatever you like in here :)
  1539.  
  1540.         Inital tempo - The tempo that the piece starts with. The tempo
  1541.                        calculation is explained under the set tempo
  1542.                        command (Txx)
  1543.  
  1544.         Inital speed - The speed that the song starts with. The speed
  1545.                        calculation is explained under the set speed
  1546.                        command (Axx)
  1547.  
  1548.         Global volume - This scales all the volumes in the song. It may be
  1549.                         necessary to change this value if there is overload
  1550.                         occuring (in the form of crackles in the music) -
  1551.                         especially on the Gravis UltraSound, as it is a
  1552.                         non-mixing device, and not scaled by the mixing
  1553.                         volume.
  1554.  
  1555.         Mixing volume - This value affects mixing sound devices (ie.
  1556.                         all Sound Blaster cards + PC Speaker).
  1557.  
  1558.         Separation - The separation determines how far apart the left/right
  1559.                      panning sounds. It is suggested that for a stereo
  1560.                      system (where the speakers are relatively close together)
  1561.                      that the separation be around its maximum (ie. 128).
  1562.                      For a stereo system where the speakers are placed a
  1563.                      large distance apart, a value of 80 may suit better.
  1564.                      A suggested separation for headphones is around 40.
  1565.                      This value has no significance unless stereo playback
  1566.                      is selected.
  1567.  
  1568.         Old Effects - When Impulse Tracker was first written, some effects
  1569.                       were interpreted differently from other formats, most
  1570.                       notably vibrato. When you turn this ON, then it effects
  1571.                       will be interpreted how the used to be in ST3/MMEdit/...
  1572.                       but when it's off, it'll operate how it use to in
  1573.                       previous versions.
  1574.  
  1575.                       Differences:
  1576.                        The Vibrato (and Tremelo) used in IT is smoother than
  1577.                        how it was implemented in MOD/S3M/etc. It is updated
  1578.                        EVERY frame and hence is independant of song speed,
  1579.                        whereas the standard vibrato WAS dependant upon song
  1580.                        speed. Vibrato is two times 'deeper' with Old Effects
  1581.                        on.
  1582.  
  1583.                        Sample offset commands past the end of a sample in IT
  1584.                        were ignored, whereas with Old Effects on, the sample
  1585.                        is played from it's end point.
  1586.  
  1587.         Control - This is the option that lets you use Instruments!
  1588.                   When Control Sample is selected, then all the instrument
  1589.                   information is ignored. The query to initialise
  1590.                   instruments, if accepted, will copy all the sample
  1591.                   names to the instruments (if the samples exist) and set
  1592.                   up the Note Translation Table for each instrument to point
  1593.                   to a sample.
  1594.  
  1595.         Playback - Mono: When you select mono playback, all stereo commands
  1596.                          are essentially ignored. If you are using a SBPro,
  1597.                          selecting Mono provides a higher quality output
  1598.                          than selecting Stereo and using a central pan.
  1599.  
  1600.                    Stereo: This is the option to go for!
  1601.                            Note that stereo mode requires more processing
  1602.                            power than mono (unless you have a GUS)
  1603.  
  1604.                            Also note that a bug with SB16 hardware interferes
  1605.                            with the floppy drive if you're SB16 is configured
  1606.                            to DMA 1 and set to stereo!
  1607.  
  1608.         Pitch Slides - Amiga: This is the mode to choose for compatibility
  1609.                               with S3Ms, MODs, MTMs... when you select
  1610.                               amiga pitch slides, you'll often have to
  1611.                               experiment to find the adequate slide value.
  1612.  
  1613.                      - Linear: With the linear slides, a certain slide value
  1614.                                will always cause the same music "interval"
  1615.                                change. An example of what this means is if
  1616.                                you slide up a note with speed 6 (ie. F06) at
  1617.                                speed 6, then the result will be that the
  1618.                                note is raised a tone. Everytime. So a C-4
  1619.                                will rise to a D-4, C-5 will rise to a D-5.
  1620.                                (It's not like this with amiga slides! A
  1621.                                C-4 *MAY* rise to a D-4, but if it does then
  1622.                                the C-5 will rise to a note around E-5!!)
  1623.  
  1624.                                The benefit of linear slides is that if you
  1625.                                slide a pair of notes at the same speed, they
  1626.                                will maintain the same interval (pitch
  1627.                                difference) throughout. Also, if you modulate
  1628.                                (transpose) a pattern, you will not have to
  1629.                                modify any slide values.
  1630.  
  1631.         Directories - this shows the current song/sample/instrument
  1632.                       directories. If you want to save the current directories
  1633.                       as the default to have on bootup, then press enter
  1634.                       on the Save button. Note that this save function also
  1635.                       saves the palette, keyboard type, info page layout
  1636.                       and pattern editing preferences to IT.CFG
  1637.  
  1638.   2.7  Scream Tracker 3 Users
  1639.      This section is just for users of Scream Tracker 3 who would like to know
  1640.      the differences between ST3 and IT without working through the whole
  1641.      document. In a nutshell:
  1642.  
  1643.      1) Differences in use.
  1644.         a) The Order List, Panning and Variables used to be on F1. In IT,
  1645.            F1 has been reserved for the Help Screen, F11 for the order list
  1646.            and panning, F12 for the variables.
  1647.            If you REALLY do find this too inconvenient, use the command line
  1648.            switch -k to swap the interpretation of the keys F1 and F11...
  1649.            no text will be updated tho (and it does seem sorta weird!)
  1650.         b) Samples now have associated Vibrato information and a global
  1651.            volume. The global volume affects all instances of the sample
  1652.            throughout the song. This is useful when you replace a sample,
  1653.            which is at a different volume from the original - you can just
  1654.            adjust the global volumes of the samples to suit.
  1655.         d) Block functions are no longer restricted to one column. This also
  1656.            means that when you copy entire patterns, you will have to go to
  1657.            the top left of the pattern. Also, you will have to set the number
  1658.            of rows in the destination pattern to the appropriate number if
  1659.            it is different from the source.
  1660.            This difference may take some getting used to - you may often
  1661.            find yourself doing several block functions in a single columns
  1662.            when you could actually have done it across the whole block!
  1663.          * To mark blocks, you can use Alt-B and Alt-E, or Shift+Movement *
  1664.         e) In the pattern editor, the following commands have changed:
  1665.             1) Alt-T : Track View has been upgraded. Alt-T will cycle
  1666.                        through all of the possible 5 viewmethods. You can
  1667.                        use Ctrl-1 to Ctrl-5 to quick select a view, or
  1668.                        Ctrl-0 to remove a view. Press Left-Ctrl+Shift 1->5
  1669.                        to select a 'different way to edit' :)
  1670.             2) Alt-X : Pressing Alt-X once will slide the effect data value
  1671.                        in a block (useful for controlling global volume,
  1672.                        panning or sample offsets in some cases). Pressing
  1673.                        Alt-X twice will cause all of the effect data to be
  1674.                        deleted as in Scream Tracker 3
  1675.             3) Alt-K : Pressing Alt-K once will slide the volumes. Pressing
  1676.                        Alt-K TWICE will remove all volume controls in the
  1677.                        block. (Works like Alt-X, but on the volume column)
  1678.             4) Alt-I : Cycle Template control.
  1679.             5) Alt-J : Volume amplifier. Select an amplification between
  1680.                        0 and 200%.
  1681.             6) Alt-H : Now toggles view divisions on/off. Makes it possible
  1682.                        to view/edit up to 36 channels in the pattern editor!!!
  1683.             7) Alt-Z : Originally the Zap command (if pressed twice)... now
  1684.                        it is effectively a "Block Cut" command. It will
  1685.                        copy the block into the clipboard, and then wipe the
  1686.                        block clean.
  1687.             8) Alt-V : Will set all the volumes in the block to the default.
  1688.             9) Alt-W : Will remove ALL volumes not attached to a
  1689.                        note/instrument Therefore, the old Alt-V command can
  1690.                        be simulated using Alt-V then Alt-W. The reason for
  1691.                        doing this was so that the Alt-K, Alt-W combination
  1692.                        would slide all the volumes with notes/instruments
  1693.                        associated.
  1694.  
  1695.         f) There is no chord edit feature in IT :(
  1696.         g) Patterns can be from 32 to 200 rows! (Under Pattern edit config)
  1697.         h) Pressing spacebar in the pattern editor will cause the previously
  1698.            entered note/instrument/volume/efffect/effectvalue to be entered.
  1699.            Quite convenient. Hopefully.
  1700.         i) In IT, Ctrl-F5 plays the song, Shift-F6 plays from the current
  1701.            order, Ctrl-F7 sets a playback mark, and F7 will play from it.
  1702.            F6 will play the current pattern. Of course, you can just use
  1703.            F5 to play the song if nothing else is playing. Ctrl-F6 in the
  1704.            pattern editor will play the current PATTERN from the current row.
  1705.         j) Alt-F10 now solos a channel instead of toggling all of the
  1706.            channels on/off. On the InfoPage, you can use 's' to solo
  1707.            channels, and 'q' to toggle channels. I felt that this was more
  1708.            usable than the alternative.
  1709.         k) The infopage itself has become upgraded... press PgUp/PgDn to
  1710.            cycle through view methods, "Insert" to add a window, "Delete"
  1711.            to remove the currently highlighted window, Tab to move between
  1712.            windows, Alt-Up/Down to move the base of the window up/down.
  1713.         l) To increase the sample frequency by an octave in the sample
  1714.            list, press Alt-Grey '+' or Alt-Grey '-' to decrease the
  1715.            frequency by an octave. To change it by semi-tones, use Ctrl-Grey
  1716.            '+' and Ctrl-Grey '-'
  1717.         m) The Sample library is accesible from all screens in the program
  1718.            by pressing Ctrl-F3. The Instrument library is accesible on
  1719.            Ctrl-F4.
  1720.         n) Each channel has an associated volume. Echoes can be created by
  1721.            just copying one channel onto another, then setting the "channel
  1722.            volume" (Command Mxx)
  1723.         o) When channels are muted, all commands are still interpreted, but
  1724.            the notes aren't played. What this means is that commands such
  1725.            as Axx, Bxx, Cxx, SBx, Vxx, Txx, Mxx, Nxx will be processed even
  1726.            if they are in a muted channel.
  1727.         p) Pressing Ctrl-Grey Plus and Ctrl-Grey Minus in the pattern
  1728.            editor will go to the next/previous pattern according to the
  1729.            order list!
  1730.         q) Samples have sustain loops + Ping Pong loops supported
  1731.         r) Note off command & Note cut command implemented... Note cut is
  1732.            exactly like ST3's ^^^ (and appears like it too!) Note off
  1733.            appears as "═══" and releases sustain points.
  1734.         s) You can enter panning values (between 0 and 64) in the volume
  1735.            column. Do this by pressing '`' to toggle between entry of
  1736.            panning/volume values.
  1737.         t) You can use samples >64k and 16 bit samples!!!
  1738.         u) When you use a skip value of 0, the cursor will move across to
  1739.            the next channel. This is a very convenient way to enter chords,
  1740.            especially when combined with the multi-channel selection (whack
  1741.            Alt-N twice)
  1742.  
  1743.      2) Differences in interpretation of notedata.
  1744.         a) Global volume changes will affect ALL of the notes playing. In
  1745.            ST3, global volume changes only affected new notes. The range
  1746.            for the global volume command is from 0 to 80h
  1747.         b) If you specify an instrument without a note, then in ST3, the
  1748.            volume is set to the default volume. In IT, the volume will be
  1749.            set to the default volume *IF* the instrument specified is the
  1750.            SAME as the currently playing instrument. Otherwise, the new
  1751.            sample will be played from it's beginning.
  1752.         c) Command X (Set panning, not REALLY implemented in ST3) now has
  1753.            range from 0 to 0FFh.
  1754.         d) Command C (Break to row) now works in HEX. This is so that you
  1755.            can jump to any row in the (next) pattern.
  1756.         e) New commands:
  1757.             1) M:   Set channel volume
  1758.             2) N:   Slide channel volume
  1759.             3) P:   Slide panning
  1760.             4) S7x: Instrument related controls (8 different controls here)
  1761.             5) S91: Surround sound on!
  1762.             6) W:   Global volume slide.
  1763.             7) X:   Set pan position.
  1764.             8) S5x: Set panbrello waveform and reset panbrello position
  1765.             9) Yxy: Panbrello
  1766.             10) S6x: Pattern delay for x frames.
  1767.         f) If you use the portamento to command (Gxx) to a different sample
  1768.            in ST3, the sample offset is undetermined. In Impulse Tracker,
  1769.            the sample will be played from it's start.
  1770.         g) The commands Hxx and Uxx will cause a vibrato half the depth
  1771.            of ST3 if "Old Effects" option is OFF and the vibrato in IT is
  1772.            also smoother than the vibrato in ST3.
  1773.  
  1774.      3) The greatest difference is the implementation of instruments. Read
  1775.         section 2.5 for more information.
  1776.  
  1777.      4) Saving S3M modules.
  1778.  
  1779.         The following guidelines have to be followed to compose 100%
  1780.         compatible S3M modules.
  1781.  
  1782.           General Stuff
  1783.             1) *Pitch slide mode MUST be amiga.
  1784.             2) *All initial channel volumes MUST be 64
  1785.             3) *No instruments functions can be used. If you ARE in
  1786.                 instrument mode, however, Impulse Tracker will translate
  1787.                 the pattern data according to the Note Translation Tables.
  1788.             4) The song message is *NOT* saved in S3M format.
  1789.  
  1790.           Pattern stuff
  1791.             1) *The total number of patterns MUST NOT exceed 100.
  1792.             2) *The number of rows in each pattern MUST be 64
  1793.             3) *Data is only translated within the first 16 channels.
  1794.             4) *All notes must lie within the range of C-1 to B-8
  1795.             5)  Several commands will not be interpreted by a standard
  1796.                 S3M player (viz. Mxx, Nxx, Pxx, S7x, S91, Wxx, Yxx).
  1797.                 Also, you should have Old Effects (on the variable list)
  1798.                 put to *ON* if you want to write S3M files.
  1799.             6) *Panning controls in the volume column are NOT stored.
  1800.  
  1801.           Sample stuff
  1802.             1) *No sustain or ping pong loops can be used
  1803.             2) *No sample vibrato can be used
  1804.             3) *The sample global volume must be 64.
  1805.  
  1806.             4) The Scream Tracker 3 module format supports 16 bit samples
  1807.                 and samples >64k although the actual program did NOT.
  1808.                 Note that *MOST* players probably ignore these fields
  1809.                 and it is likely that the module will NOT be played correctly
  1810.                 by a standard S3M player if it contains samples >64k and/or
  1811.                 16 bit samples.
  1812.  
  1813.         All conditions with an asterix preceding them are checked at save
  1814.         time.
  1815.  
  1816.         Note that both note off (═══) and note cut (^^^) will get translated
  1817.         to a note cut (^^^) in S3M format.
  1818.  
  1819.  2.8  Gravis UltraSound users.
  1820.  
  1821.         For the Gravis UltraSound users, there are some limitations that are
  1822.         outlined here. The GUS is a great card - unfortunately, I think I've
  1823.         pushed the limits of what tracker's are supposed to be able to do.
  1824.  
  1825.         I've already mentioned a few things throughout the DOC about the
  1826.         Gravis UltraSound, but I'll reiterate them here with a few more points.
  1827.  
  1828.         1) The maximum number of notes that you CAN play with a GUS is 32.
  1829.            This was incorporated by effectively limiting the number of active
  1830.            channels to 32. So if you play a 64 channel song which is using
  1831.            control:Samples, then you will LOSE the last 32 channels. If you
  1832.            are playing a 64 channel song with control:Instruments, you shouldn't
  1833.            miss out on too much. This shouldn't really be a problem in 99.9%
  1834.            of the cases, as I don't know of any song which uses more than 32
  1835.            channels, anyway.
  1836.  
  1837.         2) The GUS playback quality is dependent on the maximum limit of active
  1838.            channels. The GUS can be initialised to play anywhere between
  1839.            14 and 32 channels. Values above 32 are reduced to 32, and values
  1840.            below 14 are increased to 14. The lower the number of channels, the
  1841.            higher the playback quality. (14 channels will give 44100 Hz, with
  1842.            16-bit interpolation - very, very nice quality!). The default
  1843.            GUS driver dynamically chooses a particular number of channels.
  1844.            This doesn't ALWAYS work with all cards, so if you don't like the
  1845.            transition of sample quality as the channels increase, or your
  1846.            GUS seems to stop notes unexpectedly, use the other driver(s).
  1847.  
  1848.         3) The GUS routines occupy less memory than the mixing routines. You
  1849.            will have about 60k more of memory to play around with.
  1850.  
  1851.         4) The GUS memory allocation routines are very simple and not very
  1852.            versatile. When you are working through the sample library, samples
  1853.            are NOT always deallocated when you move on to the next sample! If
  1854.            you get the message "Out of GUS memory", then it may be necessary to
  1855.            press Ctrl-G (or select Reload Gravis from the samples menu) to
  1856.            reorganise the samples in memory. Sorry about the inconvenience.
  1857.  
  1858.         5) Changing the mixing volume does NOT affect the Gravis. It may be
  1859.            necessary to reduce the global volume to remove crackle, if the
  1860.            GUS is overloading.
  1861.  
  1862.         6) The surround sound option will cause the sample to be played with
  1863.            a central panning. This is because I don't know how to get the
  1864.            GUS to do surround sound without wasting a lot of GUS memory.
  1865.  
  1866.         7) The panning positions are reduced to a scale of 0->15 in the GUS,
  1867.            so fine alterations in the panning may go unnoticed.
  1868.  
  1869.         8) You WILL hear TRUE 16-bit samples on a GUS!! (This is something
  1870.            that doesn't happen on the mixed devices). But the GUS does have
  1871.            some limitations on the boundaries that 16-bit samples can be
  1872.            placed, so your GUS Memory free indicator may sometimes drop more
  1873.            than expected.
  1874.  
  1875.  3. Before you write to me. (Important notes)
  1876.  
  1877.     I would very much like to get feedback on this program, but I am already
  1878.     aware of several problems (?).
  1879.  
  1880.     1) If you're going to write because the program looks 'too' much like
  1881.        Scream Tracker 3, then don't :) I've used Scream Tracker. I loved
  1882.        using it - it was the best, easiest, most convenient program ever,
  1883.        so why not adopt it's design?????
  1884.  
  1885.     2) The program could easily crash if you try to load a corrupted
  1886.        module. If you've got some modules that you know are corrupted, try
  1887.        to resist the temptation of testing the stability of the program....
  1888.        in many cases it'll die :)
  1889.  
  1890.     3) A couple of people have asked about ASCII characters > 128. I'm
  1891.        sorry - I can't let you have 'em on anywhere else except the message
  1892.        editor. The reason is because I've used a lot of the characters for
  1893.        'graphics' - real time character generation. (the ASCII characters >
  1894.        128 don't really exist anymore)
  1895.  
  1896.     4) If you 'overload' your CPU... the subsequent playback can also
  1897.        become distorted! To fix this, reinitialise your sound driver with
  1898.        Ctrl-I.
  1899.  
  1900.     5) The help screens have only been defined for the following screens:
  1901.         a) Pattern Editor
  1902.         b) Sample List
  1903.         c) Instrument List
  1904.         d) Info Page
  1905.         e) Order list and panning
  1906.         f) Order list and channel volumes
  1907.         g) Message editor
  1908.  
  1909.        I didn't think it necessary to include help screens for the other
  1910.        screens, but if you feel strongly about including help on certain
  1911.        points/screens, then I suppose I could make the effort...
  1912.  
  1913.     6) If you have a bug to report, please check through BUGS.DOC first to
  1914.        see if it's listed, and also check through this document - the problem
  1915.        may be in the understanding of how the program works! Otherwise,
  1916.        contact me, AND LET ME KNOW WHAT VERSION YOU ARE USING!
  1917.  
  1918.     7) Any further GUS click removal is very difficult to achieve. ST3's
  1919.        GUS click removal requires double the number of channels on the GUS
  1920.        to be used and I can't allocate any more!
  1921.  
  1922.  
  1923. You can contact me by writing to:
  1924.         Jeffrey Lim
  1925.         9 Wilgena Avenue
  1926.         Myrtle Bank
  1927.         South Australia  5064
  1928.  
  1929. EMail account:
  1930.   pulse@student.adelaide.edu.au
  1931.  WARNING!!!
  1932.   If you ask me anything which is obviously contained within this document or
  1933.   the FAQ, I will reply with RTFM (Read the #$%@#$% Manual). Sorry, but I hate
  1934.   idiots who can't be bothered to take their time to have a quick look through
  1935.   this document and write to me with stupid messages which have recently become
  1936.   a chore to answer (You'd understand if you received 4000+ EMails...)
  1937.  BUT!
  1938.   If there *is* something that you HAVE made an effort to understand/look for,
  1939.   then don't hesistate to write to me. The worst that can happen is that I
  1940.   reply with RTFM :)
  1941.  ALSO
  1942.   If you have an incorrect reply-address, don't expect to receive anything.
  1943.   If you are reporting a bug, let me know what version you are using.
  1944.  
  1945.   If you find any major problem with the tracker, please try to find the
  1946.   circumstances which cause it to trigger - if you can't, don't worry - write
  1947.   to me anyway. It's just that it's much easier if I know a likely cause of
  1948.   the error. (Don't worry if it seems that the cause is very, very remote -
  1949.   I had a problem in my GUS playback routines which originally caused my
  1950.   palette configuration screen to hang - now that's obscure!)
  1951.  
  1952.   Send money! I don't demand that you send me anything, (and I don't like
  1953.   spoiling a program by shoving in reminder messages), but if you *DO* use
  1954.   the program and think that it's worth contributing a small amount towards,
  1955.   then please do so... it would be GREATLY appreciated. Remember.... even a
  1956.   few dollars will be appreciated! It's very unlikely that I'll make a huge
  1957.   profit (I doubt I could get close to sufficient money from this program to
  1958.   make it even worth $1 for every hour I put in!). I won't be sending out any
  1959.   nice thankyou notes, or bound manuals... but I will include your names in
  1960.   the future versions of the tracker and I will EMail you each new version the
  1961.   minute the are released if you wish.
  1962.  
  1963.   I believe that software *SHOULD* be cheap - you've spent perhaps a few
  1964.   thousand getting your computer, so you wouldn't want to spend TOO much
  1965.   more on programs! If you think this program is worth $5, then send $5.
  1966.   If you think it's worth $10, then send $10. If you think it's worth
  1967.   $1,000,000,000... don't let me stop you :)
  1968.  
  1969.   So... get together with a couple of friends and send me $10... If you send
  1970.   me a significant amount, I'll put together a "special contributor's" list..
  1971.   (Oeeerrrrr :) )
  1972.  
  1973.   Methods of payment:
  1974.     Bank cheque
  1975.     Cash (Make sure it's securely wrapped!) - it doesn't have to be Australian
  1976.           currency, although it'd be nice if it could be!
  1977.  
  1978.  
  1979.  4. For the software programmers & hardware manufacturers
  1980.  
  1981.   4.1 Programmers
  1982.  
  1983.   The technical specs for the IT format can be found in the file, ITTECH.DOC,
  1984.   which should be in the archive in which you found this document.
  1985.  
  1986.   If you decide to write a player, and need any help/clarification of the
  1987.   format, then don't hesitate to write to me!
  1988.  
  1989.  
  1990.   4.2 Manufacturers
  1991.  
  1992.   At the moment, the hardware support for the tracker has been limited to:
  1993.         PC Speaker
  1994.         Sound Blaster 1.xx
  1995.         Sound Blaster 2.xx
  1996.         Sound Blaster Pro
  1997.         Sound Blaster 16
  1998.         Sound Blaster AWE 32
  1999.         Gravis UltraSound
  2000.         Interwave
  2001.         Pro Audio Spectrum
  2002.         Pro Audio Spectrum 16
  2003.         Windows Sound System
  2004.         DAC on LPT
  2005.  
  2006.   If you would like me to support another soundcard (which isn't compatible
  2007.   with an existing driver, or if it has it's own, special native mode), then
  2008.   send a sound card AND a copy of the Software Developers Kit. I will *try*
  2009.   my best to incorporate them into the program if you do this (but there's
  2010.   the limitation of design difficulties - which shouldn't cause any problems
  2011.   in 99% of the cases.)
  2012.  
  2013.  
  2014.  5. Closing Words
  2015.  
  2016.     I would like to thank the following people:
  2017.  
  2018.         Psi: For introducing me to tracking with the brilliant Scream Tracker 3
  2019.         Purple Motion: For being my music hero.... I still think
  2020.                        "When the Heaven's Fall" is *THE* best S3M ever written.
  2021.         Red Haze: For constantly bugging me to get the tracker done, and for
  2022.                   his effort in testing out the program and making suggestions.
  2023.                   (He's directly responsible for the inclusion of Ping Pong
  2024.                   loops - I originally couldn't be bothered :) )
  2025.                   Also extensive testing of later versions of IT...
  2026.         The WALKER: For his flow of ideas & beta testing and getting the PoP
  2027.                     DiskMag finished.... tomorrow. Or is that next week?
  2028.                     OK... so he has done it. Finally.... 6 months late. :)
  2029.         Perception: For his constant support over the many years he ran his BBS
  2030.         Psibelius: For being the nice friendly Epinicion founder that he is.
  2031.         Dominic: For his thoroughness in beta testing the program, and providing
  2032.                  suggestions. (He came up with more than double the number of
  2033.                  suggestions than almost anyone else... even though many of
  2034.                  them were not finally implemented)
  2035.         Chris Jarvis: For his effort in beta testing the tracker and producing
  2036.                       Firestorm (released with v1.00 of the tracker)
  2037.                       Pale Dreams! (released with v1.01 of the tracker)
  2038.                       Firepower (released with v1.03 of the tracker)
  2039.                       Sidewalk (released with v1.05 of the tracker) and
  2040.                       Fallen World (released with v2.01 of the tracker)
  2041.                       These are ALL amazing pieces of work! (Yes, I'm jealous!)
  2042.         Zilym Limms: For his technical help with the tracker and his love of
  2043.                      Fast Tracker 2. Hahaha. :)
  2044.                      Also for his information and source code for the PAS 16.
  2045.         Benjamin Bruheim: For his super list of contributions to v1.01
  2046.         ZaStaR: For his effort in putting together ITF - the font customiser!
  2047.                 Also for being the willing target of a barrage of beta
  2048.                 versions, a great contributor of ideas, a musician with whom
  2049.                 I could exchange work and for being a great dude all round!
  2050.         Emmanuel Giasson: For creating the utilities MMCMP/MMUNCMP/MMTSR -
  2051.                           the music module compressor!
  2052.         Diablo: For creating the Impulse Tracker directories on ftp.cdrom.com!
  2053.         Siren: For providing me a contact to obtain an Interwave card!
  2054.         AMD: For providing me with an Interwave card to program for!
  2055.  
  2056.         To the other beta testers:
  2057.             Eric Bonython               Phorte
  2058.             Alistair Watts              Julian Ellis
  2059.             Alex Bates                  David Rohrsheim
  2060.             Delta X                     GD (Grave Digger)
  2061.             Andy Chen                   ShawnM
  2062.             Clef                        Emmanuel Giasson
  2063.             KXMode
  2064.  
  2065.         And anybody there who uses this program!!!
  2066.  
  2067.         Big thanks and thumbs up to Advanced Gravis for releasing their
  2068.         Software Developer's Kit (SDK) free of charge!
  2069.  
  2070.         Congratulations to Creative Labs for finally releasing their SDKs
  2071.         free of charge!
  2072.  
  2073.         Especially *BIG* thanks to AMD for providing me with an Interwave
  2074.         card to use and the SDK!
  2075.  
  2076.         Finally... I have a request.....
  2077.          If *YOU* write something with this program... share it with the
  2078.          rest of the world!!!
  2079.  
  2080.          If you have an iNet account, you can upload your songs to:
  2081.            ftp.cdrom.com/pub/demos/incoming/music/songs/it
  2082.            - remember to use a *lower* case filename and to also upload
  2083.              a short description of your song in a .txt file
  2084.  
  2085.          If you know of any other places where modules can be uploaded to,
  2086.          let me know and I'll include them in the above list.
  2087.  
  2088.  6. How to get the latest version of Impulse Tracker
  2089.  
  2090.     There are several places around the internet where you can find the
  2091.     latest version of Impulse Tracker:
  2092.  
  2093.         1) ftp.cdrom.com/pub/demos/incoming/music/programs } Check (1) first!
  2094.         2) ftp.cdrom.com/pub/demos/music/programs/trackers }
  2095.  
  2096.         3) http://www.citenet.net/noise/it
  2097.                 - American homepage
  2098.         4) http://cyburbia.bns.com.au/pages/clients/impulse.html
  2099.                 - Australian homepage
  2100.             Note: This *SHOULD* be updated regularly, but I've had troubles
  2101.                   logging on recently
  2102.         5) http://huizen.dds.nl/~im-pulse
  2103.                 - European homepage
  2104.         6) ftp://sdc.wtm.tudelft.nl/pub/music/utils/it
  2105.                 - ftp site!
  2106.  
  2107.     If you want to have the latest version sent to you via EMail, or at least
  2108.     be notified of new releases, then you'll have to send $omething to me :)
  2109.     Check section 3 on how to contact me.
  2110.  
  2111.  
  2112.  7. Legal stuff
  2113.  
  2114.     No matter what happens, no matter how bad, I'm not going to be held
  2115.     responsible.
  2116.  
  2117.     That's basically the same as any other license agreement, except you
  2118.     should be able to understand this one without an interpreter :)
  2119.  
  2120.     YOU MAY NOT CHARGE ANYTHING FOR THIS PROGRAM - DISTRIBUTORS WHO
  2121.     ARE INTERESTED IN THIS PROGRAM MUST WRITE TO ME FIRST AND HAVE MY
  2122.     APPROVAL! (yeah, even by snail mail if you don't have EMail access).
  2123.  
  2124.     USE OF THIS PROGRAM COMMERCIALLY IS EXPRESSLY FORBIDDEN WITHOUT WRITTEN
  2125.     AND SIGNED APPROVAL FROM ME. COMMERCIAL USE INVOLVES ANY USE OF IMPULSE
  2126.     TRACKER IN WHICH MONEY IS INVOLVED (SPECIFICALLY THE CREATION OF ANY
  2127.     MUSIC WHERE PAYMENT IS INVOLVED). THIS PROGRAM IS ONLY FREEWARE FOR
  2128.     NON-COMMERCIAL USE.
  2129.