CapaMod 3.12 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 II 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.
   Red, green and blue  environment colors require  palette changes.  If this
 causes some problems, you use an unchanged palette (i.e. parameter /CLR0).

   Here's the command line syntax:

 Syntax: CMOD [filespec] [options]
   /AMPx      - set amplification (0..48) (default=auto configure)
   /AMY       - force to Amiga limits (use only octaves 3-5)
   /COR       - play corrupted modules without query
   /LIN       - enable line in
   /MIC       - enable mic in
   /NDM       - disable DMA transfer
   /NO0       - disable speed zero
   /NPN       - disable pan effects
   /PANx      - set default panning (-127..127) (default=36)
   /TMR       - use system timer instead of GUS's own IRQ
   /VBL       - VBlank: disable tempo, speed scale 0-255 (only MODs)

   /CHNx      - set default number of visible channels (0..32) (default=16)
   /CLRx      - set environment color (0=DOS, 1=red, 2=green, 3=blue) (def.=3)
   /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
   /LOPx      - set number of max loops (0..255) (default=255, loop forever)
   /QIT       - quit after reaching the end if only one module is to be played
   /SCRx      - screen saver after x seconds idle (default=0, disabled)

   /DIR[dir]  - set default directory for file selector
   /FILx      - descript.ion filler character code (32..255) (default=250)
   /MIDx      - file selector's mid window mode (0..2) (default=0, help)
   /RND       - play modules in random order

   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


    3. SELECTOR USAGE

   The file  selector has an enhanced  support for ZIP-files.  To use the ZIP
 support, make sure you have a path to a directory containing PKUNZIP.EXE.

   The module descriptor in the selector builds the description as follows:
   <module name>תתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתת<loop>תת<duration>

   A looping module called "Huoleton aamu" with a duration of 1:04 would be
   Huoleton aamuתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתתloopתת1:04
   
   You can use the descriptor also to describe for example directories:
   <module name = artist name>תתתתתתתתתתתת<duration = group of artist>

   In real life the descriptions would add up to only 40 characters in width!


     4. 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