

                   ******* Virtual GameBoy *******
                The Portable Nintendo GameBoy Emulator
                             version 0.5

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

         (*) GameBoy is a registered trademark of Nintendo.

This file contains notes about features specific for VGB-DOS 0.5.2

Note: VGB-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 (486DX2-66 recommended)
A VGA compatible video card
Adlib/Adlib Gold/SBPro/SB16 and joystick supported

Files included in VGB-DOS.ZIP
==============================
VGB-DOS.EXE   The emulator
VGB.DOC       The main documentation file
VGB-DOS.TXT   This file
VGB-DOS.GIF   A GIF file containing the title screen. You can replace this
              with your own. Make sure the file is in 256-color, 320x200,
              non-interlaced GIF87A format.
CWSDMI.ZIP    A DPMI server required by VGB-DOS.EXE

Key Mapping
===========
Alt        - Button A
Ctrl       - Button B
Left Shift - Start
CapsLock/Z - Select

Special Keys
============
Del - Swap joystick buttons
End - Swap keyboard buttons
F5  - Toggle sound on/off
F11 - Decrease volume. Volume control only works on SBPro and SB16 compatible
      sound cards
F12 - Increase volume
ESC - Quit emulator

Command line options
====================
The following command line options are added:
-video             Select video mode
                   0 - 320x200 with title screen
                   1 - 320x200 without title screen
                   2 - 360x144 full screen mode. This mode may not be
                   compatible with your VGA card or monitor
-sound             Select sound mode
                   0 - No sound
                   1 - Adlib
                   You may want to have the sound turned off by default for
                   certain games, as the emulation isn't nearly perfect
-volume            Select initial volume. 0 is silent, 15 is maximum. Volume
                   control only works on SBPro or SB16 compatible cards
-colorscheme       Select a pre-defined or user-defined color scheme
                   Currently pre-defined color schemes are:
                   0 - Grey
                   1 - Green
                   2 - Yellow/Blue
-definecolorscheme Define a color scheme. Color schemes 0 to 127 are reserved,
                   schemes 128 to 255 can be defined
-swapbuttons       Select buttons to swap
-ifreq             Select interrupt frequency. If you want your games to run
                   faster, increase the interrupt frequency. If you want them
                   to run slower, decrease it. Use -ifreq 0 to disable sync
Some command line options may be abbreviated. You can get a list of supported
abbreviations by using the -help command line option

Color names supported
=====================
The following color names can be used with the -colorX options:
black, blue, green, cyan, red, magenta, brown, gray, dkgray, dkblue,
dkgreen, dkcyan, dkred, dkmagenta, yellow, orange, white. You can also
specify an RGB value with #RRGGBB, e.g. -color0 #AA0055 will set color 0 to
brown.

Configuration files
===================
The emulator loads two configuration files (if present) before it loads
a cartridge rom: VGB-DOS.CFG located in the emulator's directory and
CART.CFG (e.g. DKONG.CFG if you load DKONG.GB) located in the cartridge
dump's directory. These are plain text files containing optional command
line options. Options can be separated with spaces, tabs or returns.

History
=======
0.5.2  Major speedup, added sync option, fixed some bugs, added color
       scheme support and a few other options
0.5.1  Initial release

Credits
=======
The GIF decoding routines and the title GIF itself were taken from Jeff
Frohwein's code. Jeff also helped fixing some bugs in the emulator. Thanks
Jeff!
VGB-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
BUT PLEASE, DO NOT ASK FOR ROM IMAGES!
