Be nice with this, credit Neil, dont sell it - thats it for rules... 

--------------------
WHY DOES THIS EXIST?
--------------------

"A Space Invaders emulator for educational purposes by EMUL8"
"Multi-Z80 CPU emulator by Neil Bradley (neil@synthcom.com)"
	* full source code released for *every* release.
	* first freely available emu with mz80 :) code 
	* contributions welcome


------------------------------------------------
COMPILING THE SOURCE CODE - DJGPP, ALLEGRO, NASM
------------------------------------------------

invmz is compiled with DJGPP.  Graphics and keyboard functions are provided by
ALLEGRO.  Neil Bradleys MZ80 core needs NASM to assemble.  All you need to do is
make sure all this is setup on your machine.  

The MAKEFILE is included in the distribution.  Options are:

	*MAKE 		(to compile)
	*MAKE CLEAN 	(delete all object files and executables)
	*MAKE DEBUG 	(delete all invmz object and exe files - leaves mz80.o)

----------------
HOW DO I USE IT?
----------------

Note: an executable is not provided, as this emulator is for those wanting info...

1. Unzip the zip file into a directory of your choice
2. type MAKE to obtain the invmz.exe file
3. Create your subdirs like this :
	GAME NAME                       ROM DIR
	Space Invaders                  roms\Invaders
	Space Invaders Part 2           roms\Invadpt2
	Space Attack II                 roms\spaceatt
	Destination Earth               roms\desterth
	Galaxy Wars                     roms\galxwars
	Lunar Rescue                    roms\lrescue
	Galaxy Rescue                   roms\lrescue	
	Invaders Revenge                roms\invrvnge
	Lupin III                       roms\lupin3
	Space Chaser                    roms\schaser
	Ozma Wars                       roms\Ozma Wars

4. Type 'invmz' to see command line options.

The following keys do something:
			* 3 - inserts a coin
			* 1 - player 1 start
			* 2 - player 2 start
			* left arrow - move ship left
			* right arrow - move ship right
			* left control - FIRE
			* F3  - reset the emulator
			* ESC - Exit the emulator

---------------------------
What's new in this release?
---------------------------
Version 0.05: 

	* Added sound support (needs invaders.sam)
	* Added multiple game support

Version 0.04:

	* Added 2 Player Joystick Support

Version 0.03:

	* Added keyboard support for 2 players
	* Speed throttling using uclock() function..
	* Updated MZ80 core to version 2.4
	x missing sound support - no high scores saved

Version 0.02:

	* Added graphics display using allegro 
	x missing keyboard and sound support and the game is unthrottled 

Version 0.01:

	* First release! The whole thing is new!
	x A invmz.c file that compiles.. it runs, but is missing everyting.
	* get this version if you want the basic structure for an mz80 based emu


---------------------------------
EMUL8 - invmz Contact information
---------------------------------

Authors:
	*Zan (ben@netstra.com.au)
	*LD (                    )
	*Steb (steb@bigfoot.com)
MZ80:
	*Neil Bradley (neil@synthcom.com)
	ftp://ftp.synthcom.com/pub/emulators/cpu/makez80.zip (latest version)

AMOAD:	
	www.classicgaming.com/amoad


-----------------------------
What should be in the package
-----------------------------

README.TXT 	- this doc
INVMZxxx.c	- space invaders code to use the mz80 core.
MZ80.TXT  	- MZ80 documentation
MAKEZ80.C	- Multi Z80 32 Bit emulator emitter program
MZ80.H  	- C Header file for MZ80 functions
INVADERS.SAM	- Sound samples for the games

-----------
FINAL NOTES
-----------

If you have questions, comments, etc... about mz80, please don't hesitate
to send me an email. And if you use mz80 in your emulator, I'd love to take
a look at your work. If you have special needs, or need implementation
specific hints, feel free to email me, Neil Bradley (neil@synthcom.com). I
will do my best to help you.

