                ******* Virtual GameBoy MS-DOS *******
                The Portable Nintendo GameBoy Emulator
                             version 0.6.2

     Core emulator code copyright (C) 1995,1996  Marat Fayzullin
           MS-DOS port copyright (C) 1996  Marcel de Kogel

         (*) GameBoy is a registered trademark of Nintendo.

This file contains notes about features specific for VGB-DOS 0.6.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. The first 64 colors are reserved
              for use by the emulator
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
F1-F4 - Toggle sound channels 1-4 on/off
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
                   3 - 180x144 full screen mode
                   Please note that modes 2 and 3 may not be compatible with
                   your VGA card or monitor
-background        Select .GIF file to use as background (Only works in
                   video mode 0)
-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
-stereo            Select stereo mode (mono, normal, or reversed)
-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 - Gray
                   1 - Green
                   2 - Yellow/Blue
                   3 - High contrast green
                   4 - Yellow
                   5 - Amber
-spritecolorscheme Same as -colorscheme, but only changes the sprite colors
-windowcolorscheme Same as -colorscheme, but only changes the window colors.
-definecolorscheme Define a color scheme. Color schemes 0 to 127 are reserved,
                   schemes 128 to 255 can be defined
-spritecolor0, -spritecolor1, -spritecolor2, -spritecolor3
                   Same as -colorX, but only changes the sprite colors
-windowcolor0, -windowcolor1, -windowcolor2, -windowcolor3
                   Same as -colorX, but only changes the window colors
-brightness        Select image brightness
-spritebrightness  Select sprite brightness
-windowbrightness  Select window brightness
-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, pink, 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.6.2  Fixed a major bug in the GB's timer interrupt scheme and a minor bug
       in the RAM page allocation scheme
0.6.1  Fixed lots of bugs, added sprite color control
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!
