MasterGear Amiga
                                   V1.0d
                              by Mark Van Hal


	MasterGear Amiga is an Amiga port of MasterGear Unix by Marat
Fayzullin. For information about MasterGear Unix, please read the file
MG.doc that is included in this archive. This document will explain the
differences between MasterGear Amiga and MasterGear Unix.
	There have been several enhancements and changes made to MasterGear
in porting it to the Amiga, these include adding a GUI (and removing the
command line interface), different graphic drivers, and a newer version
of the CPU emulation. MasterGear amiga can be loaded from WorkBench or the
CLI. No icon tooltypes or command line options are required or used. When
started, the GUI will allow you to control all options that were available
via the command line in version 1.0c, with the exception of verbose mode,
and vperiod has been changed to cycles/line to allow more exact timing.

The gadgets in the GUI work as follows :

Update Period  -This is the number of V-Blank interrupts between screen
		updates. Increasing the value will make MasterGear run
		faster, but graphics will appear jerky.
Cycles/Line    -This is the number of CPU cycles per line. The default
		value of 261 seems to work perfectly will all the games
		that I tested. A smaller number will make some games appear
		to run faster, or might make them not run at all.
Emulation Mode -When set to Auto, MasterGear will attempt to determine
		if a ROM image is from a MasterSystem or GameGear based on
		the file extension (.sms or .gg). If you set it to SMS or GG
		you can force it to use one mode or another.
Autofire Button A/B -When set these gadgets will autofire (if you hold the
		button down, it will act as if you had pressed and released
		it repeatedly) button A or B respectively.
Control        -Not much choice here...(yet)
Language       -Run in English or Japanese mode. Some games have different
		intro screens or other differences based on if they are run
		on an english or japanese MasterSystem/GameGear.
Delay V-RAM Reads -Some games won't work properly with out this enabled 
		(such as GP Rider), but most work fine.
Gfx Mode       -Three different graphics drivers can be selected. ECS/OCS
		used a 32 colour screen. AGA uses a 64 colour screen (but
		will likely change to 256 colour in future versions) and
		OLD uses a 64 colour screen. The OLD driver is the same one
		that was in 1.0c,it is slow and it does not properly show
		the full palette of the GameGear. Both ECS/OCS and AGA are
		much faster and do properly show the full palette of the
		GameGear, but do not work properly with games that make
		palette changes in the middle of the screen display to
		try to show more then 32 colours (such as Space Harrier).
Screen Mode    -Select the screen mode for the emulator to use.
Double Buffer  -The ECS/OCS and AGA gfx drivers will cause screen flicker
		if double buffering is turned off, but with it on the
		emulator screen is not dragable, and will always be switched
		to the front. Double buffering slows the emulation down 
		slightly. Has no effect with the OLD gfx driver.
Delay Palette  -When enabled, palette writes are synchronized with screen 
		updates, this fixes some graphic glitches in some games
		(Mortal Kombat 1&2) and also allows you to play some games
		that make palette changes during the screen display with the
		ECS/OCS or AGA gfx drivers, but some colours may not be
		correct (Space Harrier, California Games). When disabled
		palette writes are immediate, this makes games that use 
		palette changes for fades look much smoother, even with
		a high update period. If you use an update period of one,
		you should enable this.
Start	       -Pretty much self explanatory...
Quit           -Pretty much self explanatory...

Above the Start and Quit gadgets there is a string gadget that is used
for the full path name of the ROM image you wish to use, and beside it
is a getfile gadget that will bring up an ASL file requester to make loading
ROM images easier. If your ROM image does not end in .sms or .gg (case does
not matter) then be sure to set the emulation mode to SMS or GG.

There is also a Info menu with two choices : About... provides some
information about the emulator, and Help... shows you what keys are used
to control the emulator.

The current version of the emulator is up to 2.2 times the speed of 1.0c
and this will improve in the future as I begin to code parts of it in ASM.
I also intend to include support for sound and joysticks in future versions.

I would like to thank Marat Fayzullin for writing MasterGear Unix, and for
making the source code available, I would also like to thank Craig Howard
for the icon (he also did a 16 colour icon, but my only copy of it is on a
disk that I don't have with me right now. It will be included in the next
version.)