JABAWAPE v0.8
Just Another Beginner's Attempt to Write A Phoenix Emulator
D. Finck 12 Dec 1998 / Th. Strathmann 3 Jan 1999
-----------------------------------------------------------

Features:
---------
-color MODE-X graphic display
-mostly sort of close to accurate colors, I think
-keyboard and joystick (analog or digital) game controls
-partial sound via PC speaker (default is OFF--you'll hear why...)
-selectable frameskip (0-3)
-selectable dipswitch settings via command line option
-game pause mode
-graceful game exit
-screenshot function 
-RAM dump
-Hiscore save/load (prelimary)
-Multigame support started

Instructions to compile (assuming you have DJGPP & Allegro installed):
----------------------------------------------------------------------
 Unzip all the files in a directory calleg JABAWAPE using the option -d 
 Then compile with the following command : 
  gcc jabawape.c z80/z80.c -s -O2 -lalleg

Instructions to use without compiling:
--------------------------------------
 Put the ROM images named below into the directory ROMS:
  ic23 ic24 ic39 ic40 ic45 ic46 ic47 ic48 ic49 ic50 ic51 ic52
  (note: there is no extension, I believe this is the same naming
   scheme MAME uses for this game)
 To run just type "JABAWAPE [GAME NAME] [OPTIONS]"
 The only game currently supported is PHOENIX.
 Note: there are no options available at the moment.

Keys:
-----
 ESC    = exit
 P      = pause
 S      = toggle sound on/off
 F      = adjust frameskip (0-3)
 ALT    = fire (only LEFT ALT key works on my rig...)
 CTRL   = shield (only LEFT CTRL key works on my rig...)
 LEFT   = left
 RIGHT  = right
 H      = saves current hiscore
 L      = restores hiscore
 D      = dumps RAM contents
 B      = captures the screen 
          (If you don't like these key's--change the source
           (file: misc.h) and re-compile, or use a joystick.)
 

Acknowledgments:
----------------
-Marat Fayzullin for his Z80 emulator core
-Michael Adcock for the "Arcade Emulator How-To"
-Chris Hardy & Brian Peek for their "Step-by-step"
 guide to emulating Phoenix
-Shawn Hargreaves for "Allegro"
-Richard Davies for the color information I copied from his Phoenix emulator
 (I copied the information, not the code...)
-James R. Twine for the information on Phoenix's sound

Odd Details about Phoenix:
--------------------------
-The high score is only updated from memory when a game is started.
-In two player mode, each player picks up where the other left off.
 (...at least it does with this program with the ROMs I have.  And
  so does MAME, however Chris Hardy's Win95 Phoenix emulator doesn't
  behave this way, it alternates like a "normal" video game does...)
-There is a two-digit number under "COINS" but the max it accepts is 9.

FAQ:
----
 Q: How do I get the ROMZ?
 A: You take the PCB out of your Phoenix cabinet and read the data
    from the ROM chips into files on you PC, using appropriate equipment.
 Q: How to contact the authors?
 A: You can contact us by simply mailing to <mul8@egroups.com> or
    visiting <zan.emuunlim.com/emul8>. 
    _DON'T_ ASK US OR ANYONE ELSE THERE FOR THE ROMS !!!

To-Do:
------
-add scanline video mode
-add speed monitoring & control
-add REAL sound
-add support for Pleiads
-support ZIPped roms...
