               XGenEm   SEGA Genesis/SEGA Mega Drive  Emulator

                                 Version 0.11 

                     (c) 1996,1997,1998 by Markus Gietzen

+---------------------------------------------------------------------------+
  Linux Version:

     +486 or higher (386 doesn't work, speedy Pentium recommended)
     +8MB RAM       (16MB highly recommended)
     +installed SDL (Simple DirectMedia Layer) Library (>=0.7)
      Look at http://www.devolution.com/~slouken/SDL/ for a copy.
     +X11/DGA
   
  See 'Changelog' for changes since the last version 
+---------------------------------------------------------------------------+


E-Mail:      magi@stud.uni-sb.de    (may change very soon!)

WWW:         http://stud.uni-sb.de/~magi

Snail-Mail:  Markus Gietzen
             Ludweilerstr. 126
             66352 Grossrosseln
             GERMANY

0. _BEFORE_ you write me:

o Please note that I can't provide you with ROMs nor with URLs where
  to get ROMs from !!

o Please don't send me larger files without asking me first. Thanks !

o Read the FAQ !  Thanks.


1. DISCLAIMER

  I exclude any and all implied warranties, including warranties of
fitness for a particular purpose. I make no warranty or representation,
either express or implied, with respect to XGenEm, its quality, performance
or fitness for a particular purpose.
I shall have no liability for special, incidental, or consequential damages
arising out of or resulting from the use, misuse, or modification of XGenEm.

  All trademarks used in this documentation are property of their respective
owners.

2. Copyright / License

XGenEm is (c) 1996,1997,1998 by Markus Gietzen
The Z80-emulation is (c) 1994,1995,1996,1997 by Marat Fayzullin

XGenEm is free for private use !
This means that you can use XGenEm for free as long as you use it for your
_personal_ enjoyment. 

Commercial purposes mean that you offer XGenEm for money or you
offer XGenEm because of PR-reasons (PR=public relations).

!! CD-collections that are sold at a reasonable price (<=$20) !!
!! can include XGenEm for free _if_ it's sold by a private.   !!
!! Companies _always_ need to contact me first (even if you   !!
!! give it away for free!)                                    !!

3. Known problems:

 Known problems:
  o priority-handling is sometimes not correct
  o "Window" is missing (no score-display in several games)
  o most ECA-games fail.
    -> Press START as soon as the ECA-logo appears (this skips the ECA-intro).
  o smaller bugs in the DMA-handling
  o bugs in HBLANK-IRQ -> problems in racing games


4. Usage

Usage:  genem [-options] rom-image

Options:
-frame  x   - display every x.th frame (2=default)
-z80        - ENABLE Z80-emulation
-fakedz80   - FAKE Z80-emulation
-nogg       - Don't load GameGenie codes
-lock	    - Lock speed at 50 Hz
-sound      - Enables the _experimental_ sound-support (only PSG right now)
-europe     - European version   |\  USA is
-japan      - Japanease version  |/  default.

Supported file-formats:
 o .bin         binary dumps
 o .md, .mgd    Multi Game Doctor II
 o .smd         Super Magic Drive

Keys:
   cursor-keys     -    direction-select
   ENTER           -    start-button
   A               -    button A
   B or S          -    button B
   C or D          -    button C
   TAB             -    reset
   ESC             -    power-off
   F1              -    start-button for Player 1
   F2              -    start-button for Player 2

Please don't create your own file-extensions ! GenEm fails if it can't
determine a supported file-extension (an autodetect in an earlier
version failed because of some non-Sega-compliant ROM-headers).

If the emulation is too slow for you then try to skip several frames.

Battery-backed RAM:
  I think an example is the best way to show how this work:

      genem images\phstar2.bin

  Your RAM-contents are saved as "images\phstar2.sav" here.
  When you play phstar2.bin the next time these contents are
  loaded.
  Normally you don't have to care about that. Everything works
  like with a real cartridge. The only exception is: you load
  the game from a read-only medium (e.g. CD-ROM). Then it's not possible
  to save the RAM-contents.

GameGenie:
  XGenEm supports GameGenie codes. You can enter as much codes as you want
  for every game !
  GameGenie codes are loaded from a file with the extension ".gg".

  Example:
      "genem ..\images\sonic.bin"
      This will load the GameGenie codes from "..\images\sonic.gg"
      The file "sonic.gg" has one code each line. If you don't want
      that the codes are used, place "-nogg" in the command-line.

Locked speed:
  XGenEm will lock the speed and allows you the play games at real
  speed. XGenEm puts itself sleeping while it waits until it has to
  continue emulating.This means that it will decrease CPU-Load (depends
  on your CPU of course).
  E.g. on my K6-2 300MHz I've a CPU-Load of about 30% in this mode.

