-------------------------
- Reality Boy emu Frontend v0.82.0 - 05/18/2005
-------------------------

----------------------
- Copyright Info/Disclaimer
----------------------
This Reality Boy emu frontend is Copyright (C) David Tucker 
1997-2004, all rights reserved.
   You may use this code as long as you make no money from the use 
of this code and you acknowledge the original author (Me).  I reserve
the right to dictate who can use this code and how (Just so you don't
do something stupid with it).
   Most Importantly, this code is swap ware.  If you use It send along
your new program (W/code) or some other Interesting tidbits you wrote,
that I might be Interested in.
   This code is In beta, there are bugs!  I am not responsible for any
damage done to your Computer, reputation, ego, dog or Family Life due
to the use of this code.  All source is provided as is, I make no
guaranties, and am not responsible for anything you do with the code
(Legal or otherwise).
   Virtual Boy is a trademark of Nintendo, and V810 is a Trademark of
NEC.  I am in no way affiliated with Either party and all Information
contained hear was found freely through Public Domain sources.

--------
- History:
--------
05/18/05 - Added support for joystick.

04/14/05 - Added support for the pport option and reworked zoom as a dropdown.

03/03/05 - Fixed it so that spaces in the rom path were ok.
 Updated documentation to handle the 2/24 updates
 Fixed settings.h so we no longer incude useles headers (oops)

02/24/05 - Added in switches to enable/disable the folowing:
 Disasembly during debug
 Debug message dump to the console instead of a file
 Turn off speed throttling
 Turn on a status line, currenly only shows FPS

02/21/05 - Finished first build

--------
- Usage:
--------

 rboy_front.exe is a simple progrem that can be used to pass arguments
to the reality_boy emulator.  Here is a rundown of the various options
and there ramifications.

Emulator Path: The path to the reality_boy executable

Rom Path: The path to the rom to run in the emulator

Display mode: set the screen resolution frame (window) is the 
  default mode

3D Mode:
    Choos normal or a 3D display mode
    Red Blue is analgraph mode
    Interlaced should support mostshuter glasses, as well as I-glasses

Pallet: Select the apropriet pallet

Frame Skip: Number of frames to skip before refreshing the display
    hit -/= while in the game to adjust this as well

Key map: Select standard or alternate keyboard mapping

Zoom: Set the level of zoom on the display (1x-6x) or stretch to fill the window in full screen mode.

VB Controller: Select the paralel port that your VB controller is hooked up to.

Joy: Enable joystick support (preliminary).

Status Line: display the FPS during emulation, press '0' to togle in game

Swap Display: flip the 3D efects (you can hit ']' while in 
    the game to do this as well)

Long Timmer Hack: Force a longer duration to the timmer

Vertical Force hack: Fixes Vertical Force, game won't run without this

No Throttle: turn off all speed throtling

Debug: starts the interactive debugger, currently only works in the
    debug build

Dissasembly: generate disasembler dump of all code executed during emulation

Console Output: dump debug messages to the console instead of to a file

--------------------------------------------
Keyboard:
--------------------------------------------
  'p'          - printscreen, saves the current display in a .bmp file
  ']'          - flip the 3D efects
  '-'-'='      - adjust the frame skip
  '0'          - toggle fps status indicator
  <Esc>        - quit the emu

Controller Maping 1:
  up,down,
    left,right - (Up,Down,Left,Right) LControler
  F,V,C,B      - (Up,Down,Left,Right) RControler
  Q,W,         - (Start,Sel)
  A,S          - (L,R)
  Z,X          - (A,B)

Controller Maping 2:
  E,D,S,F      - (Up,Down,Left,Right) LControler
  V,B,N,M      - (Sel,Start,B,A)
  I,K,J,L      - (Up,Down,Left,Right) RControler
  G,H          - (L,R)

 
--------------------------------------------
Debug Usage:
--------------------------------------------
***** Debug is currently disabled in the release build*****

u - unassemble the next 16 instructions
d - dump the next 16 bytes (should be words(32bits))
t - trace through next instruction
b - Run continusly, break at address
j - Jump Straight to address
r - show Registers and next instruction (Without executing)
v - Go to Video Mode (View the various screen structures...)
	On all screens!
	 q,<ESC> - quite the video mode (Fast)
	 p - print the virtual screen to a .bmp file

	C - chr ram
	O - Obj map
	B - Bgmap (hit any key to cycle through all 14 bg maps,
             <esc> to exit early)
	W - World (Hit any key to Cycle through all 32 World Maps,
             <esc> to exit early)
	R - Rom, view the rom graphically like VB_View.exe
		u/d - Up/Down 1 line
		U/D - Up/Down 1 page (Screen)
		+/- - Up/Down 1 Byte (To realign sprites when not
                  on even boundary's)
		</> - Left/Right 1 char (Sprite)
		1/2 - Shrink/Expand  the # of columns displayed,
                  helps align pictures in the rom (vBaseball,
                  and vGolf are great candidates for this
		H - help, prints this list...
	P - Print the buffers to err.txt (So we can see the world array)
	D - Display mode, start up the Interrupts and go.
            Asks for Display mode 
	    (normal display or a series of 3D options)
		<ESC>     - quit....
		E,C,S,F   - (Up,Down,Left,Right) LControler
		V,B,N,M   - (Sel,Start,B,A)
		I,'<',J,L - (Up,Down,Left,Right) RControler
		G,H       - (L,R)
		0-9       - Frame Skip
		[,]       - 3D orientation...

m - dump Memory to the hard disk
? - help
q - quit
i - Generate Interrupt # 
l - set the debug level (0<all>-10<none>)


--------
- too do:
--------
* Open dialog at last screen position
* Fix up debug mode in emu so we can switch modes on the fly.
* List all roms in a directory complete with extracted titles
   and known good dump status

---------------------------------------------  
v810 is a trademark of NEC co.
Virtual Boy is a trade mark of Nintendo
I amd in no way affiliated with either of these parties
---------------------------------------------
David Tucker
david.tucker@goliathindustries.com
http://www.goliathindustries.com/vb/
 
