File: dgen.1

package info (click to toggle)
dgen 1.23-9
  • links: PTS
  • area: non-free
  • in suites: etch, etch-m68k
  • size: 2,168 kB
  • ctags: 3,087
  • sloc: ansic: 45,403; cpp: 4,405; sh: 1,960; makefile: 116
file content (108 lines) | stat: -rw-r--r-- 3,008 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
.Dd February 21, 2001
.Dt DGEN 1
.Sh NAME
.Nm dgen	
.Nd Sega Genesis/MegaDrive emulator
.Sh SYNOPSIS
.Nm dgen
.Op Fl PRfhjv
.Op Fl D Ar DEMONAME
.Op Fl d Ar DEMONAME
.Op Fl n Ar USEC
.Op Fl p Ar CODE,CODE...
.Op Fl r Ar RCFILE
.Op Fl X Ar XFACT
.Op Fl Y Ar YFACT
.Op Fl S Ar FACT
.Op Fl G Ar XxY
.Op Fl s Ar SLOT
.Ar romname
.Sh DESCRIPTION
The rom image in the file
.Ar romname
is executed, as emulated on a Sega Genesis or MegaDrive running in 60Hz NTSC
mode (unless the
.Fl P
option is specified, in which case 50Hz PAL mode is used).
.Ar romname
should be in raw binary or SMD format, and may be compressed with
.Xr gzip 1 ,
.Xr zip 1 , or
.Xr bzip2 1 .
.Pp
The options are as follows:
.Bl -tag -width Fl
.It Fl P
Emulate 50Hz PAL mode (as used in European models of the MegaDrive).
.It Fl 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).
.It Fl f 
Run fullscreen, if possible.
.It Fl h
Show a brief synopsis of all options.
.It Fl j
Use joystick, if running on Linux with joystick drivers >= 1.0.
.It Fl v
Show the version number, and exit.
.It Fl D Ar DEMONAME
Play back a demo recorded with the
.Fl d
option.
.It Fl d Ar DEMONAME
Record a demo of the program running, which can be later replayed with the
.Fl D
switch.
.It Fl n Ar USEC
Sleep for a number of microseconds after every frame, to give time to other
processes.
.It Fl p Ar CODE,CODE...
Modify the ROM image in memory, using Game Genie or Hex style codes. Game
Genie codes are of the form
.Ar ABCD-EFGH
and Hex codes are in the form
.Ar 123456:ABCD .
To specify more than one code, separate them with commas (do
.Ar not
use spaces).
.It Fl r Ar RCFILE
Parse another rc file after $HOME/.dgen/dgenrc. Values in the specified file
override those in the preceding files.
.It Fl X Ar XFACT
Scale the window XFACT times in the X direction. XFACT must be a positive
integer.
.It Fl Y Ar YFACT
Scale the window YFACT times in the Y direction. YFACT must be a positive
integer.
.It Fl S Ar FACT
Scale the window FACT times in both directions. FACT must be a positive integer.
.It Fl G Ar 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.)
.It Fl s Ar SLOT
Load the saved state from the given slot at startup (0-9)
.El
.Sh FILES
.Bl -tag -width $HOME/.dgen/dgen/saves/* -compact
.It Pa $HOME/.dgen/dgenrc
Contains user settings for the emulator.
.It Pa $HOME/.dgen/saves/*
Save states generated by the emulator.
.It Pa $HOME/.dgen/ram/*
Battery-backup RAM images, generated by the emulator for ROMs with save RAM.
.El
.Sh SEE ALSO
.Xr gzip 1 ,
.Xr bzip2 1 ,
.Xr zip 1 ,
.Xr dgenrc 5
.Sh AUTHORS
This
manual page was written by
.An Joe Groff Aq joe@pknet.com .
.Sh BUGS
PAL mode does not work very well yet. Numerous buffer overruns
(think twice before making dgen setuid-root).
.Pp
Send any bugs you find (and fixes too, please :) to
.An Joe Groff Aq joe@pknet.com .