Subversion Repositories Kolibri OS

Rev

Blame | Last modification | View Log | Download | RSS feed

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4.   <meta charset="utf-8"/>
  5.   <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
  6.   <style>
  7.     table.head, table.foot { width: 100%; }
  8.     td.head-rtitle, td.foot-os { text-align: right; }
  9.     td.head-vol { text-align: center; }
  10.     .Nd, .Bf, .Op { display: inline; }
  11.     .Pa, .Ad { font-style: italic; }
  12.     .Ms { font-weight: bold; }
  13.     .Bl-diag > dt { font-weight: bold; }
  14.     code.Nm, .Fl, .Cm, .Ic, code.In, .Fd, .Fn, .Cd { font-weight: bold;
  15.       font-family: inherit; }
  16.   </style>
  17.   <title>DGEN(1)</title>
  18. </head>
  19. <body>
  20. <table class="head">
  21.   <tr>
  22.     <td class="head-ltitle">DGEN(1)</td>
  23.     <td class="head-vol">General Commands Manual</td>
  24.     <td class="head-rtitle">DGEN(1)</td>
  25.   </tr>
  26. </table>
  27. <div class="manual-text">
  28. <section class="Sh">
  29. <h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
  30. <p class="Pp"><code class="Nm">dgen</code> &#x2014; <span class="Nd">Sega
  31.     Genesis/Mega Drive emulator</span></p>
  32. </section>
  33. <section class="Sh">
  34. <h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
  35. <table class="Nm">
  36.   <tr>
  37.     <td><code class="Nm">dgen</code></td>
  38.     <td>[<code class="Fl">-Pfhmv</code>] [<code class="Fl">-R</code>
  39.       <var class="Ar">(J|U|E)</var>] [<code class="Fl">-H</code>
  40.       <var class="Ar">HZ</var>] [<code class="Fl">-D</code>
  41.       <var class="Ar">DEMONAME</var>] [<code class="Fl">-d</code>
  42.       <var class="Ar">DEMONAME</var>] [<code class="Fl">-n</code>
  43.       <var class="Ar">USEC</var>] [<code class="Fl">-p</code>
  44.       <var class="Ar">CODE,CODE...</var>] [<code class="Fl">-r</code>
  45.       <var class="Ar">RCFILE</var>] [<code class="Fl">-X</code>
  46.       <var class="Ar">XFACT</var>] [<code class="Fl">-Y</code>
  47.       <var class="Ar">YFACT</var>] [<code class="Fl">-S</code>
  48.       <var class="Ar">FACT</var>] [<code class="Fl">-g</code>
  49.       <var class="Ar">(0|1)</var>] [<code class="Fl">-G</code>
  50.       <var class="Ar">XxY</var>] [<code class="Fl">-s</code>
  51.       <var class="Ar">SLOT</var>] <var class="Ar">[romname [...]]</var></td>
  52.   </tr>
  53. </table>
  54. </section>
  55. <section class="Sh">
  56. <h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
  57. <p class="Pp">The ROM image in the file <var class="Ar">romname</var> is
  58.     executed, as emulated on a Sega Genesis or Mega Drive running in 60Hz NTSC
  59.     mode (unless the <code class="Fl">-P</code> option is specified, in which
  60.     case 50Hz PAL mode is used). <var class="Ar">romname</var> should be in raw
  61.     binary or SMD format, and may be compressed with <a class="Xr">gzip(1)</a>,
  62.     <a class="Xr">zip(1)</a>, or <a class="Xr">bzip2(1)</a>.</p>
  63. <p class="Pp">When <var class="Ar">romname</var> isn't specified, DGen starts
  64.    without a ROM. It can be loaded later from the prompt. When more than a
  65.    single <var class="Ar">romname</var> is specified, they are executed
  66.    sequentially.</p>
  67. <p class="Pp">The options are as follows:</p>
  68. <dl class="Bl-tag">
  69.  <dt id="H"><a class="permalink" href="#H"><code class="Fl">-H</code></a>
  70.    <var class="Ar">HZ</var></dt>
  71.  <dd>Use a custom frame rate, can be used to accelerate or slow down
  72.    emulation.</dd>
  73.  <dt id="P"><a class="permalink" href="#P"><code class="Fl">-P</code></a></dt>
  74.  <dd>Emulate 50Hz PAL mode (as used in European models of the Mega Drive).</dd>
  75.  <dt id="R"><a class="permalink" href="#R"><code class="Fl">-R</code></a>
  76.    <var class="Ar">(J|U|E)</var></dt>
  77.  <dd>Emulator region. Without this option, DGen uses the first region mentioned
  78.      in the ROM header. It should be combined with <code class="Fl">-P</code>
  79.      for PAL mode. See below.
  80.    <dl class="Bl-tag">
  81.      <dt>(none)</dt>
  82.      <dd>Autodetect (NTSC, 60Hz)</dd>
  83.      <dt id="P~2"><a class="permalink" href="#P~2"><code class="Fl">-P</code></a></dt>
  84.      <dd>Autodetect (PAL, 50Hz)</dd>
  85.      <dt id="R~2"><a class="permalink" href="#R~2"><code class="Fl">-R</code></a>
  86.        <var class="Ar">J</var></dt>
  87.      <dd>Japan (NTSC, 60Hz)</dd>
  88.      <dt id="R~3"><a class="permalink" href="#R~3"><code class="Fl">-R</code></a>
  89.        <var class="Ar">J</var> <code class="Fl">-P</code></dt>
  90.      <dd>Japan (PAL, 50Hz)</dd>
  91.      <dt id="R~4"><a class="permalink" href="#R~4"><code class="Fl">-R</code></a>
  92.        <var class="Ar">E</var></dt>
  93.      <dd>Europe (NTSC, 60Hz, music will certainly play too fast)</dd>
  94.      <dt id="R~5"><a class="permalink" href="#R~5"><code class="Fl">-R</code></a>
  95.        <var class="Ar">E</var> <code class="Fl">-P</code></dt>
  96.      <dd>Europe (PAL, 50Hz)</dd>
  97.      <dt id="R~6"><a class="permalink" href="#R~6"><code class="Fl">-R</code></a>
  98.        <var class="Ar">U</var></dt>
  99.      <dd>America (NTSC, 60Hz)</dd>
  100.      <dt id="R~7"><a class="permalink" href="#R~7"><code class="Fl">-R</code></a>
  101.        <var class="Ar">U</var> <code class="Fl">-P</code></dt>
  102.      <dd>Same as <code class="Fl">-R</code> <var class="Ar">E</var>
  103.          <code class="Fl">-P</code></dd>
  104.    </dl>
  105.  </dd>
  106.  <dt id="f"><a class="permalink" href="#f"><code class="Fl">-f</code></a></dt>
  107.  <dd>Run fullscreen, if possible.</dd>
  108.  <dt id="h"><a class="permalink" href="#h"><code class="Fl">-h</code></a></dt>
  109.  <dd>Show a brief synopsis of all options.</dd>
  110.  <dt id="m"><a class="permalink" href="#m"><code class="Fl">-m</code></a></dt>
  111.  <dd>MinGW only. This option prevents DGen from detaching from its control
  112.      console.</dd>
  113.  <dt id="v"><a class="permalink" href="#v"><code class="Fl">-v</code></a></dt>
  114.  <dd>Show the version number, and exit.</dd>
  115.  <dt id="D"><a class="permalink" href="#D"><code class="Fl">-D</code></a>
  116.    <var class="Ar">DEMONAME</var></dt>
  117.  <dd>Play back a demo recorded with the <code class="Fl">-d</code> option.</dd>
  118.  <dt id="d"><a class="permalink" href="#d"><code class="Fl">-d</code></a>
  119.    <var class="Ar">DEMONAME</var></dt>
  120.  <dd>Record a demo of the program running, which can be later replayed with the
  121.      <code class="Fl">-D</code> switch.</dd>
  122.  <dt id="n"><a class="permalink" href="#n"><code class="Fl">-n</code></a>
  123.    <var class="Ar">USEC</var></dt>
  124.  <dd>Sleep for a number of microseconds after every frame, to give time to
  125.      other processes.</dd>
  126.  <dt id="p"><a class="permalink" href="#p"><code class="Fl">-p</code></a>
  127.    <var class="Ar">CODE,CODE...</var></dt>
  128.  <dd>Modify the ROM image in memory, using Game Genie or Hex style codes. Game
  129.      Genie codes are of the form <var class="Ar">ABCD-EFGH</var> and Hex codes
  130.      are in the form <var class="Ar">123456:ABCD</var>. To specify more than
  131.      one code, separate them with commas (do <var class="Ar">not</var> use
  132.      spaces).</dd>
  133.  <dt id="r"><a class="permalink" href="#r"><code class="Fl">-r</code></a>
  134.    <var class="Ar">RCFILE</var></dt>
  135.  <dd>Parse another rc file after $HOME/.dgen/dgenrc. Values in the specified
  136.      file override those in the preceding files.</dd>
  137.  <dt id="X"><a class="permalink" href="#X"><code class="Fl">-X</code></a>
  138.    <var class="Ar">XFACT</var></dt>
  139.  <dd>Scale the window XFACT times in the X direction. XFACT must be a positive
  140.      integer.</dd>
  141.  <dt id="Y"><a class="permalink" href="#Y"><code class="Fl">-Y</code></a>
  142.    <var class="Ar">YFACT</var></dt>
  143.  <dd>Scale the window YFACT times in the Y direction. YFACT must be a positive
  144.      integer.</dd>
  145.  <dt id="S"><a class="permalink" href="#S"><code class="Fl">-S</code></a>
  146.    <var class="Ar">FACT</var></dt>
  147.  <dd>Scale the window FACT times in both directions. FACT must be a positive
  148.      integer.</dd>
  149.  <dt id="g"><a class="permalink" href="#g"><code class="Fl">-g</code></a>
  150.    <var class="Ar">(0|1)</var></dt>
  151.  <dd>Enable/disable OpenGL (if compiled-in).</dd>
  152.  <dt id="G"><a class="permalink" href="#G"><code class="Fl">-G</code></a>
  153.    <var class="Ar">XxY</var></dt>
  154.  <dd>Desired window size (e.g. 640x480, 800x600, etc.)</dd>
  155.  <dt id="s"><a class="permalink" href="#s"><code class="Fl">-s</code></a>
  156.    <var class="Ar">SLOT</var></dt>
  157.  <dd>Load the saved state from the given slot at startup (0-9)</dd>
  158. </dl>
  159. </section>
  160. <section class="Sh">
  161. <h1 class="Sh" id="INTERACTIVE_PROMPT"><a class="permalink" href="#INTERACTIVE_PROMPT">INTERACTIVE
  162.  PROMPT</a></h1>
  163. <p class="Pp">A minimalist interactive prompt inspired from
  164.    <a class="Xr">vi(1)</a> can be used to perform various operations described
  165.    below. It is triggered by pressing colon (:), the default key. Command-line
  166.    editing, history and completion are supported.</p>
  167. <section class="Ss">
  168. <h2 class="Ss" id="Commands"><a class="permalink" href="#Commands">Commands</a></h2>
  169. <dl class="Bl-tag">
  170.  <dt>{quit, exit, q}</dt>
  171.  <dd>Quit, or load the next <var class="Ar">romname</var> from command-line, if
  172.      any.</dd>
  173.  <dt>{load, open, plug, o} <var class="Ar">filename</var></dt>
  174.  <dd>Load a given ROM <var class="Ar">filename</var>.</dd>
  175.  <dt>{unload, close, unplug}</dt>
  176.  <dd>Unload the current ROM.</dd>
  177.  <dt>config_load <var class="Ar">filename</var></dt>
  178.  <dd>Load configuration from file <var class="Ar">filename</var>.</dd>
  179.  <dt>config_save <var class="Ar">filename</var></dt>
  180.  <dd>Save current configuration to file <var class="Ar">filename</var>.</dd>
  181.  <dt>reset</dt>
  182.  <dd>Genesis reset.</dd>
  183.  <dt>{ctv_push, ctv_pop, ctv_none}</dt>
  184.  <dd>Manage the stack of Crap TV filters (if compiled-in).</dd>
  185.  <dt>calibrate <var class="Ar">number</var></dt>
  186.  <dd>Interactive calibration of the specified gamepad (1 or 2). If
  187.      <var class="Ar">number</var> isn't specified, default to 1.</dd>
  188.   <dt>unbind <var class="Ar">binding [...]</var></dt>
  189.   <dd>Remove specified bindings (variables prefixed with &quot;bind_&quot;). See
  190.       <a class="Xr">dgenrc(5)</a> for more information about them.</dd>
  191.   <dt>vgmdump start <var class="Ar">filename</var></dt>
  192.   <dd style="width: auto;">&#x00A0;</dd>
  193.   <dt>vgmdump stop</dt>
  194.   <dd>Manages VGM dumping/logging. If the second argument is
  195.       <var class="Ar">start</var> VGM dumping will be started at the path
  196.       specified by the third argument. If the second argument is
  197.       <var class="Ar">stop</var> VGM dumping will be stopped and the dump
  198.       finalized.</dd>
  199. </dl>
  200. </section>
  201. <section class="Ss">
  202. <h2 class="Ss" id="Variables"><a class="permalink" href="#Variables">Variables</a></h2>
  203. <p class="Pp">All configuration variables from <a class="Xr">dgenrc(5)</a> can
  204.     be displayed and modified interactively, with immediate effect.</p>
  205. <dl class="Bl-tag">
  206.   <dt>{int_name, bool_name, key_name, joy_name, ...} {value}</dt>
  207.   <dd>Affect <var class="Ar">value</var> to variable
  208.     <var class="Ar">name</var>.</dd>
  209.   <dt>{int_name, bool_name, key_name, joy_name, ...}</dt>
  210.   <dd>Display current value for variable <var class="Ar">name</var>.</dd>
  211. </dl>
  212. </section>
  213. </section>
  214. <section class="Sh">
  215. <h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
  216. <dl class="Bl-tag Bl-compact">
  217.   <dt><span class="Pa">$HOME/.dgen/dgenrc</span></dt>
  218.   <dd>Contains user settings for the emulator.</dd>
  219.   <dt><span class="Pa">$HOME/.dgen/dgenrc.auto</span></dt>
  220.   <dd>Generated file containing saved user settings.</dd>
  221.   <dt><span class="Pa">$HOME/.dgen/saves/*</span></dt>
  222.   <dd>Save states generated by the emulator.</dd>
  223.   <dt><span class="Pa">$HOME/.dgen/ram/*</span></dt>
  224.   <dd>Battery-backup RAM images, generated by the emulator for ROMs with save
  225.       RAM.</dd>
  226.   <dt><span class="Pa">$HOME/.dgen/screenshots/*</span></dt>
  227.   <dd>Screenshots are generated there.</dd>
  228.   <dt><span class="Pa">$HOME/.dgen/roms/*</span></dt>
  229.   <dd>ROMs default search path.</dd>
  230.   <dt><span class="Pa">$HOME/.dgen/demos/*</span></dt>
  231.   <dd>Demos default search path.</dd>
  232. </dl>
  233. </section>
  234. <section class="Sh">
  235. <h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
  236.   ALSO</a></h1>
  237. <p class="Pp"><a class="Xr">gzip(1)</a>, <a class="Xr">bzip2(1)</a>,
  238.     <a class="Xr">zip(1)</a>, <a class="Xr">dgenrc(5)</a></p>
  239. </section>
  240. <section class="Sh">
  241. <h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
  242. <p class="Pp">This manual page was written by <span class="An">Joe Groff</span>
  243.     &#x27E8;joe@pknet.com&#x27E9;.
  244.   <br/>
  245.   <span class="An">Updated by zamaz</span>
  246.     &#x27E8;zamaz@users.sourceforge.net&#x27E9;.</p>
  247. </section>
  248. <section class="Sh">
  249. <h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
  250. <p class="Pp">There are known emulation bugs, see BUGS in DGen source
  251.   package.</p>
  252. <p class="Pp">
  253.   <br/>
  254.   <span class="An">Report bugs to</span>
  255.     &#x27E8;http://sourceforge.net/projects/dgen/&#x27E9;.</p>
  256. </section>
  257. </div>
  258. <table class="foot">
  259.   <tr>
  260.     <td class="foot-date">July 26, 2014</td>
  261.     <td class="foot-os">Linux 6.6.9-arch1-1</td>
  262.   </tr>
  263. </table>
  264. </body>
  265. </html>
  266.