VIRTUAL-E Emulator 1.0 READ ME FILE      Update: 14/6/1999

TABLE OF CONTENTS
1.  Warning
2.  Changes
3.  About Virtual-E
4.  Using Virtual-E
5.  About the ROMs.
6.  Known bugs
7.  Possible Improvements

========================= 1. Warning
This product is provided AS IS, without warranties of any kind.
Use it at your own risk. Remeber that is freeware. Don't sell this emu.

========================= 2. Changes
1.0 Version (June 14th)
        - Finally it looks like a decent emulator (with many changes internally :).
        - Basic Sound emulation (if you dont like the sounds, turn it off!).
        - New fullscreen style.
        - More options like Ignore Palettes (useful for playing Panic Bomber
          and WaterWorld) and Save/Load RAMs.
        - Improvements in HBias/OBJ Worlds, Display wrapping and Direct VB Display memory.
        - Many bugs solved (the most important is the keypad config).
        - Includes the Croach demo.

0.3B Version (April 18th)
        - Emulates partially or complete some commercial games like VTetris,
          Galactic Pinball, Teleroboxer. InsaneMouse Mansion and Mario Tennis
          present many problems on emulation.
        - New GUI with 2 window styles, normal and pocket.
        - Improvements in OBJs, palettes and interrupts.

0.2B Version (March 28th)
        - More advanced options, like brightness and keypad configuration.
        - First aproximation to Display/Time/Key Interrupts emulation.
        - Some commercial games boots, like Teleroboxer, VTetris | Insane Mouse.
        - Now requieres OpenGL32 to configure the keypad.

0.1B Version (March 12th)
        - Complete V810 opcode emulation.
        - Basic Interrupt emulation.
        - New windows-less style menu.
        - Option command to customize the emu.
        - Teleroboxer & Insmouse games trying to start but fails in timmer int.
        - Full compatibility for simple demos.

0.1A Version (February 19th)
        - ROM Reading Complete.
        - ROM Info provided.
        - GUI Interface fully complete.
        - Uses DirectX 2.0 for full? compatibility with NT.

========================= 3. About Virtual-E
Virtual-E is a freeware emulator for NEC's V810 Microproc (alias Virtual
Boy's proc.) written with Win32 and DirectX in C++.
This emulator is based on information and code provided by David Tucker and
the documentation provided by NEC Semiconductors on V8XX Family Arquitecture.
This program is part of an ambicious project to connect the Virtual Boy to
an IO port for graphic purposes. Please check all about the project at:

http://www.emuunlim.com/VirtualE
http://members.xoom.com/virtuale98

To e-mail us:
        Alberto Covarrubias
        Virtual-E Project
	-------------------------
        virtuale98@yahoo.com

========================= 4. Using Virtual-E
As many Windows programs, the Virtual-E practically provides a self-learn-guided
interface. In this version, to do emulation you must load a ROM, after this,
you can start the emulation, load information about rom, stop emulation and
reset. The Virtual-E provides some options, like the priority of each
thread in the emu, the frame rate and skip rate values, and the keypad
configuration.
For PII/300 or higher processors we recomend to move the display thread to
High Priority to get bigger FPS and let the CPU emulation works like the real
VB. Try it.
We think the use of our emu isn't a problem, but if you don't know how to use
an option, send us an Email.
Just remember, the program requierements are:
- A Pentium processor (with a PII 300 or greater, it kick some %$#%).
- Windows 95/NT installed.
- DirectX 3.0 or higher installed.
- OpenGL for windows installed (with opengl32.dll and glu32.dll).
- An AGP Card should be perfect but is optional.

========================= 6. About the ROMs
After some mails asking about what games really works with this emu and where
can you get them, I decide to add this section to the readme file.

As many other emulators have said in their readme files:
" In order to use VirtualE with commercial rom images, you MUST have
  purchased and own the original rom cartridge. If you use rom images
  that are illegally in your posession you are in violation of United
  States and International laws ".

So... be sure to have the original games before using this emu.

Next, the games that works with this emu are:
- Galactic Pinball              - Playable
- Insane Mouse Mansion          - Playable
- Mario Clash                   - Partially Playable
- Panic Bomber                  - Playable (with Ignore Palette option enabled).
- Teleroboxer                   - Playable
- Mario Tennis                  - Partially Playable
- Virtual Fishing               - Playable
- Virtual Tetris                - Partially Playable
- WaterWorld                    - Playable (with Ignore Palette option enabled).

The other ROMs just boots but display the "Warning" message or does not display
nothing. Please, do not send emails asking for when this games will be
playable or not, or where you can get the ROMs. This mails will be deleted
immediatly.

========================= 6. Known bugs
- Some IRQ problems (remember that neither David Tucker nor I have all the VB info).
- Affin Worlds not supported.
- Sound emulation isn't complete.

========================= 7. Possible Improvements
- More window styles.
- Interrupt/Display performance to emulate more commercial games.
- Solve the bugs? What the &%$!
