

                      ******* fMSX-DOS *******
                 The Portable MSX/MSX2/MSX2+ Emulator
                            version 1.2.3

                         by Marat Fayzullin
                 Ported to MS-DOS by Marcel de Kogel

This file contains notes about features specific for fMSX-DOS 1.2.3

Note: fMSX-DOS requires the presence of a DPMI server. If you don't run the
program under a DPMI-hosted environment (Windows, OS/2, QPMI, ...), put the
file CSDPMI.EXE included in CWSDPMI.ZIP somewhere in your path.

Hardware Requirements
=====================
A 486DX-33 (P75 recommended)
A VLB- or PCI-based VGA compatible video card
Adlib/SBPro/SB16 and joystick supported. Volume control only works with SBPro
and SB16 compatible sound cards

Files included in FMSX-DOS.ZIP
==============================
FMSX-DOS.EXE  The emulator
FMSX.DOC      The main documentation file
FMSX-DOS.TXT  This file
CWSDMI.ZIP    A dpmi server required by FMSX-DOS.EXE
MENU12.ZIP    A front-end written by Andrew Bond. Thanks, Andrew!

Key Mapping
===========
GRAPH  - Left alt
CODE   - Right alt
SELECT - PageDown
STOP   - PageUp

Special Keys
============
F8  - Toggle sound on/off
F9  - Pause
F10 - Quit emulator
F11 - Increase sound volume
F12 - Decrease sound volume

Command line options
====================
The following command line options are added/modified:
-video <mode>       Select video mode[0]
                    0 - 320x200   1 - 320x240
                    2 - 640x480   3 - 256x212
                    Video modes 1 and 3 may not be compatible with your video
                    card and/or monitor. For video 2, you'll need a VESA
                    compatible video card.
-modeswitch <mode>  Allow/Don't allow VGA mode switches[0]
                    0 - Don't allow VGA mode switches
                    1 - Allow VGA mode switches
                    If this option is enabled, the game will use both video
                    modes 2 and 3
-audio <mode>       Select audio mode[1]
                    0 - No sound  1 - PSG only  2 - PSG and SCC
                    You need an OPL3 chip (SBPro 2, SB16) for the SCC
                    emulation
-volume <volume>    Set initial volume[10]
                    0 - Quiet    15 - Maximum
-joystick <mode>    Select joystick mode[1]
                    0 - No joystick support
                    1 - Emulate joystick at port 1
                    2 - Emulate joystick at port 2
                    The 2nd PC joystick isn't supported (yet)
-ifreq <frequency>  Select interrupt frequency[50Hz]
                    The emulator uses this to sync the emulation to the PC
                    hardware timer. Using -uperiod makes no sense unless
                    -ifreq 0 is given, which disables the sync. Disabling the
                    sync will speed up the emulation.
-adlib              Discarded. Use -audio instead

Passing options to the emulator
===============================
With the amount of command line options fMSX-DOS supports, it's easy to
create command lines larger than the DOS limit of 126 bytes. If you
experience problems with the command line length, put all options in a
temporary file (say, "TempFile.tmp"), and start the emulator with the command
line "fMSX-DOS @TempFile.tmp". You may also give extra command line options
when using this feature, so "fMSX @Pacman.cfg Pacman.rom" will load
"Pacman.rom" as cartridge A, and get all other command line options from the
file "Pacman.cfg". fMSX-DOS does NOT read configuration files automatically
(yet).

History
=======
1.2.3  Added volume control, joystick options, modeswitch option, video mode
       3, improved sound, increased speed, fixed some bugs
1.2.2  Added joystick support, Added SCC emulation and improved PSG
       emulation, added VESA support, increased speed, fixed some major bugs
1.2.1  Initial release

Credits
=======
fMSX-DOS was compiled using DJ Delorie's DJGPP v2.0. DJGPP is a 32 bit C
compiler for MS-DOS. Source code and binaries of DJGPP are available at
http://www.delorie.com.

Please send your comments to Marcel at
m.dekogel@student.utwente.nl

