NAME

     dgen  — Sega Genesis/MegaDrive emulator

SYNOPSIS

     dgen [-PRfhjv] [-D DEMONAME] [-d DEMONAME] [-n USEC] [-p CODE,CODE...]
          [-r RCFILE] [-X XFACT] [-Y YFACT] [-S FACT] [-G XxY] [-s SLOT]
          romname

DESCRIPTION

     The rom image in the file romname is executed, as emulated on a Sega
     Genesis or MegaDrive running in 60Hz NTSC mode (unless the -P option is
     specified, in which case 50Hz PAL mode is used).  romname should be in
     raw binary or SMD format, and may be compressed with gzip(1), zip(1), or
     bzip2(1).

     The options are as follows:

     -P          Emulate 50Hz PAL mode (as used in European models of the
                 MegaDrive).

     -R          If running with root priviledges, set priority to -20, so no
                 other processes interrupt (including the X server, which can
                 be a Bad Thing).

     -f          Run fullscreen, if possible.

     -h          Show a brief synopsis of all options.

     -j          Use joystick, if running on Linux with joystick drivers >=
                 1.0.

     -v          Show the version number, and exit.

     -D DEMONAME
                 Play back a demo recorded with the -d option.

     -d DEMONAME
                 Record a demo of the program running, which can be later
                 replayed with the -D switch.

     -n USEC     Sleep for a number of microseconds after every frame, to give
                 time to other processes.

     -p CODE,CODE...
                 Modify the ROM image in memory, using Game Genie or Hex style
                 codes. Game Genie codes are of the form ABCD-EFGH and Hex
                 codes are in the form 123456:ABCD.  To specify more than one
                 code, separate them with commas (do not use spaces).

     -r RCFILE   Parse another rc file after $HOME/.dgen/dgenrc. Values in the
                 specified file override those in the preceding files.

     -X XFACT    Scale the window XFACT times in the X direction. XFACT must
                 be a positive integer.

     -Y YFACT    Scale the window YFACT times in the Y direction. YFACT must
                 be a positive integer.

     -S FACT     Scale the window FACT times in both directions. FACT must be
                 a positive integer.

     -G XxY      Use OpenGL to render the screen, if available. The parameter
                 is the width and height of the desired screen (e.g. 640x480,
                 800x600, etc.)

     -s SLOT     Load the saved state from the given slot at startup (0-9)

FILES

     $HOME/.dgen/dgenrc        Contains user settings for the emulator.
     $HOME/.dgen/saves/*       Save states generated by the emulator.
     $HOME/.dgen/ram/*         Battery-backup RAM images, generated by the
                               emulator for ROMs with save RAM.

SEE ALSO

     gzip(1), bzip2(1), zip(1), dgenrc(5)

AUTHORS

     This manual page was written by Joe Groff ⟨joe@pknet.com⟩.

BUGS

     PAL mode does not work very well yet. Numerous buffer overruns (think
     twice before making dgen setuid-root).

     Send any bugs you find (and fixes too, please :) to Joe Groff
     ⟨joe@pknet.com⟩.

                               February 21, 2001