CapaMod v1.17 documentation file Copyright (C) 1993,1994 Heikki Ylinen ( flap / Capacala ) 1. HISTORY AND TECHNICAL INFO ETC. CapaMod is a 4,6 and 8 channel Pro/FastTracker module player. The reason why I made this program is that there isn't a single good module player for the PC. I mean, all players contain many bugs and there isn't a single player which supports all the ProTracker 1.1b effects. In the EFFECT.TXT file you can find a table containing effect info on three popular players and CapaMod. Just simply look at it and say which player is the best in that matter. I have in- cluded only these three players because DMP is so popular and GusMOD and JMP are relatively good players. Of course I have been testing other players also but I haven't included them in the table because of their insufficient effect support. For example players such as MDP (PSi's player), WOW, ZZPlay, GUSPlay, Galaxy Module Player and Inertia Player do not usually support effects like DelayPattern and JumpToLoop. Not to speak about how they support normal ef- fects such as Vibrato. Tremolo is also one effect that is played correctly with only few players. But with CapaMod everything is otherwise. Except for the support of effect Invert Loop. That is because I don't have any idea how to support this particular effect. If you have some info about this effect, please send me everything you know. CapaMod is based on CapaPlay routines which are partly based on Cascada's GUSPlay routines. I found GUSPlay's source very handy to edit for my own purposes so I started to work on it. I have also studied GusMod and DSMI sources. Ok. Here's the thanks list: Biggest thanks to Robert Adolfsson for GUSPlay Other thanks to: Joshua Jensen for GusMod Otto Chrons for DSMI and DMP Jussi Lahdenniemi for PMP Christian Kuendig for ZZPlay Phantom for ProTracker for GUS PSi for MDP and Scream Tracker 3.01 Beta Stephan Danes and Ramon von Gorkom for Inertia Player Jaakko Lehtinen for JMP Mr.H for FastTracker Henning Hellstr”m for SB Studio Samuel Audet for support and testing Jaz for some feature ideas Weasel for bug reports Oliver Deiter for the condom with two holes All Capacala members for beta testing Erika Launonen for herself 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 necassary. Here's the command line syntax: CMOD [modname] [@listfile] /options modname: Module name(s), wildcards allowed listfile: A file containing module names options: Axx - set amplification (0 - 28, default = 24) Pxxx - set default panning (-64 - 64, default = 18) Fx - set fadespeed (0 - 9, default = 9) Lx - set module looping (0 or 1) 0 - disable speed zero N - disable pan effects V - use the volume table used in CapaMod versions below 1.16 Z - use 80x25 textmode B - disable BPM tempo, speed scale 0-255 (VBlank) X[file] - start playing mod and execute [file] Sxxxx - screen saver launch time in seconds (0 = off, default) W - force to Amiga limits (only octaves 1-3) R - disable key repeating speed set You can also put your favorite command line options into an envrionment variable. For example: SET CAPAMOD=/f0 /0 /n /z /w CapaMod begins by loading the first module and invoking the main screen. Video mode will be changed to 80x50, unless you have forced the video mode to 80x25 with the Z option. On top of screen you can see some useful information about module and location where the player currently is. On the right side there is the clock and the playing time. Under this info are the channel indicator lines. They show the sample name, effect, volume, pitch and panning of each channel. The volume bars, which are also in this section of a screen, are standard module-bars. They don't even try to be any kind of VU-meters. Information text is black if the sample is triggered during the current row position. If the currently played effect is not supported, it will be shown in red. And under all this, there is the sample information. There you can find sample names, lengths, loops, finetunes and channel which they are being play- ed on. Current sample is highlighted. If sample is muted its information is shown in dark colors. You can use the following keys to control playing and other stuff:  /  - set module position  /  - move cursor Tab - change cursor location between samples and channels Space - mute / release a channel or a sample M - mute / release all channels or samples 1 - 8 - mute / release a channel indicated by the numberkey F1-F10 - set fadespeed (F10 fade off) - / + - set volume , / . - set panning of channel ; / : - set panning of channel 4 steps Home/End - set tempo PgD/PgU - set speed Del - set speed & tempo determined by the module N - fade out and load next module, another N stops fading and starts loading immediately Esc - fade out and quit, another Esc stops fading and quits immediately D - dos shell P - pause / release module H - help and other info L - switch looping on/off 0 - enable/disable speed zero < / > - scroll screen up / down (only in 80x25 mode) Enter - stops fading and volume to 64 S - screen saver 3. CONTACTING THE AUTHOR (an old clich‚) If you find any bugs or encounter some problems, don't hesitate to contact me. You can also just write me a card where you tell how good CapaMod is and how good I am ( just like Otto wants, greets to him by the way ). And, as mentioned in the player, CapaMod is rubberware. That means if you use CapaMod, you must send me a condom from your home country. Mail: Heikki Ylinen Modem: DARKSˇDE BBS the Capacala WHQ Oravatie 9b +358-0-294 1594 node 1 02270 Espoo +358-0-294 0467 node 2 Finland You may also find me from some other finnish BBSs. I go by the name of flap or Hessu Ylinen. You can also reach me thru DGi-net by the name of Hessu Ylinen. 4. THE END