-------------------------------------------------------------------
Retrovaders V1.02, 29th June 1998
Written by Matthew Smith, 1998
-------------------------------------------------------------------

PLEASE DON'T DISTRIBUTE ANY ROM WITH THIS EMULATOR.  DOING SO MAY LEAD TO LEGAL ACTION BEING TAKEN BY THE LAWFUL COPYRIGHT HOLDERS THE THE ROM IMAGES. 

V1.02 - Released June 29th 1998
-------------------------------
Added Menu system - Thanks to Dan Huizenga for his bGUI Menu Extension.
Added 1 new Game - Space Fever

The menu system works quite well.  If your familiar with Callus then you'll know what to expect.  Also any window that displays itself is moveable, just click on the Title Bar. 

Please note that at this stage when loading a game that is not available or changing screen resolutions to one which your system can't handle, the emulator will return to DOS.  
                   

V1.01 - Released June 10th 1998
-------------------------------
Added support for the Seal Audio system to make emulator compatible with the MAME sound files.  These should be placed unpacked in the samples directory. (invsamp.zip, bhsampl.zip)


V1.00 - Released June 1st 1998
------------------------------
Initial release adding 25 games.


Introduction
------------
Thanks for downloading Retrovaders, by contribution to the great Arcade Emulation scene.  I decided to have a go at emulating something basic after seeing programs like MAME and also to learn a little about C.  While it may not be the best emulator, at least for me it's something I have been able to do myself.


Installation
------------
Install Retrovaders into any Directory you may choose.  Make sure -d is used when using pkunzip or Use Folder Names is selected when using Winzip so the appropriate directories are created. All roms are to placed in the ROMS directory under the appropriate game title.

Usage
-----
Using Retrovaders is fairly simple - I decided to use some keys and command line functions from MAME just to keep it standard.


From the command line type-

RETRO gamename [-res ?][-frameskip ?][-soundcard ?][-soundon][-soundoff]
               [-sr ?][-h/-?/-help][-list]

-res ?     	    Sets the following screen modes-
            	     320 - 320x240
            	     400 - 400x300
            	     512 - 512x384 (Default)
            	     640 - 640x480
		     800 - 800x600

-frameskip ?	    Sets the following screen updates (per second)
                     1 - 60 Frames (Default)
                     2 - 30 Frames
		     3 - 20 Frames
		     4 - 15 Frames

-soundcard ?        Select soundcard.  Will ask if not used.

-soundon (default)  Determine if sound is turned on/off
-soundoff

-sr ?	            Set Sample Rate - (between 0hz and 44100hz)
                     - 11025
		     - 22050 (Default)
		     - 44100
                    Sound quality is currently set at 16bits and Stereo

-list               Displays list of games
-h/-?/-help         Displays help Message

EG.   RETRO astinvad -res 400 -frameskip 2 -soundcard 1 -sr 44100


Whilst playing the game the following keys are used by each game

ESC      	- Exit Game
TAB             - Menu
F3              - Reset Game
F8		- Change Frameskip - 60,30,20,15
T		- Tilt (if supported in current game)
1		- Start Player1
2		- Start Player2 (if Supported)
3		- Insert Coin1
4		- Insert Coin2
Left        	- Player1 Left
Right		- Player1 Right
Up		- Player1 Up
Down		- Player1 Down
Control		- Player1 Button1
Alt		- Player1 Button2
Space		- Player1 Button3
D		- Player2 Left		<(For Games which have 2 players
G		- Player2 Right         < playing at the same time)
R		- Player2 Up		< 
F		- Player2 Down		< Boothill, Gunfight, Maze,
Comma		- Player2 Button1	< Guided Missile, Tornado BB
Stop		- Player2 Button2	<	
Slash		- Player2 Button3	<

Some games also use different/extra keys, refer 'Extra Stuff' for a listing of these.


Supported Games
---------------

Gamename			Directory    Added/Problems
---------------------------------------------------------
Astro Invaders			astinvad	v1.00
Boothill			boothill	v1.00
Clowns				clowns		v1.00
Cosmic Monster			cosmicmo	v1.00
Datsun 280-Zzzap 		zzzap		v1.00
Destination Earth		desterth	v1.00
Earth Invasion			earthinv	v1.00
Galaxy Wars			galxwars	v1.00
Guided Missile			gmissile	v1.00
Gunfight			gunfight	v1.00
Invaders Revenge		invrvnge	v1.00
Kamikaze			kamikaze	v1.00
Lunar Rescue			lrescue		v1.00
Lupin 3				lupin3		v1.00
Rolling Crush/Moon Base		rollingc	v1.00
Seawolf				seawolf		v1.00
Space Attack II			spaceatt	v1.00
Space Chaser			schaser		v1.00
Space Fever                     spacefev        v1.02
Space Invaders			invaders	v1.00
Space Invaders - Part II	invadpt2	v1.00
Space Invaders Deluxe		invdelux	v1.00
Space Phantoms			spaceph 	v1.00/(speed problems)
Space Encounter			spcenctr	v1.00
The Amazing Maze Game		maze		v1.00
Tornado Base			tornbase	v1.00

Bandido and Helifire have been tested but have timing problems? so they haven't been included yet. 

At this stage all games have their optium settings set with the dipswitches.


Extra Stuff
-----------

Boothill, Gunfight
------------------
Extra Keys   Player1  Pistol Up   - A    Player2  Pistol Up   - O
             Player1  Pistol Down - Z    Player2  Pistol Down - L

Datsun 280-Zzzap
----------------
Keys         Button1 - Z      This game actually has 5 buttons for
             Button2 - X      acceleration, but I have combined 3
             Button3 - C      of these into button 1 to allow easier
                              control of the game.

(Replaces normal Button1,2,3 as it easier to hold down)

Rolling Crush/Moon Base
-----------------------
Before starting (Key 1/2) any game push left for Rolling Crush or Right for Moon base.

Space Encounter
---------------
Controls are quite funny here as left/right and up/down are basically used separately to control the player's ship??

Tornado Baseball
----------------
All button keys for both players are used here to play the game.

Space Fever
-----------
Keys         Game 1 - Z      
             Game 2 - X      
             Game 3 - C      



Work to be completed
--------------------
Sometime in the near future I hope to do the following:-

Extend the new Menu System (better error checking for file loading)
High-score load/save
Dipswitch & Key Selection
Better timing and screen updates
Add any new games based on this same hardware
Release my source code so anyone can view poor C programming!!

Color and sound support has been added for most games, but at this stage I haven't included them in this release.  Also some games which MAME doesn't use sound for actually use the basic invaders sound!! 

Thanks
------

The following people need thanks for the creation of this emulator

Michael Strutt  - For his source code for which I have adapted
Marat Fayzullin - z80 emulator
Sean Hargreaves - Allegro V3.0 Library
Dan Huizenga    - bGUI Menu Extension
MAME Team	- Knowledge of each games memory setup
DJGPP C         - For the compiler
 
Anyone who can work this emulator stuff out!!!

If anyone is offended by my emulator please contact me - it's only here to learn!

Thanks to my bud Sharron for her understanding!!


Any questions or queries please forward them to amsmith@hotkey.net.au or visit my website at www.geocities.com/TimesSquare/Fortress/7269/

 
Regards,
Matt