home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Audio Plus 10-94
/
AUDIOPLUS.ISO
/
msdos
/
players
/
musique
/
musique.doc
next >
Wrap
Text File
|
1991-09-06
|
34KB
|
679 lines
/* Warning! This documentation contains extended characters! */
Program: MUSIQUE.ZIP (freeware)
Entered with PC-LITE 1.00
Compiled with TCC 2.0 (-ms -d -f- -A -K -G -O -w)
Patched with DEBUG 3.3
Compressed with PKLITE 1.12
Author: François Jalbert (jalbert@IRO.UMontreal.CA) (jalbert@CS.UBC.CA)
Date: July 1991
Version: 1.1
Files: MUSIQUE.EXE
MUSIQUE.DOC
MUSIQUE.MEN
SOURCE.ZIP
Got a problem? Look up the frequently asked Q/A section at the end!
Syntax: MUSIQUE [/a | /b | /c] [/d | /e | /f] [/h] [/i<decimal>]
[/k<type><decimal>...] [/m] [/n | /s | /v] [/o] [/p]
[/t<letter>] [/0 | [/1|/2|/3]...] [/?] [menu_file[.men]]
Description:
MUSIQUE is an "intelligent" shell for playing modules with ModPlay.
It lets you select modules, finds them, and calls ModPlay to play them.
If necessary, it will move/decompress some modules, and later delete them.
Modules are always assumed compressed with PKZIP, because it remains the
fastest decompression utility, while achieving near LHARC compression levels.
MUSIQUE should run fine in any video mode (standard & non-standard) as long
as the video routines in the BIOS comply.
Parameters:
All parameters must be separated by at least one space.
Given conflicting parameters, the last one always takes precedence.
Any invalid parameter will abort the program.
/a AT < 12 MHz
/b AT = 12 MHz (default)
/c AT > 12 MHz
/d Run in german
/e Run in english
/f Run in french (default)
/h High intensity display (normally disabled)
/i<decimal> Force video mode to be used (132*60*16 is /i86 for me)
/k<type><decimal> Set <type> to color <decimal> (see "Colors" below)
/m Mouse input enabled for text modes only (normally disabled)
/n Display only DOS file names in the menu
/s Display only song names in the menu (default)
/v Display almost all (verbose) the fields in the menu
/o Output with the BIOS (normally directly to video RAM)
/p Pause before/after main operations (good for debugging)
/t<letter> Force temporary drive (typical /tE)
/0 Force no parallel port
/1 Force parallel port at 3BCH (see "Parallel Ports" below)
/2 Force parallel port at 378H (see "Parallel Ports" below)
/3 Force parallel port at 278H (see "Parallel Ports" below)
/? Display syntax
Menu Files:
A menu file is necessary for MUSIQUE to know which modules to list and where
these modules can be found. The optional default extension is .men
The default menu file is: musique[.men]
A menu file contains lines (at most 350 of them) of the form:
floppy_disk_ID score DOS_path DOS_file_name song_name
Maximum field lengths: floppy_disk_ID 2 letters
score 2 letters
DOS_path 127 letters
DOS_file_name 8 letters
song_name 19 letters
These lengths have been chosen to maximize the use of the screen in /v mode.
Note that no field may be empty.
These fields are space-separated and the song_name may contain spaces.
Use a ? (say) for empty fields but use a . to indicate the empty DOS_path.
Any non-trivial DOS_path field must end with : or \ for concatenation.
There is limited space (±25Kb) for all the DOS_path's, so be reasonable!
The DOS_file_name must not include the .mod or .zip file name extensions.
A menu line with a % character in the first column is ignored altogether.
This is used to discard modules while keeping a record of having tried them.
You will find in my MUSIQUE.MEN comments as to why some modules won't play.
Colors:
No color setup is guaranteed to be satisfactory on all color systems.
Therefore, it is possible with a few /k<type><decimal> flags to reconfigure
all the colors used by MUSIQUE to your liking.
The standard 8 basic colors are:
0 = Black
1 = Blue
2 = Green
3 = Cyan
4 = Red
5 = Violet
6 = Yellow (brown)
7 = White
By adding 8 to these values, you get high intensity colors. (same as /h flag)
For example, a color of 8 is high intensity black; grey (or black).
The observed colors can vary *greatly* depending on your hardware.
This is particularly true for the border colors of CGA, EGA and VGA adapters.
The types of display element and their default colors are:
1 = Screen outline 4 = Red (foreground)
2 = ModPlay title 3 = Cyan (foreground)
3 = Unpicked item 2 = Green (foreground)
4 = Picked item 1 = Blue (foreground)
5 = Keyboard cursor 3 = Cyan (background)
6 = Mouse cursor 4 = Red (background)
7 = Screen background 0 = Black (background)
For example, to change the mouse cursor from red to violet, use the /k65 flag.
The default colors have been picked out of personal taste.
The 16 text colors just described are available on any color video adapter.
In graphics modes, the number of available colors varies from 2 to 256
depending on the color adapter and the mode selected.
No error checking is performed on the colors supplied so fancy video modes
can perhaps be fully exploited by the knowledgeable user.
On the most recent color video adapters, each of the 16 text colors can also
be reprogrammed from a wide range of available colors.
I do not plan on supporting such specialized palette reconfigurations.
If you must, you can always change palettes prior to using MUSIQUE.
There are stand-alone programs for this, but debug can also be used.
Some types of display elements are background elements by default.
You can only change the color and intensity of such display elements.
Display elements in the foreground can be changed to background elements.
This is done by multiplying the color desired by 16.
For example, to get a reverse-video red picked item, use the /k464 flag.
You can combine foreground and background colors as well if desired.
For example, /k281 gives a violet background blue foreground title element.
Remember, such a flexibility is possible for foreground elements only.
People with black and white displays will appreciate the ability to
reconfigure colors to better exploit reverse video and intensity control.
This works particularly well for CGA, EGA, MCGA and VGA B/W screens.
For example, use the /k57 /k67 flags for reverse white video cursors and
the /k315 /k4112 flags for the unpick/pick status.
Several similar B/W color configurations are possible.
The MDA has a far less flexible design, see the Q/A section.
Parallel Ports:
MUSIQUE supports only the three standard IBM parallel ports. It does not sup-
port homemade parallel ports and the soundblaster, but by using a batch file
MODPLAY.BAT, you can replace MUSIQUE's parallel port parameter with the one
of your choice, prior to starting the real ModPlay program. For example, your
file MODPLAY.BAT could contain the statement: C:\MP116E /s1 %2 %3
Standard IBM parallel ports are found at I/O addresses 3BCH, 378H, and 278H.
This is the order in which they are looked for by the BIOS when the computer
is powered-up. Here are all the possible combinations of parallel ports and
their DOS assignments:
LPT1: LPT2: LPT3:
3BCH
378H (common AT setup)
278H
3BCH 378H (my setup)
3BCH 278H
378H 278H (common AT setup)
3BCH 378H 278H
One can see that a parallel port at 3BCH can only show up as LPT1: A parallel
port at 378H can be LPT1: or LPT2: depending on what other parallel ports you
have. Finally, a parallel port at 278H can be any of LPT1: or LPT2: or LPT3:
which can be quite surprising at first.
MUSIQUE needs to know which I/O address to use. It does not care much for
DOS' way of numbering things, especially since LPT1: can be any of three I/O
addresses, and so forth! One solution might be for you the user to say: "I
want to use LPT2:" and have MUSIQUE look into the BIOS parallel port table to
see what I/O address corresponds to LPT2: at the time. Unfortunately, not all
parallel ports can be detected by the BIOS and therefore, a way of specifying
parallel ports that does not rely on the BIOS' ability to properly detect
them is called for. This explains the scheme used by MUSIQUE. I hope that you
are still with me so far!
You specify parallel ports by the standard order in which they are looked for
by the BIOS at power-up. That is /1 is 3BCH, /2 is 378H, and /3 is 278H. The
flag /0 stands for no parallel port. Here is an equivalence table between
ModPlay and MUSIQUE:
Address(es) ModPlay MUSIQUE
None /0 /0
3BCH (LPT1:) /5 /1
378H (LPT1:) /1 /2 (common AT setup)
278H (LPT1:) /2 /3
3BCH (LPT1:) 378H (LPT2:) /xs /1 /2 (my setup)
3BCH (LPT1:) 278H (LPT2:) /xs /1 /3
378H (LPT1:) 278H (LPT2:) /3 /2 /3 (common AT setup)
I find MUSIQUE's handling of parallel ports more consistent than ModPlay's,
but this is really just a question of personal taste. Don't forget the space
between any of the MUSIQUE flags!
Note that MUSIQUE can try to find your parallel port setup-up automatically.
I would suggest that you get into specifying parallel ports on the command
line only if MUSIQUE's choice is not the desired one. To find the parallel
ports I/O addresses on your computer, look into your BIOS' parallel port
table. That is done under debug by simply typing "d 40:8 f" and then "q".
Numbers are somewhat swapped, but you should make sense of them in a few
seconds. If your parallel ports can't be detected by your BIOS, you'll have
to read the documentation that came with them (Oh, shall I never!), or go by
trial and error. You can't do any damage with an incorrect port setting.
Functional Description:
Since Mark put out his superb ModPlay program, I have collected about 15Mb of
pkzipped modules. I expect more soon. I have only limited hard-disk space so
most of them are kept on numbered floppies. To demo ModPlay to friends, I
typically have to figure out what is already on my hard-disk, what is on
floppy and on which floppy exactly, copy things back onto hard-disk, occa-
sionally decompress, delete afterward, etc. This is a waste of time and also
quite error prone. So I decided to write a small menu program that would do
all of these tasks for me.
MUSIQUE displays a menu of all the modules you have, for you to multiple-pick
and play. I found that identical modules are sometimes stored under different
DOS_file_name's, which caused me to waste time downloading modules by MODEM
just to find out that I already had them in stock. So the DOS_file_name does
not seem a-priori like a reliable way of keeping track of modules. The
DOS_file_name also carries only 8 letters, while the built-in song_name in
the modules has up to 19 letters (20 with EOS). So I decided that the menu
should display the modules by song_name's, and not by the DOS_file_name. This
is a more reliable and a more descriptive way of keeping track of modules.
Therefore, when MUSIQUE starts, it needs to know the song_name's of all the
modules you intend to use. One way would have been to scan all the modules
that can be found using some user-specified path, and then look for their
song_name's. This would have also required some pkunzipping and later dele-
ting of modules, and in my case, also a lot of floppy swapping. This is
clearly unacceptable since nobody wants to spend 10 minutes fiddling prior to
starting to use a program which is supposed to simplify your life in the
first place.
I decided that MUSIQUE would require a menu file. The menu file specifies all
the modules you want to use by DOS_file_name and by song_name. You pick up
song_name's, and MUSIQUE will handle the DOS_file_name's for you. The menu
file also says which floppy holds which module. So it may prompt you to in-
sert the right floppy in case a module is not found first on your hard-disk.
The menu file can be used to associate a score to each module, so you know
easily which modules suit you best when giving a quick demo to a friend. Fi-
nally, the menu file also specify under which directory on your hard-disk any
given module might be found. Given the small price of having to prepare a
menu file, the flexibility seems very good.
If you run ModPlay with the /o flag, it will output the DOS_file_name's and
the song_name's of all the modules in the current directory. Using piping,
you end up with most of the work done for you! All that's needed to get
started immediately (without using the fancier capabilities of MUSIQUE) is a
little bit of polishing to add some dummy parameters. You will quickly have a
menu file ready to use. Later, as you move modules onto floppy for permanent
storage, you can modify the menu file slightly to reflect that move. It's
really quite simple. If you are really in a hurry, piping a simple DOS direc-
tory listing into a file is also a good way of getting started.
ModPlay has a few peculiarities which influenced the making of MUSIQUE. These
assumption may not hold anymore for the current version of ModPlay, but they
did at one point and that's why MUSIQUE operates the way it does. For exam-
ple, the modules to be played must be in the current directory of the current
drive. This resulted in the notion of a temporary_drive which MUSIQUE uses
extensively. ModPlay does not zero out parallel ports after usage, so MUSIQUE
will do that for you. ModPlay runs only in CO80 video mode, so MUSIQUE will
handle video mode switching so you can use any extended text modes (and even
any graphics mode if you don't use a mouse!) at your leisure.
You start MUSIQUE from the current_drive. MUSIQUE will look immediately for a
temporary_drive. This temporary_drive is where ModPlay and the modules will
sit for playing. So the modules will be in the same directory and drive as
ModPlay itself. If you have 8 drives and the 6th happens to be a RAM-disk
(blazing fast access), you can tell MUSIQUE to use it as its temporary_drive
with a command line flag [/tF]. Without any command line information about
drives, MUSIQUE will make a guess. If MUSIQUE was started from a floppy drive
(A: B:), it will use the last drive as its temporary_drive. Hopefully, this
will be a RAM-disk or a hard-disk. If MUSIQUE was started from a non-floppy
drive (C: and up), it will stick to that drive as its temporary_drive. These
tests are more reliable when you use the standard LASTDRIVE statement in your
CONFIG.SYS file.
MUSIQUE will then hunt for the PKUNZIP program used to pkunzip modules. It
will look first on the temporary_drive, then along the DOS path, and finally
on the current_drive. If the PKUNZIP program can't be found, you will be
allowed to play only non-pkzipped modules. If the PKUNZIP program is found on
the current_drive, and this drive is different from the temporary_drive, then
MUSIQUE will copy temporarily the PKUNZIP program onto the temporary_drive.
This move is done since in many cases, the temporary_drive will be a RAM-disk
which is much faster than the current_drive, may it be floppy or hard-disk.
When terminating, MUSIQUE will clean up the temporary_drive.
MUSIQUE also hunts for the MODPLAY program. It uses exactly the same scheme
as for the PKUNZIP program. However, if the MODPLAY program is not found,
MUSIQUE will abort. MUSIQUE will look for MODPLAY.COM, then for MODPLAY.EXE,
and then for MODPLAY.BAT before giving up on finding the MODPLAY program. So
MUSIQUE is ready for any future change in the MODPLAY program format, and
even for new ModPlay flags through the batch file approach.
You can select which parallel ports you wish MUSIQUE to use. Without any com-
mand line information about ports, MUSIQUE will make a guess. It will try to
write, wait some, and read back a few patterns at the standard parallel port
I/O addresses. Any parallel port found will be assumed available for output.
This test can only work with parallel ports that support both output and in-
put. Indeed, the BIOS detects the parallel ports in any given machine using a
very similar test.
Shortly after reading the menu file and finishing its initialization, MUSIQUE
will log permanently onto the temporary_drive and display a screen full of
song_name's. You can move around with the usual 4 cursor keys. <Home> brings
you to the first screen and <End> to the last. <PgUp> and <PgDn> have the
usual effect as well. All nine keypad keys can also be used while holding the
<Shift> keys. Their action is then restricted to within the current window,
instead of within the whole menu file. <Ctrl> keys are not used since they
are not fully supported by the BIOS, and I'd rather stick to the BIOS as my
input interface.
The current song_name can be picked/unpicked for playing with the <Space>
key. You can pick as many song_name's as you wish. You can even pick all and
unpick all with the @ key. This is also useful for clearing out the pick sta-
tus of all song_name's. You start up the current batch of song_name's with
the <Enter> key. MUSIQUE will treat each module in turn, before eventually
returning to the menu display. A mouse can also be used to move in the usual
four directions. You can pick/unpick modules with the left button, and the
current batch of song_name's is started with the right button. Scrolling
speed with the mouse is limited artificially to a reasonable 20msec/scroll.
The search for a module to play starts on the temporary_drive. MUSIQUE always
looks for a .MOD file first, before trying out a .ZIP file. The .ZIP exten-
sion is tried if and only if the PKUNZIP program could be located a while
earlier. The search then covers the DOS_path of the current song_name in the
menu file. Any module found there is moved/pkunzipped to the temporary_drive.
Finally, MUSIQUE will give the current_drive a try as well. Again, any module
found will be moved/pkunzipped to the temporary_drive. If the current_drive
is a floppy, MUSIQUE may ask you to insert a floppy using the floppy_disk_ID
of the current song_name in the menu file. If the current_drive is non-flop-
py, MUSIQUE may give up on the current song_name. All modules that had to be
moved/pkunzipped will be deleted afterward by MUSIQUE, so the temporary_drive
does not fill up with modules.
Hopefully, the proper module will eventually end up in the temporary_drive.
MUSIQUE will then fire up ModPlay with the appropriate parameters. After
ModPlay is done, MUSIQUE will gradually zero out any parallel port used. This
will prevent voltage fluctuations from ending up in your stereo system while
the hard-disk is being used. On some computer systems, it's like listening to
the drive with a stethoscope! The zeroing is gradual to avoid creating any
scratching noise in your speakers. Some parallel ports are more sensitive
than others to this problem. I did what I could!
You can go through several sessions of picking/playing using MUSIQUE. Press-
ing the <Escape> key quickly after a module finished playing aborts the cur-
rent batch of modules. Pressing <Escape> under the menu terminates MUSIQUE.
All remaining temporary files on the temporary_drive will be erased, and
MUSIQUE will log back onto the current_drive. Pressing both mouse buttons
from the menu also exits MUSIQUE. You cannot however, use the mouse to abort
a batch of modules. MUSIQUE always plays the modules in the order in which
you picked them. If you select all the modules with the @ key, it will play
them in the menu file order. You can also use the * key to randomly select
the order in which the currently selected modules will be played.
So I hope that this little tour helps you understand what MUSIQUE does and
does not do. It is intended to be an "intelligent" module player. It is not a
module manager that could maintain menu files automatically in the background
while you pkzip, pkunzip, copy, and delete module on hard-disk and on flop-
pies. It is also not intended to be a module validity tester or a module edi-
tor. Within its intended purpose, I hope that you will find MUSIQUE as help-
ful as I did.
Internal Operation:
To initialize itself, MUSIQUE will:
Switch video mode, iff user-supplied and suspected necessary.
Determine the current_drive:
Determine the temporary_drive, iff not already user-supplied:
Look for ModPlay on the temporary_drive, DOS PATH, and current_drive:
One of MODPLAY.COM, MODPLAY.EXE, or MODPLAY.BAT must be found.
Look for PKUNZIP.EXE on the temporary_drive, DOS PATH, and current_drive:
If PKUNZIP.EXE is not found, only *.MOD's can be played.
These two programs will be copied (iff necessary) to the temporary_drive.
Determine the parallel ports to be used, iff not already user-supplied.
Turn off gradually any parallel port to be used.
Determine the video mode, iff not already user-supplied.
Determine the size of the screen.
Look at byte 484H (lines) for evidence of an extended text mode.
Initialize the mouse, iff user-requested.
Clear the screen, set border color, and enable high intensity backgrounds.
Log onto the temporary_drive.
Then you enter the menu itself:
Browse with the usual eight keys (keypad) through the menu file. (mouse)
Browse with the usual nine <Shift> keys (keypad) through the window.
Pick/unpick a module with <Space>. (left button)
Pick/unpick all modules with @.
Randomize the priority of picked modules with *.
Play the current batch of modules with <Enter>. (right button)
Abort prematurely the current batch of modules playing with <Escape>.
Exit to DOS from the menu with <Escape>. (both buttons)
When a module is to be played, MUSIQUE will:
Check if the user is aborting the current batch with the <Escape> key.
Look for the .MOD file, then for the .ZIP file (iff PKUNZIP.EXE found):
Copy the module to the temporary_drive iff necessary.
Call PKUNZIP to decompress the module on the temporary_drive iff necessary.
Wait for any active floppy to turn itself off.
Call MODPLAY to play the module on the temporary_drive.
Turn off gradually any parallel port used.
Delete the module on the temporary_drive iff it was copied/decompressed.
Reset start-up video mode iff necessary.
Clear the screen, set border color, and enable high intensity backgrounds.
Display the menu once again.
Patch for all video modes (offsets may vary):
Any program compiled with Turbo-C may insist on resetting the video adapter
to one standard text mode at start-up. This is always the case if that pro-
gram (like MUSIQUE) has been instructed to potentially use only the BIOS to
perform its output.
If you want to use MUSIQUE in some extended mode, you would have to always
specify the extended video mode with the /i<decimal> flag. I thought this was
too annoying since I prefer to use my mode switching program first, and then
start MUSIQUE to run in the default mode, may it be standard or non-standard.
The following two patches prevent MUSIQUE from resetting the video mode upon
start-up. They have already been performed on your copy of MUSIQUE.
55 PUSH BP
8BEC MOV BP,SP
8A4604 MOV AL,[BP+04]
3C03 CMP AL,03 <=== 03 becomes FF
7606 JBE 60FA
3C07 CMP AL,07
7402 JZ 60FA
Shortly thereafter,
803E123A03 CMP BYTE PTR [2AE0],03 <=== 03 becomes FF
760C JBE 612F
803E123A07 CMP BYTE PTR [2AE0],07
7405 JZ 612F
The offsets may vary slightly due to last minute changes in MUSIQUE.
Requirements:
Fast enough AT (±12 MHz for ModPlay)
Color-capable display adapter (for ModPlay)
Hard-disk (or RAM-disk) strongly recommended
DOS 3.0 or better is recommended for its LASTDRIVE statement
MODPLAY.COM program (version 1.16c, 1.16e, or better)
PKUNZIP.EXE program (only if some of your modules are pkzipped)
Plenty of *.MOD (and/or *.ZIP) modules
Generic mouse (optional)
Possible Enhancements:
A configuration file MUSIQUE.CFG
Texture
User-selected displayed fields in the window
User-selected key assignments
User-selected mouse X/Y motion/pixel ratios
Mouse button swapping for left-handed
Quick mouse moves à la NeXT through X/Y derivatives monitoring
Several decompression utilities supported and auto-detected
DOS_name's in menu files with optional .MOD or .ZIP extensions
A way of picking modules by searches on the menu fields
Mouse icons for totally keyboard-less operations.
Acknowledgements possible with the mouse while using the /p flag.
Current drive flag.
Make selected modules play several times in a row.
Make a batch of modules play forever, randomly too if requested.
Mouse support in graphics mode.
Frequently Asked Questions:
Q. ModPlay runs fine, but I hear nothing.
A. Always run MUSIQUE without any parallel port flags at first.
It could just make a better parallel port choice than you quickly can.
MUSIQUE and ModPlay use a different way of specifying parallel ports.
For more info, read the "Parallel Ports" section of this brief guide.
You could also use the /p flag to see what parameters ModPlay receives.
Q. MUSIQUE insists on using the E: drive as its temporary drive.
There is no E: drive on my system!
A. DOS assumes internally that 5 drives are present, unless you say otherwise.
Please use the standard LASTDRIVE statement in your CONFIG.SYS file.
Or simply supply explicitly the temporary drive with the /t<letter> flag.
Q. MUSIQUE uses my network drive G: which won't work properly.
A. Specify the desired temporary drive with the /t<letter> flag.
Q. I couldn't care less for all the fancy (useless!) MUSIQUE options.
How can I quickly play a few modules just sitting on my hard-disk now?
A. Create first a list of your modules with "DIR *.MOD >MYLIST.MEN".
Edit that list so you get something like: ? ? . MODULE1 ?
? ? . MODULE2 ?
? ? . MODULE3 ?
etc
Then simply run "musique mylist /n" from your hard-drive.
But you'll never know what you're missing...
Q. After playing some modules, my extended screen is not restored properly.
A. MUSIQUE uses the standard INT 10H (AH=0 AL=mode) call to set video modes.
It also uses the standard INT 10H (AH=F) to read your extended mode.
Does your fancy EGA/VGA card have a complete BIOS in ROM?
Have you run at least once your generic mode switching program?
These programs often leave permanently some part of themselves in memory.
Run "musique /p" and compare the video mode used with the correct one.
Use the /i<decimal> flag to specify explicitly your video mode.
Are you using a *decimal* number with the /i flag?
Also note that MUSIQUE always uses the first text page of your adapter.
Q. My screen is a mess.
A. MUSIQUE uses by default video RAM assumed continuous.
Some fancy console drivers (ANSI) may also cause compatibility problems.
Try the /o flag to see if your BIOS does a better job.
Q. Where can I get modules from.
A. I got most of my modules by FTP from 128.155.23.64 under amiga/...
If you want more FTP sites, ask for help under rn.
If you can't FTP, also ask for help with rn. Lots of folks out there...
Some local site might just have an e-mail server with modules on-line.
Q. After a while, I sometimes get (null) strings printed on the screen.
A. ModPlay occasionally corrupts randomly the computer memory with 0's.
Mark is working actively on that bugette, it's a tough one.
I suggest that you immediately reboot the computer and avoid playing the
module that caused the problem. Do not assume the last module played is the
culprit, experiment some more first.
Q. My computer freezes as soon as ModPlay starts.
A. Is your computer fast enough? How about using the /a flag?
Some computers using DOS=HIGH under DOS 5 are known to have speed problems.
Are you using an Amiga computer!!!
Q. I can see ModPlay starting, but it just displays some text and quits.
A. It's probably receiving parameters that it doesn't recognize.
Are you using ModPlay 1.16c, 1.16e, or better?
You could try "musique /p" to see what parameters it is receiving.
You could also use some batch file MODPLAY.BAT to adjust the parameters.
Q. None of my modules are ever found.
A. Remember that MUSIQUE looks into the temporary_drive, the DOS_path you
supplied into the menu file for the current module, and the current_drive.
It does not look for modules under the standard DOS PATH or DATA path.
Does : or \ terminate all non-trivial DOS_path strings in the menu file?
If you are using .ZIP modules, run "musique /p" to see if the PKUNZIP.EXE
program has been located on your system during the initialization.
Q. To center myself in a window, I must use <Shift> 5 (keypad).
Why can't I use simply 5 (keypad)?
A. That key is not supported by the BIOS.
Q. My mouse doesn't work properly, or at all.
A. Have you loaded your mouse driver?
Is it a standard INT 33H driven mouse driver?
Are you using the "/m" flag with MUSIQUE?
How about trying out the BIOS approach with a /o flag?
Note that the mouse won't work properly in graphics mode.
Q. I can't get the bloody syntax in english!
A. Try "musique /e /?"
Q. Your german stinks!
A. Please don't rub it in, and tell me where I made mistakes instead.
Q. MUSIQUE won't run properly on my mono system.
A. MUSIQUE should run fine with any video adapter, including mono.
However, MDA color attributes are not as flexible as color ones.
You could try something like "musique /k3112 /k4114 /k515"
Note that right now, ModPlay does not run on a MDA as far as I know.
Hopefully, Mark will work on that one eventually.
I am too lazy just now to support dual-screen MDA/CGA systems.
Use the MODE program to perform the switch prior to starting MUSIQUE.
Or perform a back and forth switch in your MODPLAY.BAT file.
Q. I find garbage on my hard-disk after a session.
A. MUSIQUE should clean up its temporary files before any normal exit.
Have you aborted MUSIQUE with <Escape> at any time?
Q. I have a parallel port at a non-standard address, so what?
A. Create a MODPLAY.BAT file that disregards the first parameter received
from MUSIQUE and replaces it with the correct one for you, say "/xm303".
Then run "musique /0" as if you wanted to use the internal speaker.
For more info, read the "Parallel Ports" section in this brief guide.
Q. I have only two floppies, what do I do?
A. Use the floppy with the biggest capacity (say B:) as the source of modules.
The small floppy (say A:) will be your temporary_drive. (even 360K is enough)
Copy MUSIQUE.EXE MUSIQUE.MEN (PKUNZIP.EXE) and MODPLAY.COM onto A:
Log onto B: and type something like "a:musique a:musique.men /tA".
You can then feed in modules from B: and have the temporary files on A:
It's slow, but I guess it's still better than nothing.
Note that there are a number of alternate ways of handling this situation.
Q. I can barely see the menu on my screen.
A. Use the "/h" flag to force a uniform high intensity signal.
Reconfigure colors with a few /k<type><decimal> flags using high colors.
Q. When I start MUSIQUE, I hear some noise on my speakers.
A. That's MUSIQUE figuring out which parallel ports you have.
If you really can't stand it, specify with the proper flags your ports.
I really did my best to be quiet!
Q. The mouse cursor doesn't show up on my screen.
The picked items disappear on my screen.
Etc...
A. Adjust the appropriate colors with some /k<type><decimal> flags.
For more info, read the "Colors" section in this brief guide.
Acknowledgments:
I warmly thank Mr. M. Romanycia for trying out for me versions α ß Γ δ ε ∞.
Marc's numerous comments helped make this program a much better one. They
also made for numerous sleepless nights...
Of course, Mr. M. Cox also deserves high praise for his ModPlay program.
Keep up the good work, Mark!
Public Request:
If you have any modules I don't have, please let me know where you got them.
MUSIQUE.MEN lists all the modules that I have. Thanks! Franzl