
                  Ghosts 'n Goblins Arcade Machine Emulator



                              Version 0.32



                          (C) 1997 Paul Leaman



Legal Disclaimer:
-----------------

YOU USE THIS PROGRAM AT YOUR OWN RISK, I CANNOT BE HELD RESPONSIBLE FOR ANY 
LOSS OR DAMAGE CAUSED.

THIS PROGRAM REQUIRES THE ORIGINAL ARCADE MACHINE ROMS. THESE ROMS ARE 
OWNED BY AND COPYRIGHTED BY CAPCOM. UNLESS YOU OWN THE ORIGINAL GAME 
BOARDS, YOU ARE NOT LEGALLY ENTITLED TO USE THEM. I CANNOT BE HELD 
RESPONSIBLE FOR ANY REACH OF COPYRIGHT.

THIS PROGRAM DOES NOT SHIP WITH ROM IMAGES. DO NOT DISTRIBUTE THIS
PROGRAM WITH ROM IMAGES.

PLEASE DO NOT ASK ME TO SUPPLY YOU WITH ROM IMAGES OR ASK ME WHERE TO FIND 
THEM. I CANNOT HELP YOU.


Introduction:
-------------

This program emulates the hardware for the mid eighties arcade game, 
Ghosts and Goblins. To use it, you must have a copy of the ROM images from
the original arcade game. These images are available on the net, just use
a search engine. Please do not ask me about ROM images.


This is still at an early stage. Sound support has now been re-enabled.
I wouldn't use it if I were you since it is slow even on a P166.



Requirements:
-------------

Machine:   IBM PC running MS-DOS, Windows 95 or OS2
Processor: Unknown at present. Probably requires a good Pentium.
Memory:    



Installation:
-------------

1) Create a directory on your hard disk.
2) Change to the directory and unzip this archive into it. 
3) Create a GG directory off your installation directory
4) Copy all ROM files into the GG directory.

       Distribution files
       GG.EXE         Executable
       GG.TXT         You're reading it!
       CWSDPMI.EXE    DOS DPMI server program. Required for MS-DOS

       required ROM files (Not supplied)
       GG\GG1.BIN 
       GG\GG2.BIN 
       GG\GG3.BIN 
       GG\GG4.BIN 
       GG\GG5.BIN 
       GG\GG6.BIN 
       GG\GG7.BIN 
       GG\GG8.BIN 
       GG\GG9.BIN 
       GG\GG10.BIN 
       GG\GG11.BIN 
       GG\GG12.BIN 
       GG\GG13.BIN 
       GG\GG14.BIN 
       GG\GG15.BIN     

       Configuration files (generated by emulator) 
       GG.DIP         DIP switch settings
       GG.SAV         Saved game
       GG.CFG         Emulator settings


Command-line options:
---------------------


-setup          Setup options. Automatically starts up in this mode
                when no .CFG file is found. Settings are saved to .CFG file.


Keys:
-----

System keys
  F1     Help
  F4     Pause, press again to unpause
  F5     Reboot system
  F6     Reboot into test mode
  F7     Display DIP switch settings
  F12    Screen dump

  S      Save game
  L      Load game

  ESC    Exit to DOS

Player keys
  CURSOR Direction
  ALT    Fire
  CTRL   Jump
 
  or use joystick.



DIP switches:
-------------

DIP switch settings are loaded from the .DIP file. Use a binary editor to
change the settings.

Switch settings can be found on WWW.SPIES.COM.

Changing the settings may cause the emulated game to halt. This was a
feature of the original arcade machine ("screen stop"). If you manage to
do this by accident press escape to exit. It may not be possible to coin-up
correctly yet.

If you get into trouble, delete the .DIP file. A new one with default
settings will be automatically generated the next time you run the game.


The game is currently set on easy mode. I will be providing a mechanism to
change this in the future.

History:
--------

v0.1 13-05-1997 First release

 First release. 


v0.2 19-05-1997 
 Video drawing speed increase. Tile and sprite blitting re-written in
  Assembly language.
 Sound enabled. Still too slow to be of any use. 

v0.3 30-05-1997
 FM Music thanks to Ishmair's YM2203 engine.
 Major speed improvements.
 Improved video modes. Non-scanlines runs full screen. Scanline mode
  is bigger. This will not affect VESA or the MATROX compatible mode.

v0.31 02-06-1997
 Optimized display blitting bug fixed. Caused lockup on some configurations
  Sorry about that.
 Fixed the sprite clipping problem.

v0.32 06-06-1997
 Added save game feature. 


Known problems/todo list:
-------------------------
 
Video
 Slightly jerky at the moment.

Sound Problems
 Sound is still a little slow.
 Music plays in mono on some sound cards.

Misc  
 No way of changing DIP switch settings.
 General code tidying / rewrite.
 More speed. 
 General tatty messages and error handling.


Frequently Asked Questions/Trouble shooting:
--------------------------------------------

Q) I have installed over an older version and the setup does not run.
A) Either delete your .CFG file or use the -setup command line option.

Q) The graphics update seems a little slow. I have a 3D graphics accellerator
   card.
A) Try one of the VESA video modes. 

Q) The game seems a little slow.
A) Try turning off the sound.


Technical Support:
------------------

If you have any problems, let me know. 


e-mail:
-------
         my email address is:     paull@phonelink.com
 
I WILL NOT ANSWER ANY QUESTIONS REGARDING ROMS OR WHERE TO FIND THEM. 

Please bear in mind that this is my work email account and I am very busy
during the day. It may take a while to respond to your queries. If you send
aything please include "GG:" at the start of the subject line. Otherwise
it may get deleted by mistake.

World Wide Web
--------------

I have set up an arcade page at Geocities:
http://www.geocities.com/TimesSquare/Dungeon/7939/arcade.html


The following sites are excellent sources of information on emulation. They
are in no particular order and are all worth a visit. I have no control 
over the content of any of these pages.

http://www.anfiteatro.it/1942/1942.html
                        Unofficial 1942 emulator home page. This contains 
			information on this and my other other emulation 
			projects. Contains technical information.

http://www2.datacomm.ch/~camelot
                        Thomas Hammel's Emulation zone

http://www.xs4all.nl/~delite/index.html
                        Atmospherical heights

http://198.142.78.4/~moose/
                        Moose's Shareware and Emulation Valley

http://ds.dial.pipex.com/nick.woodfine/
                        Interzone

http://dspace.dial.pipex.com/dodge/index.htm
                        The PC arcade


http://www.gamepen.com/gamewire/classic/classic.html
                        Dave's Video game classics


Arcade emulation technical information:

http://www.spies.com/arcade/index.html
                        Archive of technical information. 


There are many other sites (My bookmarks are a little chaotic at the moment,
I am sure that I have missed some of the major sites). If I have missed a
good site let me know. Please let me know if any of these links are invalid,
some seem to change faster than I can keep up with.

If you own a web site and would like to receive updates, please drop me
an e-mail.

                                                                                                                                                                                                                                                                                                                        Archive of technical information. 

Thanks to:
----------

There are many people, without whom this project would never have got off 
the ground.

Ishmair         for the FM YM-2203 music engine.


Marcel de Kogel and Marat Fayzullin for the Z80 engine source code

Nicola Salmoria for MAME source code.

Roberto Ventura for information on the paging system used in the game. Without
                this, I could never have started this project. Thanks for
                providing technical information regarding the palette as well
                as filling in the missing pieces. 

Michael Cuddy   for information on the YM-2203 sound chip and source
Ville Halik     code for the PSG simulator.
                (http://www.fensende.com/Users/mcuddy)

Jean-Marc Leang for helping me out by providing tips and ideas. 

James R. Twine 	for the commando schematics 
                (http://pages.prodigy.com/jtwine/cm-schem.htm)

David Shoemaker and John Keay for the DIP switch settings
                (http://www.spies.com)

