home *** CD-ROM | disk | FTP | other *** search
/ Sound, Music & MIDI Collection 2 / SMMVOL2.bin / DOS / SS_PLAY / CMOD222.ZIP / CMOD.DOC < prev    next >
Encoding:
Text File  |  1995-02-28  |  6.4 KB  |  141 lines
  1.  
  2.                        CapaMod v2.22 documentation file             
  3.  
  4.             Copyright (C) 1993-1995 Heikki Ylinen (flap / Capacala)
  5.  
  6.  
  7.      1. INFO & THANKS.
  8.  
  9.    CapaMod is a player which plays 4,6 & 8 channel Pro Tracker, Fast Tracker,
  10.  Noise Tracker, Star Trekker, Sound Tracker and Octa Composer modules and 1-32
  11.  channel Scream Tracker ]I[ modules. CapaMod reads only the left/right info
  12.  from S3M channel info. So you can set all channels to L1 or/and R1 and CapaMod
  13.  still plays them all separate. This enables all 32 channels to be played.
  14.  
  15.    And then the thanks.
  16.  
  17.           Biggest thanks to Robert Adolfsson for GUSPlay
  18.           Other thanks to:
  19.              Joshua Jensen for GusMod
  20.              PSi for MDP and Scream Tracker 3.01 Beta
  21.              Otto Chrons for DSMI and DMP
  22.              Jussi Lahdenniemi for PMP
  23.              Christian Kuendig for ZZPlay
  24.              Phantom for ProTracker for GUS
  25.              Stephan Danes and Ramon von Gorkom for Inertia Player
  26.              Jaakko Lehtinen for JMP
  27.              Mr.H for FastTracker
  28.              Henning Hellström for SB Studio
  29.              Samuel Audet for support and testing
  30.              Jaz for some feature ideas
  31.              Weasel for bug reports
  32.              Oliver Deiter for the condom with two holes
  33.              Crash Test Dummies for great music
  34.              Primarch for beta testing
  35.              All Capacala members for beta testing
  36.              Erika Launonen for herself
  37.  
  38.  
  39.      2. THE USAGE
  40.  
  41.    First of all, you must have ULTRASND environment variable set. CapaMod won't
  42.  work without it. And if you still encounter some problems, please make sure
  43.  that you have installed the ULTRINIT, although it is not necessary.
  44.    When you encounter some problems with GUS IRQ, use the option -TMR to force
  45.  CapaMod to use system timer instead of GUS IRQ. It is also handy if you are
  46.  running it under OS/2 GUS drivers.
  47.  
  48.    Here's the command line syntax:
  49.  
  50.            CMOD [modname] [@listfile] /options
  51.  
  52.     modname: Module name(s), wildcards allowed
  53.    listfile: A file containing module names
  54.  
  55.     options: AMPxx     -   set amplification (0 - 48)
  56.              PANxxx    -   set default panning (-64 - 64, default = 18)
  57.              FDEx      -   set fadespeed (0 - 9, default = 9)
  58.              LOPx      -   set module looping (0 or 1)
  59.              MD0x      -   disable speed zero for MODs
  60.              S30x      -   enable speed zero for S3Ms
  61.              NPN       -   disable pan effects
  62.              VBL       -   VBlank: disable BPM tempo, speed scale 0-255 (MODs)
  63.              BCK[file] -   start playing mod and execute [file]
  64.              SCRxxxx   -   screen saver launch time in seconds (0 = off, default)          
  65.              AMY       -   force to Amiga limits (use only octaves 1-3)
  66.              KBD       -   disable key repeating speed set
  67.              RND       -   play modules in random order
  68.              CLRx      -   set environment color (1=blue, 2=red, 3=green)
  69.              M25       -   force to use 80x25 mode
  70.              TMR       -   use system timer instead of GUS's own IRQ
  71.  
  72.    You can also put your favorite command line options into an environment
  73.  variable. For example:
  74.  
  75.   SET CAPAMOD=/fde0 /npn /amy
  76.  
  77.    CapaMod begins by loading the first module and invoking the main screen. 
  78.  Video mode will be changed to 80x50. On top of the screen you can see some
  79.  useful info about module and location where the player currently is. 
  80.    Under this info are the channel indicator lines. They show the sample num-
  81.  ber, name, effect, volume, pitch and panning of each channel. The volume bars,
  82.  which are also in this section of a screen, are standard module-bars. They
  83.  don't even try to be any kind of VU-meters. Information text is light cyan if 
  84.  the sample is triggered during the current row position. If the currently 
  85.  played effect is not supported, it will be shown in red.
  86.    And under all this, there is the sample information. There you can find
  87.  sample names, lengths, loops and finetunes/C4Spds. Sample being used is high-
  88.  lighted and currently triggered sample is white. If sample is muted there are
  89.  two lines crossing its left border.
  90.  
  91.    You can use the following keys to control playing and other stuff:
  92.  
  93.               /   -   set module position
  94.              < / >  -   move cursor up/down
  95.              Tab    -   change cursor location between samples and channels
  96.              Space  -   mute / release a channel or a sample
  97.              M      -   mute / release all channels or samples
  98.              1 - 8  -   mute / release a channel indicated by the numberkey
  99.              F1-F10 -   set fadespeed (F10 fade off) 
  100.              - / +  -   set volume
  101.              , / .  -   set panning of channel
  102.              ; / :  -   set panning of channel 4 steps
  103.            Home/End -   set tempo
  104.             PgD/PgU -   set speed
  105.              Del    -   set speed & tempo determined by the module
  106.              N      -   fade out and load next module,
  107.                         another N stops fading and starts loading immediately
  108.              Esc    -   fade out and quit,
  109.                         another Esc stops fading and quits immediately
  110.              D      -   dos shell
  111.              P      -   pause / release module
  112.              H      -   help and other info
  113.              L      -   switch looping on/off
  114.              0      -   enable/disable speed zero
  115.               /   -   scroll screen up / down
  116.              Enter  -   stops fading and sets volume to 64
  117.              S      -   screen saver
  118.              ( / )  -   set default panning
  119.  
  120.  
  121.      3. CONTACTING THE AUTHOR (an old cliché)
  122.    
  123.    If you find any bugs or encounter some problems, don't hesitate to contact
  124.  me. You can also just write me a card where you tell how good CapaMod is and 
  125.  how good I am (just like Otto wants, greets to him by the way).
  126.  
  127.    And, as mentioned in the player, CapaMod is rubberware. That means if you
  128.  use CapaMod, you must send me a condom from your home country.
  129.  
  130.  
  131.      Mail:  Heikki Ylinen        Modem:  DARKSíDE BBS the Capacala WHQ
  132.             Oravatie 9b                  +358-0-294 1594   node 1
  133.             02270 Espoo                  +358-0-294 0467   node 2
  134.             Finland
  135.  
  136.    You may also find me from some other finnish BBSs. I go by the name of flap
  137.  or Hessu Ylinen. You can also reach me thru DGi-net by the name of Hessu 
  138.  Ylinen.
  139.  
  140.      4. THE END
  141.