
KONG EMULATOR V0.2
------------------

Main emulation code (C) 1996 Gary Shepherdson
Z80 emulation engine (C) 1995,1996 Marat Fayzullin

Emulates the arcade games Donkey Kong and Donkey Kong Jr
and now Mario Bros too!

I'll try to add Donkey Kong 3 to this emulator if someone
provides me with the ROM images.

At present the following things are not correctly emulated :

1) Sound (none yet!)
2) Colours (much better but still not perfect)
3) Sprite priorities (a minor problem)

If anyone can provide help with these then please contact me.
The schematics for these games would be useful.

Video mode 1 has been removed as it was bugged and caused a
lot of problems. Video mode 3 is now mode 1. Mode 3 is just 
a bug-fixed version of mode 1.


Hardware Requirements
---------------------
A 486DX-33 (486DX2-66 recommended)
MS-DOS V5.0 (or later)
A VGA compatible video card


Files required
--------------

The ROM image files must be placed into the same directory as the
emulator.

The ROM images for DONKEY KONG must be named :

DK.3F
DK.3H
DK.3N
DK.3P
DK.5A
DK.5B
DK.5C
DK.5E
DK.7C
DK.7D
DK.7E
DK.7F

The ROM images for DONKEY KONG JR must be named :

DKJ.3H
DKJ.3N
DKJ.3P
DKJ.5B
DKJ.5C
DKJ.5E
DKJ.7C
DKJ.7D
DKJ.7E
DKJ.7F

The ROM images for Mario Bros must be named :

MARIO.3F
MARIO.3J
MARIO.6K
MARIO.7C
MARIO.7D
MARIO.7E
MARIO.7F
MARIO.7M
MARIO.7N
MARIO.7P
MARIO.7S
MARIO.7T
MARIO.7U


Standard Keys
-------------

1		1 player start
2		2 player start
3		Add a credit
KEYPAD +	Increase emulation speed
		(decreases the Vblank interrupt period)
KEYPAD -	Decrease emulation speed
		(increases the Vblank interrupt period)
PAGE UP		Scroll the screen up when Mario and Kong Jr are not on screen.
		This key only works when video mode 2 is selected.
PAGE DOWN	Scroll the screen down when Mario and Kong Jr are not on screen.
		This key only works when video mode 2 is selected.
ESC		Quit the emulator


Extra Keys for Donkey Kong and Donkey kong Jr
---------------------------------------------

CURSOR KEYS	Move up,down,left,right
LEFT ALT	Jump
LEFT CTRL	Jump
SPACE		Jump
ENTER		Jump


Extra Keys for Mario Bros
-------------------------

LEFT CURSOR	Player 1 move left
RIGHT CURSOR	Player 1 move right
LEFT CTRL 	Player 1 Jump
RIGHT CTRL 	Player 1 Jump

Z		Player 2 move left
X		Player 2 move right
TAB 		Player 2 Jump

F1		Enter test mode (hold down for 2 secs)


Command Line Options
--------------------

-1			Play Donkey Kong.

-2			Play Donkey Kong Jr.

-3			Reserved for Donkey Kong 3 which I have NOT emulated yet.

-4			Play Mario Bros.

-m1			Video mode 1 (256x256x256). The default video mode
			previously known as mode 3. In this mode the whole of the
			game screen is visible. This is a non-standard video mode
			which may not work correctly on some PC's. If you have
			problems with this mode, use mode 2.

-m2			Video mode 2 (Mode 13h 320x200x256). In this mode
			only 4/5 of the game screen is visible. The screen
			scrolls to follow Mario or kong Jr. This mode can
			NOT be used with Mario Bros. The scrolling keys can be
			used in this mode to view the part of the screen that
			you can't see but they only work when Mario and Kong Jr
			are not on screen. If you can't see your score at the
			end of a game then you can use these keys to find out
			what you got.

-m3			This video mode has been removed. Use mode 1 instead.

-vp <period>		Set VBlank interrupts period [7000].
			Note that there must be a space before the period value.
			Decrease the period to make the game run faster.
			This value can be changed during play using the
			emulation speed keys.
			Has no effect when -sync option is used.

-fps			Displays approximate game speed in frames/sec.
			The correct arcade speed is approximately 60 frames/sec.

-sync			Syncronises Vblank interrupts with the PC display.
			This gives smoother graphics and a constant frame rate.
			The emulation speed keys have no effect in this mode.

-p			Patches the game code so that screens play in 1-2-3-4
			order. This option can only be used with Donkey Kong
			and Donkey Kong Jr. It may not work with some versions
			of the ROM images.

-sw <hex number>	Sets the game's dip-switches.


Version History
---------------

0.2	Mario Bros Added!
	Improved colour emulation (but still not perfect).
	Video mode 3 removed.
	Fixed bug which caused minor screen corruption.
	
0.12	Tweaked version of the non-standard video mode added which
	will hopefully be compatible with more video cards.

0.11	New video mode added based on a standard video mode (13h) as
	a temporary solution for the people having problems with the
	non-standard video mode.

0.1	Initial version. Donkey Kong and Donkey Kong Jr emulated.
	No sound. Colours and sprite priorities not correctly emulated.


Please send bug reports and comments etc. to Gary at :
od67@dial.pipex.com
PLEASE DO NOT ASK FOR THE ROM IMAGES!
