
                  Diamond Run Arcade Machine Emulator



                              Version 0.22



                          (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 late eighties arcade game, 
Diamond Run. 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
       DIAMOND.EXE         Executable
       DIAMOND.TXT         You're reading it!
       CWSDPMI.EXE    DOS DPMI server program. Required for MS-DOS

       ROM files (Not supplied)
       DIAMOND\D1
       DIAMOND\D2
       DIAMOND\D3
       DIAMOND\D3O
       DIAMOND\D5O
       DIAMOND\D5
       DIAMOND\D6
       DIAMOND\D7
       DIAMOND\D8
       DIAMOND\D9
       DIAMOND\D10
       DIAMOND\D11
       DIAMOND\D14  
       DIAMOND\D17


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

  ESC    Exit to DOS

Player keys
  CURSOR Direction
 
  or use joystick.



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

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

Switch settings are not yet available for this game.

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.


History:
--------

v0.1 19-05-1997 First release

 First release. 

v0.2 21-05-1997 
 FM music support thanks to Ishmair
 Improved video modes. Non-scanlines runs full screen. Scanline mode
  is bigger. This will not affect VESA or the MATROX compatible mode.
 Fixed the energy display graphic bug.

v0.21 02-06-1997 
 Fixed display lockup on some configurations.

v0.22 02-06-1997 
 Save game feature added.


Known problems/todo list:
-------------------------

CPU
 Still not sure about the ROM paging. Runs up to level 23 without any
  problems. Level 23 appears to be the last level.

Video
 Slightly jerky at the moment. 

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 a problem, 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 "DIAMOND:" at the start of the subject line. Otherwise
it may get deleted by mistake.


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

I have set up an arcade home 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)

