===========================
S I D E W A Y   v0.22a
===========================
Author Johan S

Sideway is an emulator for some old Midway 8080 games.

It is a DOS program, but runs fine in Windos 95 (At least on my system).

(A Linux version, and maybe a Java version is planned for the distant future).

**********************************************************************************
The program may not be redistributed in any way. The only legal place to get the
progam from is from its internet hompage maintained by its author.
The webadress is http://home8.swipnet.se/~w-87724/arcpreserv.html
If you have gotten this copy elsewhere, it has been pirated.

**********************************************************************************

What is Below?

1.  Romnames & Supported Games
2.  Known problems
3.  How to start it
4.  How to find the keys to use
5.  About sound
6.  Help I need
7.  Special info on some games
8.  How to make a snapshot (Use F12)
9.  Contact adresses
10. Thanks




1. Romnames & Supported games
=============================

The following games are emulated if their respective ROMS are available:

Gunfight, Seawolf, Boothill, Maze, invaders + some more should work, but many more have
attempts to emulation. Just type sideway to see 
a list of which games have attempts to emulation.

The roms should be in a subdirectory with the same as the game.

If not all Roms are available, the program will tell you which it needs, =>
starting with sideway <game> is the way to find out which ROMS/ROMNAMES you need.


(Seawolf,gunfight,invaders,maze,invdelux,boothill should work,
 tbball, rr, guidem,zzapp is added without testing, since I dont have proper ROMS,
 they MIGHT work a bit, if so contact me to send me the ROMS and I will finish them.
 Spaceatt and galaxwars work a bit, but the emulation is not compleete.)

 I am also interested in adding the rest of the games for this hardware. If you have another
 set of ROMS for a game not yet supported, let me know.



2. Problem
==========
I am using the Allegro sound library, with soundblaster autodetect. It is a bit unstable on 
some systems.

I dont know how to fix this, other than using somthing else than allegro for sound, which I
dont want to, since I think Allegro is great, and if this is a Allegro problem, 
there must be a way to fix that in Allegro.
 
Any help appreciated.

In the meanwhile, the -ns option can be used to turn off sound support if you have troubles.


3. Start
========
If have tried to include as much information as I can in the executable.

If you start with sideway only, you will get a list of the games emulated.

Then you can start the emulation by typing 

sideway <game> [-ns]

where game is from the list given with the sideway command.
 
The -ns is an option to turn off sound support,
if you have problems running sideway, try starting without sound.


4. Keys
=======
Some games display keys on startup, in others they are not emulated, or you will have to
find them yourself.


5. Sound
========
Is emulated through samples in Seawolf, Boothill and Gunfight. 
Other games are finished on request only.


6.Help Me
=========
* I need someone to record the samples for Seawolf and Gunfight.

* And someone that can tell me how to emulate
keys in Space Encounters. What inputs are needed? Should the thing move in x,y only, or are there
supposed to be a z coordinate too? Then there is a fire button, but is there more controls ?

* I need working ROMS for all games that does not work, and for the midway 8080 games 
that I have not included yet.

7. Game Info
=============

Boothill
--------
Ok, I think ?

Sound is available through samples. Samples should be in wav format and placed in the same 
directory as the ROMS, with the names:

snd2.wav=coin in
snd4.wav=computer fire
snd5.wav=player fire
snd6.wav=computer hit
snd7.wav=player hit


Gunfight
--------
I think it is as it should now. You will have to feedback me to get anything else done.

Samples are included if you put wav files in the Gunfight directory. 
Names are snd0.wav...snd7.wav
I dont know which are which.



SeaWolf
-------
Sound is available, provided that the samples are in the same directory as
the ROMS, with names sndx,wav, where x is 0 to 4.

snd0=boathit, snd1=torpedo,snd2=cruiser,snd3=new mine,snd4=minehit

Should there be more samples ?






8. SNAPSHOT
===========
F12


9. CONTACT
==========

Ideas, suggestions, tips:


mail:     arcadepreserv@hotmail.com
Homepage: http://w1.311.telia.com/~u31102265/arcpreserv.html

10. THANKS
===========
Marat M has made the Z80 engine I have used.
I am using the Allegro Library
