home *** CD-ROM | disk | FTP | other *** search
/ Bila Vrana / BILA_VRANA.iso / 031A / CMOD313.ZIP / CMOD.DOC < prev    next >
Text File  |  1996-06-27  |  4KB  |  86 lines
  1.  
  2.                          CapaMod 3.13 documentation file
  3.             Copyright (c) 1993-1996 Heikki Ylinen (flap / Capacala)
  4.  
  5.      1. INFO
  6.  
  7.    CapaMod 3.x is capable of playing MODs, S3Ms and XMs through Gravis Ultra-
  8.  Sound.  It uses  CapaPlay II  which is  included  in CAPAPLA2.ZIP  with full
  9.  assembler source code. You may use it, study it, modify it, but give credits
  10.  to its original author, Heikki Ylinen (flap / Capacala).
  11.  
  12.  
  13.      2. THE USAGE
  14.  
  15.    First of all,  you must have  ULTRASND environment  variable set.  CapaMod
  16.  won't work without it. And if you still encounter some problems, please make
  17.  sure that you have installed the ULTRINIT, although it is not necessary.
  18.    If you encounter some problems  with GUS IRQ, use the option /TMR to force
  19.  CapaMod to use  system timer  instead of GUS IRQ.  Or if the  computer hangs
  20.  while loading a module, try disabling DMA transfers with option /NDM.
  21.    Red, green and blue  environment colors require  palette changes.  If this
  22.  causes some problems, you use an unchanged palette (i.e. parameter /CLR0).
  23.  
  24.    Here's the command line syntax:
  25.  
  26.  Syntax: CMOD [filespec] [options]
  27.    /AMPx      - set amplification (0..48) (default=auto configure)
  28.    /AMY       - force to Amiga limits (use only octaves 3-5)
  29.    /COR       - play corrupted modules without query
  30.    /LIN       - enable line in
  31.    /MIC       - enable mic in
  32.    /NDM       - disable DMA transfer
  33.    /NO0       - disable speed zero
  34.    /NPN       - disable pan effects
  35.    /PANx      - set default panning (-127..127) (default=36)
  36.    /TMR       - use system timer instead of GUS's own IRQ
  37.    /VBL       - VBlank: disable tempo, speed scale 0-255 (only MODs)
  38.  
  39.    /CHNx      - set default number of visible channels (0..32) (default=16)
  40.    /CLRx      - set environment color (0=DOS, 1=red, 2=green, 3=blue) (def.=3)
  41.    /EXE[file] - start playing and execute [file]
  42.    /FADx      - set fade speed (0..9) (default=9, fastest)
  43.    /HLP       - command line help
  44.    /KBD       - disable key repeating speed set
  45.    /LOPx      - set number of max loops (0..255) (default=255, loop forever)
  46.    /QIT       - quit after reaching the end if only one module is to be played
  47.    /SCRx      - screen saver after x seconds idle (default=0, disabled)
  48.  
  49.    /DIR[dir]  - set default directory for file selector
  50.    /FILx      - descript.ion filler character code (32..255) (default=250)
  51.    /MIDx      - file selector's mid window mode (0..2) (default=0, help)
  52.    /RND       - play modules in random order
  53.  
  54.    You can also  put your favorite  command line options  into an environment
  55.  variable. Here is mine for example:
  56.  
  57.   SET CAPAMOD=/dird:\music\modstuff\mods /clr1 /mid1 /chn32
  58.  
  59.  
  60.     3. SELECTOR USAGE
  61.  
  62.    The file  selector has an enhanced  support for ZIP-files.  To use the ZIP
  63.  support, make sure you have a path to a directory containing PKUNZIP.EXE.
  64.  
  65.    The module descriptor in the selector builds the description as follows:
  66.    <module name>····································<loop>··<duration>
  67.  
  68.    A looping module called "Huoleton aamu" with a duration of 1:04 would be
  69.    Huoleton aamu············································loop··1:04
  70.    
  71.    You can use the descriptor also to describe for example directories:
  72.    <module name = artist name>············<duration = group of artist>
  73.  
  74.    In real life the descriptions would add up to only 40 characters in width!
  75.  
  76.  
  77.      4. CONTACTING THE AUTHOR
  78.  
  79.    If you find any bugs or encounter some problems, don't hesitate to contact
  80.  me. 
  81.  
  82.      smail: Heikki Ylinen             email: flap@flap.pp.fi
  83.             Oravatie 9b
  84.             02270 Espoo
  85.             Finland
  86.