JROK's Arcade Simulator (JAS)  - DIG DUG 2
==========================================

Greetings, welcome to the full release v1.00 of JAS, this program
is designed to simulate the functioning of the Namco Dig Dug 2
arcade game.

This simulator is intended as an educational tool by owners of
the original game.

It should not be sold or charged for IN ANY WAY SHAPE OR FORM.
This program is freeware.

This program should not be distributed along with the ROMs.


Contents
========

- Features
- The Simulator & Development History
- Setup
- Saving & Loading Options
- Controls
- Simulator's Home Web-site
- Thanks & Credits
- Release History



Features
========

- 100% emulation of the original game
- 100% acurate colors
- 100% acurate sound emulation
- User definable playing keys
- Save & Restore Game Images
- Fast assembler based
- Windows friendly ( run's under Win'95 & NT )
- Multiple Soundcard Support


The Simulator & Development History
===================================

The simulator is a mix of 'C' and assembler, the 6809E simulation
engine is 100% assembler. The surrounding support routines, i.e.
screen interface, menu etc. is all written in 'C'.

I coded the simulator over the months of May and June, the first
release being at the San Diego arcade party on June 28th. There's
even a picture of the emulator running mappy !

Both CPU's of the original board are simulated along with the
8 channel sound. All the ROMs from the original game are required
as the simulator contains NO code or data from the original game.
All graphics, colors and waveforms are converted to a usable form
'on-the-fly' within the simulator.

The following file names ARE required form the ROMS


ROM                 Size        Function
------------------------------------------------------
DDUG2-1  BIN        16,384      Game CPU Program ROM
DDUG2-3  BIN        16,384      Game CPU Program ROM
DDUG2-4  BIN         8,192      Sound CPU Program ROM


DDUG2-3B BIN         4,096      Character SET ROM

DDUG2-3N BIN        16,384      Sprite ROM 0
DDUG2-3M BIN        16,384      Sprite ROM 1

DDSND    BIN           256      Sound Waveform PROM
DDCLR-5B BIN            32      Master Color PROM
DDCLR-5K BIN           256      Character Color PROM
DDCLR-4C BIN           256      Sprite Color PROM




Setup
=====

Make sure ALL the ROMs & PROMs are in a sub-directory called
DigDug2.

For audio ensure that the BLASTER variable has been set
to the correct Port, IRQ & DMA.

Card detection for AWE-32 and Gravis Ultrasound is automatic.

Game settings are saved in the file DIGDUG2.CFG if you delete
this file, settings will be reset to their defaults.


Saving & Loading Options
========================


Save Settings 
-------------

This option will save the current configuration details to the
file DIGDUG2.CFG these are

        - Joystick Calibration Details
        - Dip Switch Settings
        - Keyboard Controls

Save/Load Game Image
--------------------

This will save or load a complete dump of the game and current CPU state.
You can then reload this at a future time. 

File names for the 6 images are - DD2-DAT1.SAV to DD2-DAT6.SAV

You can save games in 'mid-play' and reload. Dip Switch settings
are also recorded in the .SAV files.




Controls
========

Keys are user definable in the game, however there are some
control keys.


F10 - turns test mode on/off ( game starts in test mode F10 to exit )
Test Mode:

        1/2 - advance tune
        3   - play tune

        F1  - Extend Type ( when extra live are awarded )
        F2  - Select On/Off ( starting level ) - defaults on
        F3  - Lives


You cannot adjust FREEZE of the credit options as these are
really pointless to change.


In-Play mode:

1 - One player Start
2 - Two player Start
3 - add credit

F10 - starts test mode ( resets game )

Defined the keys to whatever you want. 






Simulator's Home Web-site
-------------------------

http://www.cyberpass.net/~jrok

Note: YOU CANNOT GET THE ROMS FROM THIS SITE !


Sites which are known to contain ROM images are:

http://www.vu.union.edu/~peekb/arcade/
ftp://ftp.tant.com



Thanks & Credits
----------------

Dave Spicer, 6809 help and general help.
Lee Taylor for testing & input.
Brian Peek for the save/load game image idea.
Kim Voegele testing & input.
And everyone/anyone else who's helped.



Release History
---------------

v0.01  - June 28th - San Diego arcade party special release
v1.00  - July 16th - Fully featured 100% release

