               JROK's Arcade Simulation - Multigame
               ------------------------------------


Release 1.1 - 11th April 1998
-----------------------------


Section         

0.  Release Notes
1.  New Features & Game Notes
2.  System Requirements
3.  Running the Simulator & Command Line options
4.  Game ROM files
5.  Quickload/Save feature
6.  Save Settings
7.  Test Mode Keys
8.  In Game Keys
9.  Player Keys & Joystick
10  Video mode considerations
11. Future Additions
12. Release History
13. Contract Information
14. Thanks



0. Release Notes
-----------------

These are just some quick notes about the emulations.
Hopefully someone will actually read before sending emails.

Pacland screen scrolling - The background screen in PacLand does
scroll slightly jerkly, this is true for the original TOO it's
MEANT to do that. It's just a little harder to see on the arcade
machines monitor.

Pacland sprites - White area's of sprites, like the ghosts eyes,
base of flying saucers, pacmans eyes etc. will always appear
in front of trees. This is a 'feature' of the original game,
so no complaints about it doing this, it's not a bug.

To make it easier to run the two versions of Pacland, the Namco
version and the Midway version, I've made TWO command lines for
Pacland. One is Pacland ( for the Midway ) and Paclandn for
the Namco. You need to put the ROMs for each of the versions
in directories named Pacland and Paclandn.


Gaplus/Galaga 3 - A lot of people ask "What is the difference ?"
Well, Galaga 3 is the Bally/Midway licensed version of Gaplus.
Midway licensed a lot of Namco games for US release.

For answers on what the .DIP file is check the 'save settings'
section.



1. New Features v1.01
---------------------

- Pacland support
- F12 saves screen dump
- Game name follows directory name



2. System Requirements
----------------------

Pentium 100 or better + a fast video card !

Each game has different CPU requirements, Mappy and Super PacMan will
run fine on anything from a Pentium 100

Sky Kid requires a little more horsepower so it really needs a
Pentium 133 or better, ideally a Pentium 166.

Pacland will run on a P133 with fast video with frame sync
disabled !

To improve speed on a slower machine try the following:

- Disable frame sync 'w' option on command line
- Disable Joystick
- Run in DOS mode, not in a windows/win95 DOS box
- Dont use soundblaster audio

If you're running using an Intel FX or LX chipset try using
the fastvid program ( not included ) this is a useful utility
which really improves video performance.





3. Running the Simulator & Command Line options
-----------------------------------------------

jas GAME [v] [n] [t] [w] [c<value>] [da<value>] [da<value>] [dc<value>] 
                         [m<value>] [s<value>]  [l<image> ] 

[] - brackets indicate optional values


GAME      - the game to run

            Pacland               - Pacland
            Paclandn              - Pacland - Namco release
            Gaplus                - Gaplus
            Galaga3  or gal3      - Galaga3
            Skykid   or Sky       - Skykid
            digdug2  or dd2       - dig dug2
            mappy                 - Mappy
            super or superpac     - Super PacMan 

            Note: See Game ROM files


Options
-------

v         - Use VESA video mode. SEE video mode considerations

            This uses the VESA standard mode of 400x300x256 colors,
            current the STB Velocity 128 is the only card I know of
            which supports this mode without an additional driver.
            The STB card has a VESA bios of version 3.0.

            In the case of Sky Kid the Vesa mode of 320x240 is used.

            Notes:
            1.  This will require a VESA Bios that supports the mode,
                not all VESA drivers support all the modes !
                For a vesa driver goto http://www.scitechsoft.com

            2.  Configure the low res VESA modes for a refresh
                of 60Hz, if you don't the game will run TOO FAST.


c<value> - Sets soundcard.

            1 = soundblaster
            2 = AWE32/64
            3 = GUS

            Note: If soundcard cannot be initialized, game will
                  play without sound effects.


t         - No test switch. Game runs without going through selftest

n         - No menus. No menus will be displayed, use this with
            the 'l' option to load a game and immediately exit
            using the ESC get. By default the game will start
            from fresh reset.
                    
da<value> - Set dip switch A ( 0 - 3 )     

db<value> - Set dip switch B ( 0 - 7 )

dc<value> - Set dip switch C ( 0 - 7 ) 

            Note: By default, dip-switch settings are loaded at game
            start from a file called the-game-name.dip


m<value> - Sets video mode. Value between 1 & 3,
            1 - standard settings
            2 - raster lines
            3 - alternative version of 1
            Note: This option will not do anything when you
                  select the VESA mode

l<value> - Loads a saved image. Specified by value 1 to 9
            The image file will be loaded and automatically run.


s<value> - Slows downs the game. Causes the game to pause
            on video frame refresh ( slows down the video mode 2 ).
            eg. s2   drops every second frame ( value 2-4 ).

w        - No wait for Video Sync.  Stops the wait for video frame
           refresh.  Disabling this option means the game will run
           faster.




4. Game ROM Files
-----------------

The ROMs for each game need to be placed in sub-directories
named after the games. The following directories are required

DugDig2
Galaga3
Gaplus
Mappy 
Pacland   
Paclandn   for 'Paclandn' the Namco version
SkyKid
SuperPac



Note: ROM files for these games MUST be complete
      ie. colour and sound PROMs, the simulator
      contains no original game data. Everything
      must be supplied!


See the file ROMLIST.TXT for details of filenames.



5. QuickLoad/Quick Save feature 
--------------------------------

At any point during game play, the image may be saved. This is a
snapshot of the system memory and game status, you can reload this
game later by using either the command line 'l' option, or pressing
shift and the function key (see next paragraph).

During game play hitting the function key, f1 to f9 will save a game
image ( the number being the same as the function key eg. in Gaplus
hitting f1 save a file called gap-dat1.sav )

Hold down SHIFT and a function key f1-f9 to load an image.

After loading the image will automatically start playing.


6. QuickLoad/Quick Save feature 
--------------------------------

Save settings saves the current simulator configuration, these are

- Current soundcard selection
- Joystick calibration
- key controls
- DIP switch settings for the game.

A file called 'game name'.DIP is created. This contains the settings
for number of lives, rank and extra life ( extend ) options that
can be set in the test mode, or via the command line da, db & dc
options.

The configuration file is called JAS.CFG

7. Test Mode Keys 
-----------------

By default the game selected will reset and start in test mode,
this can be skipped by using the t command line option.

 F10 end test mode

 4 - number of lives
 5 - bonus options
 6 - rank               ( mappy, Super Pac, Gaplus/Galaga 3 )

 left-right-enter plays sound effect


Keys 4,5 & 6 alter the dip-switch settings of the game.

Your settings can be saved, by returning to the main menu and
selecting the Save -> Save Settings option.

A file called 'the-game-name.dip' is created which contains the
dip-switch settings you just set, game-name is the name of the
game you are playing.



8. In Game Keys
---------------

 3    - add credit
 1/2  - 1, or 2, player start

 F1 -> F9             - Save game image
 SHIFT  F1 -> F9      - Load game image


 F10  - start test mode

 F12  - save screen dump in .BMP format

 Esc  - return to menu  ( or exit if 'n' specified on command line )



9. Player Keys & Joystick
--------------------------

Use the 'define keys' function on the menu to setup the
keyboard controls.

To use two joysticks, for Sky Kid's two player mode, you'll
need to use a Y-splitter.


VERY IMPORTANT:

Only Sky Kid supports a second set of player keys, the other
emulations will only use the PLAYER ONE set of keys.
Same is true for the joystick, only Sky Kid uses the player
two joystick.  This is how the original games operated, its
not something I can change !!



10. Video mode considerations
-----------------------------

The VESA option uses a mode of 400x300x256 colors. This mode is
supported on the STB Velocity 128 ( with a default of 60Hz refresh ).
Other cards will require an additional VESA driver.


For a really good ( the best ?) VESA driver you can get see Scitech's
Display Doctor, their web site is at http://www.scitechsoft.com

REALLY IMPORTANT: Make sure the 400x300x256 mode is set to
60Hz refresh! The game will run TOO FAST without it.

Using  Scitech's Display Doctor use the UVCONFIG -e60 to set
the low res refresh rate to 60Hz.



11. Future Additions
-------------------

Better soundblaster sound, support for more games.



12.Release History
------------------

v1.0 Feb  8th 1998  - First relase, Gaplus, Galaga3, skykid, Mappy,
                      Dig Dug2, Super Pacman

v1.1 Apr 10th 1998  - Pacland support



13. Contract Information
-----------------------

JROK can be contacted with comments or bug reports via his website at

http://www.jrok.com/

Any future updates and/or bug fixes will be distributed from this site.



14. Thanks
----------

Thanks must go to.. Kev, Dave, Kim and Mike plus everyone else who's
helped in the production and testing ( apologies in advance for anyone
I've forgotten here ).

Special thanks go to Dave for having the freakiest machine on the
planet which exhibited a 1 in 20 bug and held up this release while
we tracked it down.....

Beta testing help thanks go to Dave, Kev, Kim, Rik Lucas - for
receiving almost a million beta releases, Ben Jenkins, Gary and
anyone else who helped.



14. Release History
-------------------

v1.01

 - Pacland support
 - Game name can match ROM directory
 - Screen Dump using F12



v1.00

 - All games emulated in one shell.
 - Two player support in Sky Kid
 - Save/Load feature added to keyboard control
 - Saved images now increased to 9
 - Full command line support
 - Test mode override
 - VESA video mode support
 - Fully Y2K compliant

