home *** CD-ROM | disk | FTP | other *** search
/ Large Pack of OldSkool DOS MOD Trackers / gustr103.diz < prev    next >
Text File  |  1996-01-01  |  17KB  |  412 lines
  1.  
  2.  
  3.  
  4.  
  5.                              GUSTRACK 1.03
  6.                             --------------- 
  7.                                 Made By
  8.                             EJ Botterman jr.
  9.                              Uranuslaan 26
  10.                            3318 EV Dordrecht
  11.                             The Netherlands
  12.  
  13.  
  14.  
  15.                       1 ............ Introduction 
  16.                       2 ............ Legal Stuff
  17.                       3 ............ Keys and Buttons
  18.                       4 ............ Special Effects
  19.                       5 ............ File Formats & Bugs
  20.                       6 ............ Thanks
  21.                       7 ............ Trouble Shooting
  22.                       8 ............ Technical Info
  23.  
  24.  
  25. Introduction:
  26.      Welcome to gustrack. Gustrack is a ProTracker compatible
  27.      4 track mod editor for the Gravis UltraSound music card.
  28.      This means you can load, save and edit standard modfiles.
  29.      Its also possible to load and play 8 track mod's but it is
  30.      NOT possible to save or edit one.
  31.  
  32.      To use gustrack you'll need atleast a 286 computer but a 386
  33.      is recommended.
  34.      You need a MicroSoft compatible mouse.
  35.      You need a Gravis UltraSound card.
  36.      You need a VGA card and monitor.
  37.  
  38.  
  39. Legal Stuff:
  40.  
  41. Disclaimer:
  42.      EJ Botterman  specifically  disclaims  all  warranties,  expressed  or
  43.      implied,   including  but  not  limited  to  implied  warranties  of
  44.      merchantability  and  fitness  for a particular purpose with respect
  45.      to  defects  in  the  software  and  documentation.
  46.      In no event shall EJ Botterman be liable for  any  loss  of  profit
  47.      or  damage, including but not limited to special,  incidental,
  48.      or consequential damages.
  49.  
  50. CrippleWare:
  51.      Gustrack is not cripple ware. What you see is what you get.
  52.      all functions in the registered version perform the same way
  53.      as in the not registered version.
  54.      You may use this program for 30 days after that you MUST register !!
  55.      You will then receive you personal copy.
  56.  
  57.      Shareware programs  lacking  so  many  features  that  they
  58.      become useless to the user are called CrippleWare.
  59.      Since i do not believe in the idea of CrippleWare i distribute
  60.      the complete version. You may call it stupid but atleast its fair !!
  61.  
  62.      GusTrack is  a  Shareware  program.  This yields the following
  63.      rules:
  64.  
  65.      You are  allowed  to  test  GusTrack  for a period of 30 days
  66.      after  receipt,  to  see  if it fits your needs. After
  67.      this  period  you  are  not  allowed  to  use the program any
  68.      further.
  69.  
  70.      Whomever gets  himself  another version of GusTrack to get
  71.      himself  another  30 days of testing incurs penalty ( ever
  72.      seen a HardDisk disintegrating to stardust? ).
  73.  
  74.      GusTrack may  be  freely distributed, even after expiration of
  75.      the testing period.
  76.  
  77.      Even Shareware-Distributors    or    dealers,    who    are
  78.      distributing  Shareware  by  mail,  may  put  GusTrack  in their
  79.      collection.   The   same  is  valid  for  other  distribution
  80.      channels.
  81.      If you do it please send me a note so i know.
  82.  
  83.      GusTrack may  not  be used commercially in the testing period.
  84.      This includes  single  sale and bundling with other soft- or
  85.      hardware.   Exceptions may be granted after contacting me. If
  86.      I agree, I will send you a written permission.
  87.  
  88.      GusTrack may  be  used  for  display  purposes, as long as the
  89.      source of the program can be recognized unmistakably.
  90.  
  91.      GusTrack may  not  be  modified  and  this  is  valid  for the
  92.      distribution  archive,  too. This includes adding advertising
  93.      textfiles for BBS or something like that to the archive.
  94.  
  95.      Disassembling GusTrack  does  *not*  incur  penalty.  But when
  96.      using my routines, please state the original author.
  97.      Saying this i have to be fair and say i took a big look on some
  98.      of the GUS hardware routines made by Joshua Jensen.
  99.      And that the above text was written by the author of WOWII,
  100.      a great modplayer for the SB(pro) and DACS.
  101.      ( Not for the GUS though :-(  )
  102. -------------------------------------------------------------------------------
  103. How do I register you ask ?
  104.  
  105.       To register send me $20, or the same amount in your
  106.       currency (NO COINS !!!) and a self-addressed envelope including a
  107.       disk but without a stamp to me.
  108.       Also include a piece of paper stating your name, address and GusTrack
  109.       version so if you ever ask for an update i'll now its you.
  110.       You'll then receive a personal copy of GusTrack and you are entitled to
  111.       upgrades for a minimal price, this means for free when you
  112.       pick it up by modem or for the costs of sending it by mail.
  113.  
  114.     Dutch users: speciale prijs, maar f25,- !
  115.  
  116.       You can also send me the money only and then download the program
  117.       from MultiByte BBS.
  118.       If you want this, include in your letter the password and name
  119.       you want to use to login, and as soon as i have received your money
  120.       GusTrack is ready for you to download.
  121.       You must login to the BBS, this means you can't request it with a
  122.       Fido Mailer.
  123.  
  124. -------------------------------------------------------------------------------
  125. Address:
  126.                 EJ Botterman jr.
  127.                 Uranuslaan 26
  128.                 3318 EV Dordrecht
  129.                 The Netherlands
  130.  
  131.                Fido Address:   2:285/306.4
  132.              Multi-Byte BBS:  +31-78-190355
  133. -------------------------------------------------------------------------------
  134.       If you don't send me the right amount of money you will receive nothing
  135.       and you are never entitled to a refund. I will let you know though.
  136.  
  137. Newest Version:
  138.       You can find the newest version of this program on MultiByte BBS and
  139.       on BBS Geniaal II both are in the Netherlands.
  140.       Phone Numbers:
  141.                     Multi-Byte BBS +31-78-190355    ( V32bis )
  142.                     Geniaal II     +31-2290-43038   ( V32bis )
  143.                                    +31-2290-45816   ( V32bis )
  144.  
  145.  
  146. Keys and Buttons:
  147.      If you are familiar with another tracker you'll have no
  148.      problem using GusTrack.
  149.      If you have never used a tracker before try to get hold of a
  150.      program called ModEdit ( written by Mark J. Cox ).
  151.      It will probably not run on your GUS but it has a great
  152.      manual describing all facets of MOD files.
  153.  
  154. Buttons:
  155.      Buttons are used by moving the mouse onto them and click the
  156.      left mouse button.
  157.  
  158.      Most buttons explain themselves so i won't go into them.
  159.      Also read the GusTrack.Rev file for some features.
  160.      Just follow a few general 'rules'.
  161.  
  162.      The left mouse button is used to press and release the
  163.      buttons on the screen.
  164.      Everywhere there is something to be typed, a filename, the
  165.      names of samples or the song name, click the right mouse button onto
  166.      it and a cursor will appear.
  167.      While playing the right mouse button will stop the playing.
  168.  
  169. Notes:
  170.      Samples must have the extension .SMP to appear in the
  171.      diskwindow. It is possible to load a sample with a different
  172.      extension by typing in the filename of the sample. The same
  173.      goes for MOD files and the extension .MOD
  174.  
  175.      The loading of a sample may take some time because other
  176.      samples might have to be shifted inside the GUS memory to
  177.      make some space. This takes some time. As soon as the
  178.      loading is finished you can move the mouse arround and the
  179.      name appears in the sample window.
  180.      Gustrack does not check if there's enough memory on the GUS left
  181.      to load the sample, so if there is'nt the result will probably be
  182.      that you can't hear the sample.
  183.      Also for GUS owners who are still working with 256K DRAM i would like
  184.      to advice you to update the memory to 1 Meg since alot of Mod files
  185.      exceed the 256K border in samples.
  186.  
  187.      Also do yourself a favor and save your mod file after
  188.      changing samples because the memory on the GUS might be
  189.      fragmented. This means that a sample could take much more space
  190.      than it needs.
  191.      After saving it reload it and continue editting your MOD file.
  192.  
  193. Configuration File:
  194.      Version 1.03 and up use a configuration file called GusTrack.Cnf
  195.      This file will be made when you press the Save Cnf button.
  196.      Inside this file will be saved :
  197.                                      - The current Module Directory
  198.                                      - The current Sample Directory
  199.                                      - The Master Volume
  200.                                      - The Panning settings
  201.      On startup GusTrack will search for this file. If it cant find it
  202.      GusTrack will default to the current directory as Module and Sample
  203.      directory, the master volume will be 50 and the panning for channel 1
  204.      till 4 will be in the middle.
  205.  
  206.      
  207. Keys:
  208.      With the keyboard you can play notes. You won't hear a note
  209.      if the cursor is not on a note position inside a track.
  210.      A track looks like this :
  211.  
  212.     Note 
  213.      \_ Sample 
  214.      | | ||
  215.      C-3 01234
  216.            |||
  217.           Effect
  218.  
  219. Special Keys:
  220.  
  221.      Escape - Will get you out of most windows also used to quit
  222.               the program and stop playing.
  223.  
  224.   Space Bar - When playing it will stop the playing. When not
  225.               playing it will toggle Edit.
  226.  
  227.   The key left to the 1 (`) is used to shell to DOS. It is possible to
  228.   shell while playing. It is not possible to shell when you are in the
  229.   Disk or Mixer window.
  230.  
  231.          F1 - Low Octave
  232.          F2 - High Octave
  233.  
  234.          F5 - After editting a note or command the cursor will
  235.               not advance to the next line in the pattern.
  236.          F6 - Cursor will advance 1 line.
  237.          F7 - Cursor will advance 2 lines.
  238.          F8 - Cursor will advance 4 lines.
  239.  
  240.         Tab - Advance cursor to next track.
  241.   Shift+Tab - Advance cursor to previous track.
  242.  Arrow keys - Move the cursor arround.
  243.   Page Down - Advance cursor 8 lines.
  244.   Page Up   - Go 8 lines up.
  245.   Home      - Go to line 00.
  246.   End       - Go to line 63.
  247.  
  248. L.Shift + Arrows - Go forward or backwards in the song.
  249. L.Ctrl  + Arrows - Go to next or previous pattern.
  250.  
  251.  Right Alt  - Play Pattern.
  252.  Right CTRL - Play Song.
  253. It is possible while playing to change from play pattern to play
  254. song and vice versa. (buttons will not be updated !)
  255.  
  256.  Right Shft - Record Pattern. ( not very accurate )
  257.  
  258.  
  259. Editing keys:
  260.      Insert     -   Insert position.
  261.      Delete     -   Clear position.
  262.      Back Space -   Move track up 1 row deleting the row above.
  263.      
  264.      Shift F3   -   Cut Track (copy track to buffer and clear)    
  265.                               (track.                        )
  266.      Shift F4   -   Copy Track    (to buffer)
  267.      Shift F5   -   Paste Track   (from buffer)
  268.  
  269.      Ctrl  F3   -  Cut Pattern
  270.      Ctrl  F4   -  Copy Pattern
  271.      Ctrl  F5   -  Paste Pattern
  272.  
  273. Special Effects:
  274.  
  275. Protracker V1.1b Effect Commands
  276. ----------------------------------------------------------------------------
  277. 0 - Normal play or Arpeggio             0xy : x-first halfnote add, y-second
  278. 1 - Slide Up                            1xx : upspeed
  279. 2 - Slide Down                          2xx : downspeed
  280. 3 - Tone Portamento                     3xx : up/down speed
  281. 4 - Vibrato                             4xy : x-speed,   y-depth
  282. 5 - Tone Portamento + Volume Slide      5xy : x-upspeed, y-downspeed
  283. 6 - Vibrato + Volume Slide              6xy : x-upspeed, y-downspeed
  284. 7 - Tremolo                             7xy : x-speed,   y-depth
  285. 8 - NOT USED
  286. 9 - Set SampleOffset                    9xx : offset (23 -> 2300)
  287. A - VolumeSlide                         Axy : x-upspeed, y-downspeed
  288. B - Position Jump                       Bxx : songposition
  289. C - Set Volume                          Cxx : volume, 00-40
  290. D - Pattern Break                       Dxx : break position in next patt
  291. E - E-Commands                          Exy : see below...
  292. F - Set Speed                           Fxx : speed (00-1F) / *tempo (20-FF)
  293. ----------------------------------------------------------------------------
  294. *E0- Set Filter                          E0x : 0-filter on, 1-filter off
  295. E1- FineSlide Up                        E1x : value
  296. E2- FineSlide Down                      E2x : value
  297. E3- Glissando Control                   E3x : 0-off, 1-on (use with tonep.)
  298. E4- Set Vibrato Waveform                E4x : 0-sine, 1-ramp down, 2-square
  299. E5- Set FineTune                        E5x : set fine tune value
  300. E6- Jump to Loop                        E6x : jump to loop, play x times
  301. E7- Set Tremolo Waveform                E7x : 0-sine, 1-ramp down. 2-square
  302. E8- NOT USED
  303. E9- Retrig Note                         E9x : retrig from note + x vblanks
  304. EA- Fine VolumeSlide Up                 EAx : add x to volume
  305. EB- Fine VolumeSlide Down               EBx : subtract x from volume
  306. EC- NoteCut                             ECx : cut from note + x vblanks
  307. ED- NoteDelay                           EDx : delay note x vblanks
  308. EE- PatternDelay                        EEx : delay pattern x notes
  309. *EF- Invert Loop                         EFx : speed
  310. ----------------------------------------------------------------------------
  311.  
  312. All effects are implemented except the ones starting with a *. (E0 & EF)
  313.  
  314. File Formats:
  315.      GusTrack will read 4 track ProTracker files and also Star Tracker files.
  316.      ( ID's M.K. and FLT4 )
  317.      And it will read 8 Track Mod files made with Tritons Fast Tracker the
  318.      Star Tracker or the Octalyzer.
  319.      ( ID's 8CHN, FLT8 and OCTA)
  320.      ( Does anyone know if the FLT8 format really excists ?)
  321.  
  322.      If it can't find one of the ID's it will assume its an old 15 sample
  323.      mod file.
  324.  
  325.      When an error is encountered while reading you'll see the border round the
  326.      screen turn red for a very short period of time.
  327.      It has then refused to read the patterns and samples from the so called
  328.      Mod file.
  329.      The header is read though and you'll see some strange ASCII characters
  330.      in the sample window as sample names.
  331.  
  332. Bugs:
  333.      Probably :-)
  334.      If you found one please write me a NetMail so i can correct it in future
  335.      versions.
  336.      Also try to describe the situation when the bug took place and what was
  337.      loaded in memory (TSR's Device drivers etc..)
  338.  
  339.  
  340. Thanks:
  341. -   Special thanks go out to the Renaissance demo group for the info
  342.      on programing the GUS.
  343. -   Also to Gravis and Forte for giving out the excellent SDK
  344.      and for making the GUS itself ofcourse.
  345. -   To Joshua Jensen for the awesome mod player GUSMOD. (only BPM is missing)
  346. -   Mr. Triton for his Fast-Tracker, the best tracker there is.
  347.      (But it does'nt work on my GUS sniff! :-(  )
  348.  
  349.  
  350. Trooble Shooting:
  351.  
  352.    -  The edit window does'nt scroll smoothly with fast Mod's.
  353.       This is because your computer is too slow. Since GusTrack runs in
  354.       graphics mode it takes more time to put everything on the screen
  355.       then it would using text mode.
  356.       Try to solve it by turning off the bar's.
  357.       If it's still not running smoothly and your computer is not an 12 or 10Mhz
  358.       286 report it to me.
  359.  
  360.  
  361.    -  GusTrack only displays a message saying :
  362.                               Could Not Find A Gravis UltraSound.
  363.  
  364.  
  365.       This means you either don't have a gus in your computer or
  366.       GusTrack can't find it.
  367.       If you have this problem and you do have a GUS please report it to me
  368.       with your GUS setup ( IRQ DMA Port etc etc).
  369.  
  370.    -  GusTrack only displays a message saying :
  371.                               This Program Needs a Mouse.
  372.       
  373.       Means you don't have a mouse or a mouse not microsoft compatible.
  374.  
  375.  
  376.    -  GusTrack only displays a message saying :
  377.                                Sorry, this program requires a VGA card.
  378.  
  379.       GusTrack could not find a VGA card. If you get this message please report
  380.       it with your brand and type of VGA card.
  381.  
  382.    -  When I switch of the bars, the window goes away but some of
  383.       the bars stay.
  384.  
  385.       I know this problem and i haven'th been able to solve it (yet).
  386.       Try turning off the music and then push the Bars button.
  387.  
  388.    -  GusTrack won't save my MOD file !!!
  389.  
  390.       You cannot save an 8 Track's mod file.
  391.       If you did'nt try to save an 8 Track mod file and GusTrack is
  392.       still refusing to save your Mod file it is likely that something
  393.       has changed the program itself.
  394.       Please send me the GusTrack.Exe file so i can see who or what has
  395.       messed up my program.
  396.  
  397.  
  398.  
  399. Techical Info:
  400.  
  401.      GusTrack is made using   - Borland C++ 3.0  (only C used though)
  402.                               - TASM 3.2
  403.                               - QEMM 6.02
  404.                               - A 386SX 20Mhz computer.
  405.                               - ± 12003827482 cigarettes
  406.                               - coffee !!!!
  407.                               - a few months of time whitch should have
  408.                                 been used for my study.
  409.  
  410.  
  411.  
  412.