CMOD.DOC

                         CapaMod 3.04 documentation file
            Copyright (c) 1993-1996 Heikki Ylinen (flap / Capacala)

     1. INFO

   CapaMod 3.x is capable of playing MODs, S3Ms and XMs through Gravis Ultra-
 Sound. It uses CapaPlay ][ which is included in CAPAPLA2.ZIP.

     2. THE USAGE

   First of all,  you must have  ULTRASND environment  variable set.  CapaMod
 won't work without it. And if you still encounter some problems, please make
 sure that you have installed the ULTRINIT, although it is not necessary.
   If you encounter some problems  with GUS IRQ, use the option /TMR to force
 CapaMod to use  system timer  instead of GUS IRQ.  Or if the  computer hangs
 while loading a module, try disabling DMA transfers with option /NDM.

   Here's the command line syntax:

 Syntax: CMOD [filespec] @[listfile] [options]
   /AMPx      - set amplification (0..48) (default=auto configure)
   /AMY       - force to Amiga limits (use only octaves 3-5)
   /CHNx      - set default number of visible channels (0..32) (default=16)
   /CLRx      - set environment color (0=default, 1=red, 2=green, 3=blue)
   /DIR[dir]  - set default directory for file selector
   /EXE[file] - start playing and execute [file]
   /FADx      - set fade speed (0..9) (default=9, fastest)
   /HLP       - command line help
   /KBD       - disable key repeating speed set
   /LIN       - enable line in
   /LOPx      - set number of loops (0..255) (default=255, loop forever)
   /MIC       - enable mic in
   /MIDx      - file selector's mid window mode (0..2) (default=0, help)
   /NDM       - disable DMA transfer
   /NO0       - disable speed zero
   /NPN       - disable pan effects
   /PANx      - set default panning (-127..127) (default=36)
   /QIT       - quit after reaching the end if only one module is to be played
   /RND       - play modules in random order
   /SCRx      - screen saver after x seconds idle (default=0, disabled)
   /TMR       - use system timer instead of GUS's own IRQ
   /VBL       - VBlank: disable tempo, speed scale 0-255 (only MODs)

   You can also  put your favorite  command line options  into an environment
 variable. Here is mine for example:

  SET CAPAMOD=/dird:\music\modstuff\mods /clr1 /mid1 /chn32

   The file  selector has a  support for ZIP-files,  although you  cannot tag
  files  within a ZIP.  To use ZIP support,  make sure you  have a  path to a
  directory containing PKUNZIP.EXE.

     3. CONTACTING THE AUTHOR

   If you find any bugs or encounter some problems, don't hesitate to contact
 me. And yes, CapaMod is still rubberware! That means if you use CapaMod, you
 must send me a condom.  If you prefer money to condoms,  you can send me ten
 US bucks.

     smail: Heikki Ylinen             email: flap@flap.pp.fi
            Oravatie 9b
            02270 Espoo
            Finland