home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The World of Computer Software
/
World_Of_Computer_Software-02-387-Vol-3of3.iso
/
p
/
pp13.zip
/
PP.DOC
< prev
next >
Wrap
Text File
|
1993-02-11
|
13KB
|
273 lines
▄▄▄▄▄ ▄▄▄▄▄ ▄▄
██ █ ▄▄▄▄▄ ▄▄ ▄ ▄▄▄▄▄ ▄▄▄▄ ██ █ ██ ▄▄▄▄▄ ▄▄ ▄ ▄▄▄▄▄ ▄▄▄▄
███▄█ ██ █ ██ █ █ ██▄▄█ ██ ███▄█ ██ ▄▄▄██ ██ █ ██▄▄█ ██
███ ███▄█ ████▄█ ███▄▄ ███ ███ ███ ███▄█ ███▄█ ███▄▄ ███
▄▄▄▄█
--- When size & performance DO make a difference ---
FOREWORD:
---------
As I'm not particularly interested in writing DOCs, I'll try to make this
a short one. I won't explain what these modules are, because I assume you
wouldn't have even downloaded this program if you didn't already know. :)
The player is made by the coders of THE ELECTROMOTIVE FORCE (EMF). Had to
mention that, too. ;-)
POWERPLAYER IN A NUTSHELL:
--------------------------
We decided that it was about time to release a MOD-player which plays the
modules exactly as they should be played. We also think that most people
don't need scopes, equalizers and other fancy graphics on the screen when
playing modules - they just want to "play 'n' go!" ;-) So we focused on
finetuning the music routine itself to the extreme, and I sincerely think
that we DID succeed in that. The player is very fast, it eats up only
31 kilobytes of memory (plus the module, of course), and what's the most
important thing - the modules DO sound just like they should. I have
tested several module players with nearly a thousand MOD and STM files -
PP seems to be the only one to play all of them correctly.
FUTURE PLANS:
-------------
We start working on Gravis Ultrasound support as soon as possible; we now
have some documents for it (thanks to Tran and CyberStrike of Renaissance
for releasing the information into Public Domain!), and PP 2.0 will have
support for GUS! Support for new module formats (like ST3.0) might also
be added, given that they gain enough popularity...
HOW TO USE POWERPLAYER:
-----------------------
Using the program is pretty simple - Just type in "PP filename", where
filename is the module you want to play. Quite simple and straighforward?
The player will start by searching the module from the current directory;
if it does not find it there, it will try the default module path, which
can be specified in the configuration file. The default extension is MOD,
so you don't necessarily need to type the extension at all. PowerPlayer
uses Sound Blaster by default; if you want to use Covox or change playing
frequency or set the default module directories, you must either run PP
with the /C parameter or make the changes with your favorite ASCII editor
for example QEdit.
ADDITIONAL HINTS FOR USAGE:
---------------------------
1) If you notice that some modules are playing too slow or too fast, try
the /P override, which will disable ProTracker's extended tempos. Some
older NoiseTracker modules (e.g. klisje.mod) may use speeds like 20
or 90, even though all speeds in the range of 20-FF are reserved for
extended BPM tempos in PT! Naturally that kind of modules will sound
wrong if they are played as Amiga's ProTracker would play them. That's
why we had to include a switch for disabling the extended tempos. And
there's no way to detect if extended tempos should or should not be
used; you have to decide it yourself. Fortunately non-standard modules
like Klisje.mod are quite rare and therefore you won't usually need to
bother with this option.
2) If you have some modules which are made on PCs (the vast majority is
made on Amiga; say, 996 MODs out of 1000), for example with ModEdit,
you might want to experiment with the /O command line parameter. This
option will force the player to enable two extra octaves; Amiga MODs
use only three octaves, whereas MODs made on PCs may use five. Usually
you won't hear any difference, should the module use five octaves or
not, but if you notice some module playing "out of tune", try using
the /O override and see if it helps.
3) SB Pro-users: remember to turn on the SB Pro's filter using the "SBP-
SET" program. Otherwise the sound will be somewhat distorted. This is
a known bug and will be fixed in the near future.
4) Hint for 4DOS-users: write the following lines in your AUTOEXEC.BAT:
(replace "c:\bin\" with the directory where your copy of PP resides)
SET .mod=c:\bin\pp.exe
SET .stm=c:\bin\pp.exe
SET .oct=c:\bin\pp.exe
SET .wow=c:\bin\pp.exe
Now, when you want to play a module, you just type the name of the
desired module, and the music will start! Executable extensions are
really handy, aren't they? (Note: if you're NOT using 4DOS yet, go get
it somewhere immediately, because using a PC without 4DOS is PAIN!!!!)
5) PowerPlayer is the most suitable choice for playing really big modules
which can't be loaded with other players. First, PP requires far less
memory than other players; second, you can use VIDRAM.COM or similar
to get 96 kB more base RAM. Most other players use VGA graphics, and
therefore VIDRAM can't be used. Some users have noticed that when
VIDRAM is loaded, the screen goes black when loading a module. Haven't
had time to examine the problem, but you can get the text visible
again with the CLS command, so that's only a minor nuisance...
COMMAND LINE OPTIONS:
---------------------
Usage: PP [-C] [-P] [-O] [-Sn] [-Dn] [-In] [-Mn] filename
"Filename" is the module file to be played.
-C lets you update the configuration file (PP.CFG).
-P disables the ProTracker's extended tempos (look above for more info).
-O forces the player to use 5-octave mode (look above for more info).
-Sn forces the player to use a certain mixing frequency, where n is
the frequency either in Hz or kHz (eg. -S16000 is the same as -S16).
-Dn forces the player to use a certain output device:
-D1 = Use Sound Blaster
-D2 = Use Covox DAC on LPT1
-D3 = Use Covox DAC on LPT2
-In forces the player to use a certain IRQ when playing with SB;
-I2 = Use IRQ 2
-I3 = Use IRQ 3
-I5 = Use IRQ 5
-I7 = Use IRQ 7
-Mn is the module type override switch, where n is the number of the
desired module type. You should use this if the player fails to detect
the module's type. Do not use this option unless you know what you're
doing.
-M0 = STM (ScreamTracker 2.x)
-M1 = normal 4-channel .MOD file;
-M2 = MOD file with 15 instruments;
-M3 = An 8-channel WOW or OctaComposer module.
NOTE: Both switch characters ('-' and '/') are accepted.
The options can be in any order, before or after the filename.
FEATURES OF PP (mainly for programmers and composers):
------------------------------------------------------
Supports the following module formats:
o SoundTracker
o NoiseTracker
o StarTrekker
o ProTracker
o OctaComposer
o ScreamTracker (note: these are played in the same way as MODs!)
o 8-channel .WOW modules (converted from .669 format)
o 8-channel Fast Tracker modules
o ...and compatibles
In addition, several features not so commonly
supported by PC module players are available:
o Modules with either 15 or 31 instruments
o Samples which are longer than 64 kB
o Modules with over 64 patterns (PT2.2 100-pattern mode)
o ProTracker's FineTune
o ProTracker's extended speeds (10-1F in vblanks, 20-FF in BPMs)
o Extended Vibrato & Tremolo waveforms
o All other extended commands of ProTracker, except FunkIt.
o A very fast & reliable DOS-shell (Note: COMSPEC must be set!)
Music can be output via a Sound Blaster card or a DAC in the printer port
(either LPT1 or LPT2). The player hasn't been tested with Thunder Board
or Pro Audio Spectrum, but it should work on them. If it doesn't, they
are not Sound Blaster compatible which is not our fault. :-)
LEGAL STUFF:
------------
PP is copyright (c) 1993 by Tomi Aarnio, Teemu Valtonen and Petri Suni.
PP is distributed as Shareware, meaning that you can use the player for
a trial period of FOUR WEEKS. If you continue to use it after that, you
should register it by paying $10 (50FIM) to the authors. Instructions for
registering can be found at the end of this file. Please support the
Shareware concept!
You can distribute PP in any way you wish, for example via BBSes or
various networks. In fact, we strongly recommend you to copy the program
to all your friends, neighbors and acquaintances, as well as uploading
it to every BBS system you're visiting!
DISCLAIMER: The authors do not take any responsibility for the possible
(although highly unlikely) damage or data loss caused by the program.
You use PowerPlayer on your own responsibility.
CONTACTING THE AUTHORS:
-----------------------
If you have any comments, bug reports or ideas on how to improve the
player, you should contact us immediately, and we will try to answer as
soon as possible. I (Tomi Aarnio) handle the "PR-stuff", so you should
contact me in one of the following ways:
mail: | phone (voice only!): | BBS:
--------------+----------------------+-----------------------------------
Tomi Aarnio | +358-(9)21-580 100 | +358-(9)21-827 419 / 8N1 / V.32bis
Seljatie 3 B | | +358-(9)21-827 183 / 8N1 / V.32
SF-20900 Turku| | (24 hours a day, 7 days a week)
Finland | | (DIANA available for Finns)
--------------+----------------------+-----------------------------------
| SBC-Net: 14:1510/400
| FidoNet: 2:222/151
+-----------------------------------
Remember to call our distribution site, too:
SB Center ---> +358-(9)42-14528 / 24h / V.32bis / SysOp: Kari Sorsimo
HOW TO REGISTER:
----------------
The easiest way to pay the registration fee is to send the money ($10) to
my bank account using a bank giro (remember to state your address so that
we will know where to send the disk!):
From Finland: From abroad:
TOP Turku OKOBANK / Turku
571004-5480249 Finland
571004-5480249
We can not handle VISA or any other credit cards, but we will accept US
dollars and Finnish marks (and why not other currencies as well) sent via
mail. We prefer US dollars, but you can send the sum in your own currency
if you really want to. Just don't send any coins! Please allow two weeks
at the maximum for delivery. Remember to specify floppy disk type (3½"
1.44MB or 5¼" 1.2MB).
WHY TO REGISTER:
----------------
1) You will get rid of the annoying beep and 4-sec delay when quitting,
and in addition to this you will save about 1000 bytes of memory.
2) You will receive the next upgrade of PowerPlayer FREE OF CHARGE,
and all the major upgrades after that for only $5 or 25 FIM!
3) You will support the Shareware concept and encourage us to write more
fine utilities and other stuff. And ten bucks isn't that much, is it?
As the PowerPlayer doesn't require very much disk space the remaining
disk space can be filled with modules of your choice. Pick your favorites
from the file MODS.LST and we will include those modules on the disk.
All modules are purely in their original form; no conversions have been
made. (Of course the modules will be packed so that more modules will
fit on the disk.) If you can't decide which modules you would like to
have, we can make a collection of high quality modules for you! The file
MODS.LST naturally includes only a small fraction of my collections, but
I qualified only some of the best modules to the list.
BTW, if you don't already have the demos & intros of our little demo team
(The Electromotive Force = EMF), you might want us to include them on
the disk as well:
EMFINTRO.EXE --> Our first intro, released in October, 1991. Size: 70k.
DELIRIUM.EXE --> Intro/dentro coded in the spring of 1992, size: 116k.
EMF_ID.EXE --> Our major product so far, includes six parts and some
quite cool effects, fast code, nice gfx & sfx, yet takes
up only 150k of disk space!
GREETINGS:
----------
Greetings must go to all beta testers who helped us getting the player
as bug-free as possible: Jussi Heino, Jani Väisänen, Sami Virtanen, Jani
Lehmuskoski, Jani Mattsson and Esa Tuokko. Quick group greetings to the
following teams: Triton, Renaissance, The Future Crew, Cascada, Hysteria,
The Phoney Coders, Surprise! Productions, Witan, Access Denied, Epical,
Sonic PC, and every other group working on the PC scene!