
                       1942 Arcade Machine Emulator



                              Version 0.5




                          (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, 
1942. 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.

To enjoy this game as it should be played, use your monitor controls to
squash the screen vertically. It should be thin and tall.


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

       Distribution files
       1942.EXE         Executable
       1942.TXT         You are reading it!
       CWSDPMI.EXE      DOS DPMI server program. Required for MS-DOS

       ROM files (Not supplied)
       1942\1-C11.BIN 
       1942\1-F2.BIN 
       1942\1-N4.BIN 
       1942\1-N5.BIN 
       1942\1-N6.BIN 
       1942\1-N7.BIN 
       1942\1-N3.BIN 
       1942\2-A1.BIN 
       1942\2-A2.BIN 
       1942\2-A3.BIN 
       1942\2-A4.BIN 
       1942\2-A5.BIN 
       1942\2-A6.BIN 
       1942\2-L1.BIN 
       1942\2-L2.BIN 
       1942\2-N1.BIN 
       1942\2-N2.BIN
       1942\F01_SB-0.BIN
       1942\K06_SB-1.BIN           
       1942\01D_SB-2.BIN
       1942\02D_SB-3.BIN
       1942\06D_SB-4.BIN
       1942\08E_SB-5.BIN
       1942\09E_SB-6.BIN
       1942\10E_SB-7.BIN
       1942\03K_SB-8.BIN
       1942\01M_SB-9.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
  F7     Display DIP switch settings

  ESC    Exit to DOS

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


History:
--------

v0.10 13-03-1997 First Release


v0.11 14-03-1997

Tidy-up release.        

 Better scroll colour scheme. 
 Scroll tile X/Y flipping bug fixed.


v0.2  17-03-1997

 Sound support. May impact users with lower spec machines. Turning off
  the sound will improve performance. 

v0.3  25-03-1997

 I now use standard PC keyboard IO routines for licence screen. Non-UK
  keyboards, pressing Y will now work. Are there any other keys that do
  not map correctly on non-uk keyboards.
 Slightly improved palette scheme, some of those cyans and magentas have
  gone.
 Corrected missing sprite plane (graphics not aircraft). 
 Palette extracted into separate file. Primitive palette editor implemented
  in debug version. Someone is working on the palette for me. Screen shots
  would be *really* helpful.
 General user interface tidy-up
 Implemented the sprite visibility/ Y MSB bit. No more planes wrapping the
  top of the screen.
 PC screen blit routine re-written in assembler. Should theoretically be
  smoother. Can't notice the difference myself.
 Option to turn off / turn on background music. I would leave it off.
 Provided another screen option that should help people with some video
  card monitor problems. Let me know if you are still having display
  problems.

v0.4 18-04-97
 MUCH better palette. Thanks to Iain Barker for digitising the palette.
  Still not finished yet but worth a release anyway.
 Speed closer to the original. Still not finished yet.
 VESA scanline and VESA video mode for users with slow lo-res 3d graphics
  cards.
 Sprite slowdown problems improved.
 Syncs up with the video hardware. Much smoother now, however slower
  machines may be hit *really* badly. Let me know what you think. I might
  make this optional.

0.5 
 Arcade perfect palette. You will need the palette PROMS. The colour
  mix needs a little adjustment.
  

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

Video
 Video drawing code needs optimising and smoothing. 
 Investigate using a video mode that better reflects the real aspect ratio
  of the game. The real game should be squashed vertically. 
 Sprites appear abruptly at the bottom of the screen instead of scrolling
  on gracefully. 
 Slight slowdown when sprites get busy on later levels.
 Sprite clipping on title screen.

Sound Problems
 Emulator information screens and pause mode do not cut off the sound.
 One of the sound channels is choppy.
 Uneven speed.
 Engine drone should probably restart after a sound effect has finished.

Misc  
 No way of changing DIP switch settings.
 General code tidying / rewrite.
 More speed. Needs at least a P133 to run with full sound. 



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:
------------------

I would welcome feedback as to how the game runs (AFTER READING THE KNOWN
PROBLEMS SECTION ABOVE). 

  What's the lowest spec. PC that this runs on?
  Is the game running at the right speed (on a high spec. PC)?  
  Is the music running at the right speed (on a high spec. PC)?

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
anything please include "1942: " 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 1942 and other emulators.

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 Video 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.

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


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

Iain Barker     for digitising the palette screens and recording the
                original sound track. 

Paul Swan       For help with the colour system.
                (http://easyweb.easynet.co.uk/|swan/arcade.htm)

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)

Roberto Ventura Decoding the sprites for Ghosts and Goblins.



