
                       VULGUS Arcade Machine Emulator



                               Version 0.2




                           (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 early eighties arcade game, 
VULGUS. 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.


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 VULGUS directory off your installation directory
4) Copy all ROM files into the VULGUS directory.

       Distribution files
       VULGUS.EXE       Executable
       VULGUS.TXT       You are reading it!
       VULGUS.PAL       Palette file
       CWSDPMI.EXE      DOS DPMI server program. Required for MS-DOS
       FILE_ID.DIZ      BBS file ID

       ROM files (Not supplied)
       VULGUS\1-3D.BIN
       VULGUS\1-8N.BIN
       VULGUS\1-4N.BIN
       VULGUS\1-7N.BIN
       VULGUS\1-6N.BIN
       VULGUS\1-5N.BIN
       VULGUS\2-2A.BIN
       VULGUS\1-11C.BIN
       VULGUS\2-4A.BIN
       VULGUS\2-5A.BIN
       VULGUS\2-3A.BIN
       VULGUS\2-6A.BIN
       VULGUS\2-7A.BIN
       VULGUS\2-5N.BIN
       VULGUS\2-4N.BIN
       VULGUS\2-3N.BIN
       VULGUS\2-2N.BIN


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 (not available)
  F7     Display DIP switch settings

  ESC    Exit to DOS

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


History:
--------

v0.10 ??-04-1997 First Release

v0.20 28-04-1997 Scrolling tidy up
 Provided a better kludge for the scrolling.


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

Video
 Terrible colours. 
 Scrolling still not right. High score table does not display logo. Jumping
  should now be fixed. Still can't locate the mechanism for the title reset.
 Possible star-field effect missing from the title screen.

Sound Problems
 Emulator information screens and pause mode do not cut off the sound.

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


Frequently Asked Questions/Troubleshooting:
-------------------------------------------

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 accelerator
   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, please 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
anything please include "VULGUS: " at the start of the subject line.
Otherwise it may get deleted by mistake.


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

I do not currently have web access, there are a number of sites from which
you may obtain updates and information on VULGUS and other emulators. You
may want to try out my 1942 emulator. It's a lot better than this one :)

The following sites are excellent sources of information on emulation. They
are in no particular order and are all worth a visit. 

http://www.anfiteatro.it/1942/1942.html
                        Unofficial 1942 emulator home page. This is a new
                        site. I will be providing technical information in
                        the near future.

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 Vidoe game classics



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.




Arcade emulation technical information:

http://valhalla.ph.tn.tudelft.nl/emul8/arcade.html
                        Arcade Emulation Programming Repository. Provides
                        info and source code for programming arcade
                        emulators.

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



CWSDPMI
-------

CWSDPMI is a freeware DPMI server. You can obtain updates and source code
from:

        ftp://ftp.simtel.net                  Or any other simtel mirror.



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

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

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

Nicola Salmoria for the MAME source code.

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 during the
                early stages of development.

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)

