trunk/src/osd/sdl/man/mess.6
| r0 | r19693 | |
|---|
| 1 | .\" -*- nroff -*- |
| 2 | .\" |
| 3 | .\" mess.6 |
| 4 | .\" |
| 5 | .\" Man page created from usage and source information: |
| 6 | .\" * commands: see src/emu/clifront.c clifront.h |
| 7 | .\" * options: core entries, see src/emu/emuopts.c emuopts.h |
| 8 | .\" SDL-specific entries, see src/osd/sdl/sdlmain.c osdsdl.h |
| 9 | .\" Cesare Falco <c.falco@ubuntu.com>, March 2011 |
| 10 | .\" |
| 11 | .\" Some text borrowed from the xmame 0.106 man page, |
| 12 | .\" done by Rene Herrmann <rene.herrmann@berlin.de>, September 2000 |
| 13 | .\" and updated by Andrew Burton <burtona@gol.com>, July 2003 |
| 14 | .\" |
| 15 | .\" Other info's taken from MESS Wiki as well: |
| 16 | .\" http://www.mess.org/ |
| 17 | .\" |
| 18 | .\" |
| 19 | .TH mess 6 2012-12-01 0.147u3 "The Multiple Emulator Super System (MESS)" |
| 20 | .\" |
| 21 | .\" |
| 22 | .\" NAME chapter |
| 23 | .SH NAME |
| 24 | MESS \- The Multiple Emulator Super System |
| 25 | .\" |
| 26 | .\" |
| 27 | .\" SYNOPSIS chapter |
| 28 | .SH SYNOPSIS |
| 29 | .B mess |
| 30 | .RI [ options ] |
| 31 | .I system |
| 32 | .\" |
| 33 | .\" |
| 34 | .\" DESCRIPTION chapter |
| 35 | .SH DESCRIPTION |
| 36 | MESS documents the hardware for a wide variety of (mostly vintage) computers, |
| 37 | video game consoles, and calculators through software emulation. As a nice |
| 38 | side effect, MESS allows software and games for these hardware platforms |
| 39 | to run on modern PCs. |
| 40 | .\" |
| 41 | .\" |
| 42 | .\" OPTIONS chapter |
| 43 | .SH OPTIONS |
| 44 | .\" |
| 45 | .\" ******************************************************* |
| 46 | .SS Core commands |
| 47 | .\" ******************************************************* |
| 48 | .TP |
| 49 | .B \-help, \-? |
| 50 | Displays current MESS version and copyright notice. |
| 51 | .TP |
| 52 | .B \-validate, \-valid |
| 53 | Performs internal validation on every driver in MESS. Run this |
| 54 | before submitting changes to ensure that you haven't violated any of |
| 55 | the core system rules. |
| 56 | .\" |
| 57 | .\" ******************************************************* |
| 58 | .SS Configuration commands |
| 59 | .\" ******************************************************* |
| 60 | .TP |
| 61 | .B \-createconfig, \-cc |
| 62 | Creates the default \fBmess.ini\fR file in the current directory. All the |
| 63 | configuration options (not commands) described below can be permanently |
| 64 | changed by editing this configuration file. |
| 65 | .TP |
| 66 | .B \-showconfig, \-sc |
| 67 | Displays the current configuration settings. |
| 68 | .TP |
| 69 | .B \-showusage, \-su |
| 70 | Displays a summary of all the command line options. For options that |
| 71 | are not mentioned here, the short summary given by \fB\-showusage\fR |
| 72 | is usually sufficient. |
| 73 | .\" |
| 74 | .\" ******************************************************* |
| 75 | .SS Frontend commands |
| 76 | .\" ******************************************************* |
| 77 | All the list commands below write info to the screen. |
| 78 | If you wish to write the info to a textfile instead, use redirection. |
| 79 | For example, |
| 80 | .B mess \-listxml > ~/messlist.xml |
| 81 | writes the full list of supported systems to \fBmesslist.xml\fR in your |
| 82 | home directory. |
| 83 | .TP |
| 84 | .B \-listxml, \-lx \fR[\fIsystem\fR|\fIwildcard\fR] |
| 85 | List comprehensive details for all of the supported systems. The output |
| 86 | is quite long, so it is usually better to redirect this into a file. |
| 87 | The output is in XML format. By default all systems are listed; however, |
| 88 | you can limit this list by specifying a driver name or wildcard. |
| 89 | .TP |
| 90 | .B \-listfull, \-ll \fR[\fIsystem\fR|\fIwildcard\fR] |
| 91 | Displays a list of system driver names and descriptions. By default all |
| 92 | systems are listed; however, you can limit this list by specifying a |
| 93 | driver name or wildcard. |
| 94 | .TP |
| 95 | .B \-listsource, \-ls \fR[\fIsystem\fR|\fIwildcard\fR] |
| 96 | Displays a list of drivers and the names of the source files their system |
| 97 | drivers live in. Useful for finding which driver a system runs on in |
| 98 | order to fix bugs. By default all systems are listed; however, you can |
| 99 | limit this list by specifying a driver name or wildcard. |
| 100 | .TP |
| 101 | .B \-listclones, \-lc \fR[\fIsystem\fR|\fIwildcard\fR] |
| 102 | Displays a list of clones. By default all clones are listed; however, |
| 103 | you can limit this list by specifying a driver name or wildcard. |
| 104 | .TP |
| 105 | .B \-listbrothers, \-lb \fR[\fIsystem\fR|\fIwildcard\fR] |
| 106 | Displays a list of "brothers" or other drivers from same sourcefile. |
| 107 | By default all systems are listed; however, you can limit this list by |
| 108 | specifying a driver name or wildcard. |
| 109 | .TP |
| 110 | .B \-listcrc |
| 111 | Displays a full list of CRCs of all ROM images referenced by all |
| 112 | drivers within MESS code. |
| 113 | .TP |
| 114 | .B \-listroms \fIsystem |
| 115 | Displays a list of ROM images referenced by the specified system. |
| 116 | .TP |
| 117 | .B \-listsamples \fIsystem |
| 118 | Displays a list of samples referenced by the specified system. |
| 119 | .TP |
| 120 | .B \-verifyroms \fR[\fIsystem\fR|\fIwildcard\fR] |
| 121 | Checks for invalid or missing ROM images. By default all drivers that |
| 122 | have valid ZIP files or directories in the rom path are verified; |
| 123 | however, you can limit this list by specifying a driver name or |
| 124 | wildcard. |
| 125 | .TP |
| 126 | .B \-verifysamples \fR[\fIsystem\fR|\fIwildcard\fR] |
| 127 | Checks for invalid or missing samples. By default all drivers that |
| 128 | have valid ZIP files or directories in the samplepath are verified; |
| 129 | however, you can limit this list by specifying a driver name or wildcard. |
| 130 | .TP |
| 131 | .B \-romident |
| 132 | Attempts to identify ROM files, if they are known to MESS, in the |
| 133 | specified .zip file or directory. This command can be used to try and |
| 134 | identify ROM sets taken from unknown boards. On exit, the errorlevel |
| 135 | is returned as one of the following: |
| 136 | .br |
| 137 | \fB0\fR all files were identified |
| 138 | .br |
| 139 | \fB7\fR all files were identified except for some "non\-ROM" files |
| 140 | .br |
| 141 | \fB8\fR some files were identified |
| 142 | .br |
| 143 | \fB9\fR no files were identified |
| 144 | .TP |
| 145 | .B \-listdevices, \-ld |
| 146 | Output the list of devices referenced by a given system or set of systems. |
| 147 | .TP |
| 148 | .B \-listslots, \-lslot |
| 149 | Output the list of available slots and slot devices for the system. |
| 150 | .TP |
| 151 | .B \-listmedia, \-lm |
| 152 | Output the list of available media for the system. |
| 153 | .TP |
| 154 | .B \-listsoftware, \-lsoft |
| 155 | Output the list of known software for the system. |
| 156 | .TP |
| 157 | .B \-verifysoftware, \-vsoft |
| 158 | Verify known software for the system. |
| 159 | .TP |
| 160 | .B \-getsoftlist, \-glist |
| 161 | Retrieve software list by name. |
| 162 | .TP |
| 163 | .B \-verifysoftlist, \-vlist |
| 164 | Verify software list by name. |
| 165 | .\" |
| 166 | .\" ******************************************************* |
| 167 | .SS Configuration options |
| 168 | .\" ******************************************************* |
| 169 | .TP |
| 170 | .B \-[no]readconfig, \-[no]rc |
| 171 | Enables or disables the reading of the config files. When enabled |
| 172 | (which is the default), MESS reads the following config files in order: |
| 173 | .br |
| 174 | 1. \fBmess.ini\fR |
| 175 | .br |
| 176 | the main configuration file |
| 177 | .br |
| 178 | 2. \fI[driver]\fB.ini\fR |
| 179 | .br |
| 180 | based on the source file name of the system driver |
| 181 | .br |
| 182 | 3. \fI[parent]\fB.ini\fR |
| 183 | .br |
| 184 | for clones only, may be called recursively |
| 185 | .br |
| 186 | 4. \fI[system]\fB.ini\fR |
| 187 | .br |
| 188 | note this sometimes resolves to the same of the source driver |
| 189 | .P |
| 190 | The settings in the later ini's override those in the earlier ini's. |
| 191 | The default is ON (\-readconfig). |
| 192 | .TP |
| 193 | .B \-writeconfig, \-wc |
| 194 | Write configuration to \fI[driver]\fR.ini on exit. |
| 195 | .\" |
| 196 | .\" ******************************************************* |
| 197 | .SS Search path options |
| 198 | .\" ******************************************************* |
| 199 | Be careful to use the path, directory and file options in |
| 200 | mess.ini ONLY. Otherwise, the outcome may be unpredictable and not |
| 201 | consistent across releases. |
| 202 | .TP |
| 203 | .B \-rompath, \-rp, \-biospath, \-bp \fIpathname |
| 204 | Specifies a list of paths within which to find ROM or hard disk images. |
| 205 | Multiple paths can be specified by separating them with semicolons. |
| 206 | The default is 'roms' (that is, a directory 'roms' in the same directory |
| 207 | as the MESS executable). |
| 208 | .TP |
| 209 | .B \-samplepath, \-sp \fIpathname |
| 210 | Specifies a list of paths within which to find sample files. Multiple |
| 211 | paths can be specified by separating them with semicolons. The default |
| 212 | is 'samples' (that is, a directory 'samples' in the same directory as |
| 213 | the MESS executable). |
| 214 | .TP |
| 215 | .B \-artpath, \-artwork_directory \fIpathname |
| 216 | Specifies a list of paths within which to find artwork files. Multiple |
| 217 | paths can be specified by separating them with semicolons. The default |
| 218 | is 'artwork' (that is, a directory 'artwork' in the same directory as |
| 219 | the MESS executable). |
| 220 | .TP |
| 221 | .B \-ctrlrpath, \-ctrlr_directory \fIpathname |
| 222 | Specifies a list of paths within which to find controller\-specific |
| 223 | configuration files. Multiple paths can be specified by separating |
| 224 | them with semicolons. The default is 'ctrlr' (that is, a |
| 225 | directory 'ctrlr' in the same directory as the MESS executable). |
| 226 | .TP |
| 227 | .B \-inipath \fIpathname |
| 228 | Specifies a list of paths within which to find .ini files. Multiple |
| 229 | paths can be specified by separating them with semicolons. The default |
| 230 | is '/etc/mess'. |
| 231 | .TP |
| 232 | .B \-fontpath \fIpathname |
| 233 | Specifies a list of paths within which to find .bdf font files. Multiple |
| 234 | paths can be specified by separating them with semicolons. The default |
| 235 | is '.' (that is, search in the same directory as the MESS executable). |
| 236 | .TP |
| 237 | .B \-cheatpath \fIpathname |
| 238 | Specifies a list of paths within which to find cheat files. Multiple |
| 239 | paths can be specified by separating them with semicolons. The default |
| 240 | is 'cheat' (that is, a directory 'cheat' in the same directory as |
| 241 | the MESS executable). |
| 242 | .TP |
| 243 | .B \-crosshairpath \fIpathname |
| 244 | Specifies a list of paths within which to find crosshair files. Multiple |
| 245 | paths can be specified by separating them with semicolons. The default |
| 246 | is 'crosshair' (that is, a directory 'crosshair' in the same directory as |
| 247 | the MESS executable). If the Crosshair is set to default in the menu, |
| 248 | MESS will look for system/cross#.png and then cross#.png in the |
| 249 | specified path, where # is the player number. Failing that, |
| 250 | MESS will use built\-in default crosshairs. |
| 251 | .TP |
| 252 | .B \-hashpath \fIpathname |
| 253 | Specifies a list of paths within which to search for software hash files. |
| 254 | Multiple paths can be specified by separating them with semicolons. |
| 255 | The default is 'hash' (that is, a directory 'hash' in the same directory |
| 256 | as the MESS executable). |
| 257 | .\" |
| 258 | .\" ******************************************************* |
| 259 | .SS Output Directory Options |
| 260 | .\" ******************************************************* |
| 261 | .TP |
| 262 | .B \-cfg_directory \fIpathname |
| 263 | Specifies a single directory where configuration files are stored. |
| 264 | Configuration files store user configurable settings that are read at |
| 265 | startup and written when MESS exits. The default is 'cfg' (that is, |
| 266 | a directory 'cfg' in the same directory as the MESS executable). If this |
| 267 | directory does not exist, it will be automatically created. |
| 268 | .TP |
| 269 | .B \-nvram_directory \fIpathname |
| 270 | Specifies a single directory where NVRAM files are stored. NVRAM files |
| 271 | store the contents of EEPROM and non\-volatile RAM (NVRAM) for systems |
| 272 | which used this type of hardware. This data is read at startup and |
| 273 | written when MESS exits. The default is 'nvram' (that is, a |
| 274 | directory 'nvram' in the same directory as the MESS executable). If this |
| 275 | directory does not exist, it will be automatically created. |
| 276 | .TP |
| 277 | .B \-memcard_directory \fIpathname |
| 278 | Specifies a single directory where memory card files are stored. Memory |
| 279 | card files store the contents of removable memory cards for systems which |
| 280 | used this type of hardware. This data is read and written under control |
| 281 | of the user via the 'Memory Card' menu in the user interface. The |
| 282 | default is 'memcard' (that is, a directory 'memcard' in the same |
| 283 | directory as the MESS executable). If this directory does not exist, |
| 284 | it will be automatically created. |
| 285 | .TP |
| 286 | .B \-input_directory \fIpathname |
| 287 | Specifies a single directory where input recording files are stored. |
| 288 | Input recordings are created via the \-record option and played back via |
| 289 | the \-playback option. The default is 'inp' (that is, a directory 'inp' |
| 290 | in the same directory as the MESS executable). If this directory |
| 291 | does not exist, it will be automatically created. |
| 292 | .TP |
| 293 | .B \-state_directory \fIpathname |
| 294 | Specifies a single directory where save state files are stored. Save |
| 295 | state files are read and written either upon user request, or when using |
| 296 | the \-autosave option. The default is 'sta' (that is, a directory 'sta' |
| 297 | in the same directory as the MESS executable). If this directory does |
| 298 | not exist, it will be automatically created. |
| 299 | .TP |
| 300 | .B \-snapshot_directory \fIpathname |
| 301 | Specifies a single directory where screen snapshots are stored, when |
| 302 | requested by the user. The default is 'snap' (that is, a directory 'snap' |
| 303 | in the same directory as the MESS executable). If this directory |
| 304 | does not exist, it will be automatically created. |
| 305 | .TP |
| 306 | .B \-diff_directory \fIpathname |
| 307 | Specifies a single directory where hard drive differencing files are |
| 308 | stored. Hard drive differencing files store any data that is written |
| 309 | back to a hard disk image, in order to preserve the original image. The |
| 310 | differencing files are created at startup when a system with a hard disk |
| 311 | image. The default is 'diff' (that is, a directory 'diff' in the same |
| 312 | directory as the MESS executable). If this directory does not exist, |
| 313 | it will be automatically created. |
| 314 | .TP |
| 315 | .B \-comment_directory \fIpathname |
| 316 | Specifies a single directory where debugger comment files are stored. |
| 317 | Debugger comment files are written by the debugger when comments are |
| 318 | added to the disassembly for a system. The default is 'comments' (that is, |
| 319 | a directory 'comments' in the same directory as the MESS executable). |
| 320 | If this directory does not exist, it will be automatically created. |
| 321 | .\" |
| 322 | .\" ******************************************************* |
| 323 | .SS State/playback options |
| 324 | .\" ******************************************************* |
| 325 | .TP |
| 326 | .B \-state \fIslot |
| 327 | Immediately after starting the specified system, will cause the save |
| 328 | state in the specified slot to be loaded. |
| 329 | .TP |
| 330 | .B \-[no]autosave |
| 331 | When enabled, automatically creates a save state file when exiting MESS |
| 332 | and automatically attempts to reload it when later starting MESS with |
| 333 | the same system. This only works for systems that have explicitly enabled |
| 334 | save state support in their driver. The default is OFF (\-noautosave). |
| 335 | .TP |
| 336 | .B \-playback, \-pb \fIfilename |
| 337 | Specifies a file from which to play back a series of system inputs. This |
| 338 | feature does not work reliably for all systems, but can be used to watch |
| 339 | a previously recorded system session from start to finish. In order to |
| 340 | make things consistent, you should only record and playback with all |
| 341 | configuration (.cfg), NVRAM (.nv), and memory card files deleted. The |
| 342 | default is NULL (no playback). |
| 343 | .TP |
| 344 | .B \-record, \-rec \fIfilename |
| 345 | Specifies a file to record all input from a system session. This can be |
| 346 | used to record a system session for later playback. This feature does not |
| 347 | work reliably for all systems, but can be used to watch a previously |
| 348 | recorded system session from start to finish. In order to make things |
| 349 | consistent, you should only record and playback with all configuration |
| 350 | (.cfg), NVRAM (.nv), and memory card files deleted. The default is NULL |
| 351 | (no recording). |
| 352 | .TP |
| 353 | .B \-snapname \fIname |
| 354 | Describes how MESS should name files for snapshots. \fIname\fP is a string |
| 355 | that provides a template that is used to generate a filename. Three |
| 356 | simple substitutions are provided: the / character represents the |
| 357 | path separator on any target platform (even Windows); the string \fI%g\fP |
| 358 | represents the driver name of the current system; and the string \fI%i\fP |
| 359 | represents an incrementing index. If \fI%i\fP is omitted, then each |
| 360 | snapshot taken will overwrite the previous one; otherwise, MESS will |
| 361 | find the next empty value for \fI%i\fP and use that for a filename. The |
| 362 | default is \fI%g/%i\fP, which creates a separate folder for each game, |
| 363 | and names the snapshots under it starting with 0000 and increasing |
| 364 | from there. |
| 365 | .TP |
| 366 | .B \-snapsize \fIwidth\fRx\fIheight |
| 367 | Hard\-codes the size for snapshots and movie recording. By default, |
| 368 | MESS will create snapshots at the system's current resolution in raw |
| 369 | pixels, and will create movies at the system's starting resolution in |
| 370 | raw pixels. If you specify this option, then MESS will create both |
| 371 | snapshots and movies at the size specified, and will bilinear filter |
| 372 | the result. Note that this size does not automatically rotate if the |
| 373 | system is vertically oriented. The default is 'auto'. |
| 374 | .TP |
| 375 | .B \-snapview internal\fR|\fBauto\fR|\fIviewname |
| 376 | Specifies the view to use when rendering snapshots and movies. By |
| 377 | default, both use a special 'internal' view, which renders a separate |
| 378 | snapshot per screen or renders movies only of the first screen. By |
| 379 | specifying this option, you can override this default behavior and |
| 380 | select a single view that will apply to all snapshots and movies. |
| 381 | Note that \fIviewname\fP does not need to be a perfect match; rather, it |
| 382 | will select the first view whose name matches all the characters |
| 383 | specified by \fIviewname\fP. For example, \-snapview native will match the |
| 384 | "Native (15:14)" view even though it is not a perfect match. |
| 385 | \fIviewname\fP can also be 'auto', which selects the first view with all |
| 386 | screens present. The default value is 'internal'. |
| 387 | .TP |
| 388 | .B \-mngwrite \fIfilename |
| 389 | Writes each video frame to the given file in MNG format, producing |
| 390 | an animation of the system session. |
| 391 | Note that \-mngwrite only writes video frames; it does not save any audio |
| 392 | data. Use \-wavwrite for that, and reassemble the audio/video using |
| 393 | offline tools. The default is NULL (no recording). |
| 394 | .TP |
| 395 | .B \-aviwrite \fIfilename |
| 396 | Stream video and sound data to the given file |
| 397 | in AVI format, producing an animation of the system session complete |
| 398 | with sound. The default is NULL (no recording). |
| 399 | .TP |
| 400 | .B \-wavwrite \fIfilename |
| 401 | Writes the final mixer output to the given file |
| 402 | in WAV format, producing an audio recording of the system session. |
| 403 | The default is NULL (no recording). |
| 404 | .TP |
| 405 | .B \-[no]burnin |
| 406 | Tracks brightness of the screen during play and at the end of |
| 407 | emulation generates a PNG that can be used to simulate burn\-in |
| 408 | effects on other systems. The resulting PNG is created such that the |
| 409 | least\-used areas of the screen are fully white (since burned\-in areas |
| 410 | are darker, all other areas of the screen must be lightened a touch). |
| 411 | The intention is that this PNG can be loaded via an artwork file with |
| 412 | a low alpha (e.g, 0.1\-0.2 seems to work well) and blended over the |
| 413 | entire screen. The PNG files are saved in the snap directory under |
| 414 | the system/burnin\-<screen.name>.png. The default is OFF (\-noburnin). |
| 415 | .\" |
| 416 | .\" ******************************************************* |
| 417 | .SS Performance options |
| 418 | .\" ******************************************************* |
| 419 | .TP |
| 420 | .B \-[no]autoframeskip, \-[no]afs |
| 421 | Automatically determines the frameskip level while you're playing the |
| 422 | system, adjusting it constantly in a frantic attempt to keep the system |
| 423 | running at full speed. Turning this on overrides the value you have set |
| 424 | for \-frameskip below. The default is OFF (\-noautoframeskip). |
| 425 | .TP |
| 426 | .B \-frameskip, \-fs \fIvalue |
| 427 | Specifies the frameskip value (autoframeskip must be disabled). This is the |
| 428 | number of frames out of every 12 to drop when running. For example, if you |
| 429 | say \-frameskip 2, then MESS will display 10 out of every 12 frames. By |
| 430 | skipping those frames, you may be able to get full speed in a system that |
| 431 | requires more horsepower than your computer has. The default value is 0, |
| 432 | which skips no frames. |
| 433 | .TP |
| 434 | .B \-seconds_to_run, \-str \fIvalue |
| 435 | This option can be used for benchmarking and automated testing. It tells |
| 436 | MESS to stop execution after a fixed number of seconds. By combining |
| 437 | this with a fixed set of other command line options, you can set up a |
| 438 | consistent environment for benchmarking MESS performance. In addition, |
| 439 | upon exit, the \-str option will write a screenshot called final.png |
| 440 | to the system's snapshot directory. |
| 441 | .TP |
| 442 | .B \-[no]throttle |
| 443 | Configures the default thottling setting. When throttling is on, MESS |
| 444 | attempts to keep the system running at the system's intended speed. When |
| 445 | throttling is off, MESS runs the system as fast as it can. Note that the |
| 446 | fastest speed is more often than not limited by your graphics card, |
| 447 | especially for older systems. The default is ON (\-throttle). |
| 448 | .TP |
| 449 | .B \-[no]sleep |
| 450 | Allows MESS to give time back to the system when running with \-throttle. |
| 451 | This allows other programs to have some CPU time, assuming that the |
| 452 | system isn't taxing 100% of your CPU resources. This option can potentially |
| 453 | cause hiccups in performance if other demanding programs are running. |
| 454 | The default is ON (\-sleep). |
| 455 | .TP |
| 456 | .B \-speed |
| 457 | Controls the speed of gameplay, relative to realtime; smaller numbers are |
| 458 | slower. Default is 1.00. |
| 459 | .TP |
| 460 | .B \-refreshspeed, \-rs |
| 461 | Automatically adjusts the \-speed parameter to keep the effective refresh |
| 462 | rate below that of the lowest screen refresh rate. |
| 463 | .\" |
| 464 | .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 465 | .\" SDL specific |
| 466 | .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 467 | .TP |
| 468 | .B \-multithreading, \-mt |
| 469 | Enable multithreading; this enables rendering and blitting on a separate |
| 470 | thread. The default is OFF. |
| 471 | .TP |
| 472 | .B \-numprocessors, \-np |
| 473 | Set number of processors; this overrides the number the system reports. |
| 474 | .TP |
| 475 | .B \-sdlvideofps |
| 476 | Show SDL video performance. |
| 477 | .\" |
| 478 | .\" ******************************************************* |
| 479 | .SS Rotation options |
| 480 | .\" ******************************************************* |
| 481 | .TP |
| 482 | .B \-[no]rotate |
| 483 | Rotate the system to match its normal state (horizontal/vertical). This |
| 484 | ensures that both vertically and horizontally oriented systems show up |
| 485 | correctly without the need to rotate your monitor. If you want to keep |
| 486 | the system displaying 'raw' on the screen the way the actual machine would |
| 487 | have, turn this option off. The default is ON (\-rotate). |
| 488 | .TP |
| 489 | .B \-[no]ror \-[no]rol |
| 490 | Rotate the system screen to the right (clockwise) or left |
| 491 | (counter\-clockwise) relative to either its normal state (if \-rotate |
| 492 | is specified) or its native state (if \-norotate is specified). The |
| 493 | default for both of these options is OFF (\-noror \-norol). |
| 494 | .TP |
| 495 | .B \-[no]autoror \-[no]autorol |
| 496 | These options are designed for use with pivoting screens that only |
| 497 | pivot in a single direction. If your screen only pivots clockwise, |
| 498 | use \-autorol to ensure that the system will fill the screen either |
| 499 | horizontally or vertically in one of the directions you can handle. |
| 500 | If your screen only pivots counter\-clockwise, use \-autoror. |
| 501 | .TP |
| 502 | .B \-[no]flipx \-[no]flipy |
| 503 | Flip (mirror) the system screen either horizontally (\-flipx) or |
| 504 | vertically (\-flipy). The flips are applied after the \-rotate and |
| 505 | \-ror/\-rol options are applied. The default for both of these options |
| 506 | is OFF (\-noflipx \-noflipy). |
| 507 | .\" |
| 508 | .\" ******************************************************* |
| 509 | .SS Artwork options |
| 510 | .\" ******************************************************* |
| 511 | .TP |
| 512 | .B \-[no]artwork_crop, \-[no]artcrop |
| 513 | Enable cropping of artwork to the system screen area only. This |
| 514 | option can also be controlled via the Video Options menu in the user |
| 515 | interface. The default is OFF (\-noartwork_crop). |
| 516 | .TP |
| 517 | .B \-[no]use_backdrops, \-[no]backdrop |
| 518 | Enables/disables the display of backdrops. The default is ON |
| 519 | (\-use_backdrops). |
| 520 | .TP |
| 521 | .B \-[no]use_overlays, \-[no]overlay |
| 522 | Enables/disables the display of overlays. The default is ON |
| 523 | (\-use_overlays). |
| 524 | .TP |
| 525 | .B \-[no]use_bezels, \-[no]bezel |
| 526 | Enables/disables the display of bezels. The default is ON |
| 527 | (\-use_bezels). |
| 528 | .TP |
| 529 | .B \-[no]use_cpanels, \-[no]cpanel |
| 530 | Enables/disables the display of cpanels. The default is ON |
| 531 | (\-use_bezels). |
| 532 | .TP |
| 533 | .B \-[no]use_marquees, \-[no]marquee |
| 534 | Enables/disables the display of marquees. The default is ON |
| 535 | (\-use_bezels). |
| 536 | .\" |
| 537 | .\" ******************************************************* |
| 538 | .SS Screen options |
| 539 | .\" ******************************************************* |
| 540 | .TP |
| 541 | .B \-brightness \fIvalue |
| 542 | Controls the default brightness, or black level, of the system screens. |
| 543 | This option does not affect the artwork or other parts of the display. |
| 544 | Using the MESS UI, you can individually set the brightness for each system |
| 545 | screen; this option controls the initial value for all visible system |
| 546 | screens. The standard value is 1.0. Selecting lower values (down to 0.1) |
| 547 | will produce a darkened display, while selecting higher values (up to |
| 548 | 2.0) will give a brighter display. The default is 1.0. |
| 549 | .TP |
| 550 | .B \-contrast \fIvalue |
| 551 | Controls the contrast, or white level, of the system screens. This option |
| 552 | does not affect the artwork or other parts of the display. Using the |
| 553 | MESS UI, you can individually set the contrast for each system screen; |
| 554 | this option controls the initial value for all visible system screens. The |
| 555 | standard value is 1.0. Selecting lower values (down to 0.1) will produce |
| 556 | a dimmer display, while selecting higher values (up to 2.0) will |
| 557 | give a more saturated display. The default is 1.0. |
| 558 | .TP |
| 559 | .B \-gamma \fIvalue |
| 560 | Controls the gamma, which produces a potentially nonlinear black to |
| 561 | white ramp, for the system screens. This option does not affect the |
| 562 | artwork or other parts of the display. Using the MESS UI, you can |
| 563 | individually set the gamma for each system screen; this option controls |
| 564 | the initial value for all visible system screens. The standard value is |
| 565 | 1.0, which gives a linear ramp from black to white. Selecting lower |
| 566 | values (down to 0.1) will increase the nonlinearity toward black, |
| 567 | while selecting higher values (up to 3.0) will push the nonlinearity |
| 568 | toward white. The default is 1.0. |
| 569 | .TP |
| 570 | .B \-pause_brightness \fIvalue |
| 571 | This controls the brightness level when MESS is paused. The default |
| 572 | value is 0.65. |
| 573 | .\" |
| 574 | .\" ******************************************************* |
| 575 | .SS Vector rendering options |
| 576 | .\" ******************************************************* |
| 577 | .TP |
| 578 | .B \-[no]antialias, \-[no]aa |
| 579 | Enables antialiased line rendering for vector systems. The default is ON |
| 580 | (\-antialias). |
| 581 | .TP |
| 582 | .B \-beam \fIwidth |
| 583 | Sets the width of the vectors. This is a scaling factor against the |
| 584 | standard vector width. A value of 1.0 will keep the default vector line |
| 585 | width. Smaller values will reduce the width, and larger values will |
| 586 | increase the width. The default is 1.0. |
| 587 | .TP |
| 588 | .B \-flicker \fIvalue |
| 589 | Simulates a vector "flicker" effect, similar to a vector monitor that |
| 590 | needs adjustment. This option requires a float argument in the range of |
| 591 | 0.00\-100.00 (0=none, 100=maximum). The default is 0. |
| 592 | .\" |
| 593 | .\" ******************************************************* |
| 594 | .SS Video options |
| 595 | .\" ******************************************************* |
| 596 | .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 597 | .\" SDL specific |
| 598 | .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 599 | .TP |
| 600 | .B \-video\fR [\fIsoft\fR|\fIopengl\fR|\fIopengl16\fR|\fInone\fR] |
| 601 | Specifies which video subsystem to use for drawing: |
| 602 | .br |
| 603 | \fBsoft\fR uses software rendering, which is slower but more compatible. |
| 604 | .br |
| 605 | \fBopengl\fR uses OpenGL and your graphics accelerator to speed up many |
| 606 | aspects of drawing MESS including compositing artwork, overlays, and |
| 607 | bezels, as well as stretching the image to fit your screen. |
| 608 | .br |
| 609 | \fBopengl16\fR uses alternate OpenGL code, which should provide faster |
| 610 | output on some cards. |
| 611 | .br |
| 612 | \fBnone\fR does no drawing and is intended for CPU benchmarking. |
| 613 | .br |
| 614 | Default is SOFT. |
| 615 | .TP |
| 616 | .B \-[no]window, \-[no]w |
| 617 | Run MESS in either full screen or a window. This is a fully\-featured window |
| 618 | mode where the window resizes as necessary to track what the system does. |
| 619 | And you can resize it yourself with your OS's standard window controls. |
| 620 | The default is OFF (\-nowindow). |
| 621 | .TP |
| 622 | .B \-[no]maximize, \-[no]max |
| 623 | Controls initial window size in windowed mode. If it is set on, the |
| 624 | window will initially be set to the maximum supported size when you |
| 625 | start MESS. If it is turned off, the window will start out at the |
| 626 | smallest supported size. This option only has an effect when the |
| 627 | \-window option is used. The default is ON (\-maximize). |
| 628 | .TP |
| 629 | .B \-keepaspect, \-ka |
| 630 | Forces the correct aspect ratio. This means when you're resizing the window |
| 631 | in windowed mode the actual system image will resize in discrete steps to |
| 632 | maintain the proper shape of the system graphics. If you turn this off you can |
| 633 | resize the window to anything you like and get funny squishing and stretching. |
| 634 | The same applies for full\-screen. Default is ON (\-keepaspect). |
| 635 | .TP |
| 636 | .B \-unevenstretch, \-ues |
| 637 | Allow non\-integer stretch factors. Video purists should stay far, far away |
| 638 | from this option, while everyone else will be happy to know that it lets you |
| 639 | fill the screen properly in full\-screen mode. Default is ON (\-unevenstretch). |
| 640 | .TP |
| 641 | .B \-effect none\fR|\fIfilename |
| 642 | Name of a PNG file to use for visual effects, or 'none'. Default is 'none'. |
| 643 | .TP |
| 644 | .B \-centerh |
| 645 | Center horizontally within the view area. Default is ON (\-centerh). |
| 646 | .TP |
| 647 | .B \-centerv |
| 648 | Center vertically within the view area. Default is ON (\-centerv). |
| 649 | .TP |
| 650 | .B \-waitvsync |
| 651 | Enable waiting for the start of VBLANK before flipping screens; |
| 652 | reduces tearing effects. |
| 653 | .\" |
| 654 | .\" ******************************************************* |
| 655 | .SS Software video rendering subsystem options |
| 656 | .\" ******************************************************* |
| 657 | .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 658 | .\" SDL specific |
| 659 | .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 660 | All the options in this group are available only with softare video |
| 661 | rendering subsystem (\-video soft). |
| 662 | .TP |
| 663 | .B \-prescale \fIvalue |
| 664 | Scale screen rendering by this amount in software. Default is 1. |
| 665 | .TP |
| 666 | .B \-scalemode, \-sm \fR[\fInone\fR|\fIasync\fR|\fIyv12\fR|\fIyuy2\fR|\fIyv12x2\fR|\fIyuy2x2\fR] |
| 667 | Hardware scaling mode. |
| 668 | .br |
| 669 | \fBnone\fR use software rendering. |
| 670 | .br |
| 671 | \fBasync\fR async overlay. |
| 672 | .br |
| 673 | \fByv12\fR yv12 overlay. |
| 674 | .br |
| 675 | \fByuy2\fR yuy2 overlay. |
| 676 | .br |
| 677 | \fByv12x2\fR yv12 overlay using x2 prescaling. |
| 678 | .br |
| 679 | \fByuy2x2\fR yuy2 overlay using x2 prescaling. |
| 680 | .br |
| 681 | Default is NONE. |
| 682 | .\" |
| 683 | .\" ******************************************************* |
| 684 | .SS OpenGL video rendering subsystem options |
| 685 | .\" ******************************************************* |
| 686 | .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 687 | .\" SDL specific |
| 688 | .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 689 | All the options in this group are available only with OpenGL video |
| 690 | rendering subsystem (\-video opengl or \-video opengl16). |
| 691 | .TP |
| 692 | .B \-filter, \-glfilter, \-flt |
| 693 | Enable bilinear filtering on screen output. Default is ON (\-filter). |
| 694 | .TP |
| 695 | .B \-gl_forcepow2texture |
| 696 | Force power of two textures. Default is NO. |
| 697 | .TP |
| 698 | .B \-gl_notexturerect |
| 699 | Don't use OpenGL GL_ARB_texture_rectangle. Default is ON: turn off |
| 700 | (set this to 0) if corruption occurs in OpenGL mode, at cost of some |
| 701 | performance loss. |
| 702 | .TP |
| 703 | .B \-gl_vbo |
| 704 | Enable OpenGL VBO, if available, for a performance increase. |
| 705 | Default is ON: turn off (set this to 0) if corruption occurs. |
| 706 | .TP |
| 707 | .B \-gl_pbo |
| 708 | Enable OpenGL PBO, if available, for a performance increase. |
| 709 | Default is ON: turn off (set this to 0) if corruption occurs. |
| 710 | .TP |
| 711 | .B \-gl_glsl |
| 712 | Enable OpenGL GLSL, if available, for a performance increase. |
| 713 | .TP |
| 714 | .B \-gl_glsl_filter \fIvalue |
| 715 | Enable OpenGL GLSL filtering instead of FF filtering 0=plain, 1=bilinear. |
| 716 | Default is 1: bilinear. |
| 717 | .TP |
| 718 | .BR \-glsl_shader_mame[0\-9] |
| 719 | Preferred custom OpenGL GLSL shader set mame bitmap (from 0 to 9). |
| 720 | .TP |
| 721 | .BR \-glsl_shader_screen[0\-9] |
| 722 | Preferred custom OpenGL GLSL shader screen bitmap (from 0 to 9). |
| 723 | .TP |
| 724 | .B \-gl_glsl_vid_attr |
| 725 | Enable OpenGL GLSL handling of brightness and contrast. Better RGB system |
| 726 | performance for free. Default is ON. |
| 727 | .TP |
| 728 | .B \-screen |
| 729 | Explicit name for all screens; 'auto' here will try to make a best guess. |
| 730 | .TP |
| 731 | .B \-aspect, \-screen_aspect |
| 732 | Aspect ratio for all screens; 'auto' here will try to make a best guess. |
| 733 | .TP |
| 734 | .B \-resolution, \-r |
| 735 | Preferred resolution for all screens; |
| 736 | format is \fIwidth\fRx\fIheight\fR[@\fIrefreshrate\fR] or 'auto'. |
| 737 | .TP |
| 738 | .B \-view |
| 739 | Preferred view for all screens |
| 740 | .TP |
| 741 | .B \-screen[0\-3] |
| 742 | Explicit name of the first|second|third|fourth screen; 'auto' here will try |
| 743 | to make a best guess. |
| 744 | .TP |
| 745 | .B \-aspect[0\-3] |
| 746 | Aspect ratio of the first|second|third|fourth screen; 'auto' here will try |
| 747 | to make a best guess. |
| 748 | .TP |
| 749 | .B \-resolution[0\-3], \-r[0\-3] |
| 750 | Preferred resolution for the first|second|third|fourth screen; |
| 751 | format is \fIwidth\fRx\fIheight\fR[@\fIrefreshrate\fR] or 'auto'. |
| 752 | .TP |
| 753 | .B \-view[0\-3] |
| 754 | Preferred view for the first|second|third|fourth screen. |
| 755 | .\" |
| 756 | .\" ******************************************************* |
| 757 | .SS Full screen options |
| 758 | .\" ******************************************************* |
| 759 | .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 760 | .\" SDL specific |
| 761 | .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 762 | .TP |
| 763 | .B \-[no]switchres |
| 764 | Affects full screen mode only. Chooses if MESS can try to change the |
| 765 | screen resolution (color depth is normally left alone) when in |
| 766 | full\-screen mode. If it's off, you always get your desktop resolution |
| 767 | in full\-screen mode (which can be useful for LCDs). |
| 768 | .TP |
| 769 | .B \-useallheads |
| 770 | Split full screen image across monitors. |
| 771 | .\" |
| 772 | .\" ******************************************************* |
| 773 | .SS Sound options |
| 774 | .\" ******************************************************* |
| 775 | .TP |
| 776 | .B \-[no]sound |
| 777 | Enable or disable sound altogether. The default is ON (\-sound). |
| 778 | .TP |
| 779 | .B \-samplerate, \-sr \fIvalue |
| 780 | Sets the audio sample rate. Smaller values (e.g. 11025) cause lower |
| 781 | audio quality but faster emulation speed. Higher values (e.g. 48000) |
| 782 | cause higher audio quality but slower emulation speed. The default is |
| 783 | 48000. |
| 784 | .TP |
| 785 | .B \-[no]samples |
| 786 | Use samples if available. The default is ON (\-samples). |
| 787 | .TP |
| 788 | .B \-volume, \-vol \fIvalue |
| 789 | Sets the startup volume. It can later be changed with the user interface |
| 790 | (see Keys section). The volume is an attenuation in dB: |
| 791 | for example, '\-volume \-12' will start with \-12dB attenuation. |
| 792 | The default is 0. |
| 793 | .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 794 | .\" SDL specific |
| 795 | .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 796 | .TP |
| 797 | .B \-audio_latency \fIvalue |
| 798 | This controls the amount of latency built into the audio streaming. |
| 799 | The latency parameter controls the lower threshold. The default is 3; |
| 800 | increase to reduce glitches, decrease for responsiveness. |
| 801 | .\" |
| 802 | .\" ******************************************************* |
| 803 | .SS Input options |
| 804 | .\" ******************************************************* |
| 805 | .TP |
| 806 | .B \-[no]coin_lockout, \-[no]coinlock |
| 807 | Enables simulation of the "coin lockout" feature that is implemented |
| 808 | on a number of arcade game PCBs. It was up to the operator whether or not |
| 809 | the coin lockout outputs were actually connected to the coin |
| 810 | mechanisms. If this feature is enabled, then attempts to enter a coin |
| 811 | while the lockout is active will fail and will display a popup message |
| 812 | in the user interface. If this feature is disabled, the coin lockout |
| 813 | signal will be ignored. The default is ON (\-coin_lockout). |
| 814 | .TP |
| 815 | .B \-ctrlr \fIcontroller |
| 816 | Enables support for special controllers. Configuration files are |
| 817 | loaded from the ctrlrpath. They are in the same format as the .cfg |
| 818 | files that are saved, but only control configuration data is read |
| 819 | from the file. The default is NULL (no controller file). |
| 820 | .TP |
| 821 | .B \-[no]mouse |
| 822 | Controls whether or not MESS looks for a mouse controller to use. Note |
| 823 | that in many cases, lightguns are treated as mice by the operating |
| 824 | system, so you may need to enable this to enable lightgun support. When |
| 825 | this is enabled, you will not be able to use your mouse while running |
| 826 | MESS. If you want to get control of your computer back, you will need |
| 827 | to either pause MESS or quit. The default is OFF (\-nomouse). |
| 828 | .TP |
| 829 | .B \-[no]joystick, \-[no]joy |
| 830 | Controls whether or not MESS looks for joystick/gamepad controllers. |
| 831 | The default is ON (\-joystick). |
| 832 | .TP |
| 833 | .B \-[no]lightgun, \-[no]gun |
| 834 | Controls whether or not MESS makes use of lightgun controllers. |
| 835 | Note that most lightguns map to the mouse, so using \-lightgun and |
| 836 | \-mouse together may produce strange results. The default is OFF |
| 837 | (\-nolightgun). |
| 838 | .TP |
| 839 | .B \-[no]multikeyboard, \-[no]multikey |
| 840 | Determines whether MESS differentiates between multiple keyboards. |
| 841 | Some systems may report more than one keyboard; by default, the data |
| 842 | from all of these keyboards is combined so that it looks like a single |
| 843 | keyboard. Turning this option on will enable MESS to report keypresses |
| 844 | on different keyboards independently. The default is OFF |
| 845 | (\-nomultikeyboard). |
| 846 | .TP |
| 847 | .B \-[no]multimouse |
| 848 | Determines whether MESS differentiates between multiple mice. Some |
| 849 | systems may report more than one mouse device; by default, the data |
| 850 | from all of these mice is combined so that it looks like a single |
| 851 | mouse. Turning this option on will enable MESS to report mouse |
| 852 | movement and button presses on different mice independently. The |
| 853 | default is OFF (\-nomultimouse). |
| 854 | .TP |
| 855 | .B \-[no]steadykey, \-[no]steady |
| 856 | Some systems require two or more buttons to be pressed at exactly the |
| 857 | same time to make special moves. Due to limitations in the PC keyboard |
| 858 | hardware, it can be difficult or even impossible to accomplish that |
| 859 | using the standard keyboard handling. This option selects a different |
| 860 | handling that makes it easier to register simultaneous button presses, |
| 861 | but has the disadvantage of making controls less responsive. The |
| 862 | default is OFF (\-nosteadykey). |
| 863 | .TP |
| 864 | .B \-[no]offscreen_reload, \-[no]reload |
| 865 | Controls whether or not MESS treats a second button input from a |
| 866 | lightgun as a reload signal. In this case, MESS will report the gun's |
| 867 | position as (0,MAX) with the trigger held, which is equivalent to an |
| 868 | offscreen reload. This is only needed for systems that required you to |
| 869 | shoot offscreen to reload, and then only if your gun does not support |
| 870 | off screen reloads. The default is OFF (\-nooffscreen_reload). |
| 871 | .TP |
| 872 | .B \-joystick_map, \-joymap \fImap |
| 873 | Controls how joystick values map to digital joystick controls. |
| 874 | See /usr/share/doc/mame\-common/config.txt for full details on |
| 875 | joymap format. |
| 876 | .TP |
| 877 | .B \-joystick_deadzone, \-joy_deadzone, \-jdz \fIvalue |
| 878 | If you play with an analog joystick, the center can drift a little. |
| 879 | joystick_deadzone tells how far along an axis you must move before the |
| 880 | axis starts to change. This option expects a float in the range of |
| 881 | 0.0 to 1.0. Where 0 is the center of the joystick and 1 is the outer |
| 882 | limit. The default is 0.3. |
| 883 | .TP |
| 884 | .B \-joystick_saturation, \-joy_saturation, \-jsat \fIvalue |
| 885 | If you play with an analog joystick, the ends can drift a little, |
| 886 | and may not match in the +/\- directions. joystick_saturation tells how |
| 887 | far along an axis movement change will be accepted before it reaches |
| 888 | the maximum range. This option expects a float in the range of 0.0 to |
| 889 | 1.0, where 0 is the center of the joystick and 1 is the outer limit. |
| 890 | The default is 0.85. |
| 891 | .TP |
| 892 | .B \-natural, \-nat |
| 893 | Specifies whether to use a natural keyboard or not. |
| 894 | .TP |
| 895 | .B \-uimodekey, \-umk |
| 896 | Specifies the key used to toggle between full and partial UI mode. |
| 897 | .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 898 | .\" SDL specific |
| 899 | .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 900 | .TP |
| 901 | .B \-keymap |
| 902 | Enable keymap for non\-QWERTY keyboards. Used in conjunction |
| 903 | with \fB\-keymap_file\fR. |
| 904 | .TP |
| 905 | .B \-keymap_file \fIkeymap_file |
| 906 | Specifies the full path to the keymap file to be used. A few |
| 907 | keymap files are available in /usr/share/games/mess/keymaps. |
| 908 | .TP |
| 909 | .B \-joy_idx[0\-8] \fIjoystick |
| 910 | With these options you can assign a joystick to a |
| 911 | specific index in MESS. Even if the kernel will list the joysticks |
| 912 | in a different order on the next boot, MESS will still see the joystick |
| 913 | as e.g. "Joystick 2". Use mame \-v to see which joysticks are recognized. |
| 914 | Default is 'auto'. |
| 915 | .TP |
| 916 | .B \-sixaxis |
| 917 | Use special handling for PS3 Sixaxis controllers. |
| 918 | .TP |
| 919 | .B \-lightgun_index[1\-8] |
| 920 | Map lightgun to specific index in MESS. |
| 921 | .TP |
| 922 | .B \-videodriver, \-vd x11\fR|\fBdirectfb\fR|\fBauto |
| 923 | SDL video driver to use; auto selects SDL default. |
| 924 | .TP |
| 925 | .B \-audiodriver, \-ad alsa\fR|\fBarts\fR|\fBauto |
| 926 | SDL audio driver to use; auto selects SDL default. |
| 927 | .TP |
| 928 | .B \-gl_lib alsa\fR|\fBarts\fR|\fBauto |
| 929 | Alternative libGL.so to use; auto selects SDL default. |
| 930 | .\" |
| 931 | .\" ******************************************************* |
| 932 | .SS Input automatic enable options |
| 933 | .\" ******************************************************* |
| 934 | .TP |
| 935 | .B \-paddle_device, \-paddle \fR[\fInone\fR|\fIkeyboard\fR|\fImouse\fR|\fIlightgun\fR|\fIjoystick\fR] |
| 936 | .TP |
| 937 | .B \-adstick_device, \-adstick \fR[\fInone\fR|\fIkeyboard\fR|\fImouse\fR|\fIlightgun\fR|\fIjoystick\fR] |
| 938 | .TP |
| 939 | .B \-pedal_device, \-pedal \fR[\fInone\fR|\fIkeyboard\fR|\fImouse\fR|\fIlightgun\fR|\fIjoystick\fR] |
| 940 | .TP |
| 941 | .B \-dial_device, \-dial \fR[\fInone\fR|\fIkeyboard\fR|\fImouse\fR|\fIlightgun\fR|\fIjoystick\fR] |
| 942 | .TP |
| 943 | .B \-trackball_device, \-trackball \fR[\fInone\fR|\fIkeyboard\fR|\fImouse\fR|\fIlightgun\fR|\fIjoystick\fR] |
| 944 | .TP |
| 945 | .B \-lightgun_device \fR[\fInone\fR|\fIkeyboard\fR|\fImouse\fR|\fIlightgun\fR|\fIjoystick\fR] |
| 946 | .TP |
| 947 | .B \-positional_device \fR[\fInone\fR|\fIkeyboard\fR|\fImouse\fR|\fIlightgun\fR|\fIjoystick\fR] |
| 948 | .TP |
| 949 | .B \-mouse_device \fR[\fInone\fR|\fIkeyboard\fR|\fImouse\fR|\fIlightgun\fR|\fIjoystick\fR] |
| 950 | Each of these options controls auto\-enabling the mouse, or joystick |
| 951 | depending on the presence of a particular class of analog |
| 952 | control for a particular system. For example, if you specify the option |
| 953 | \-paddle mouse, then any system that has a paddle control will automatically |
| 954 | enable mouse controls just as if you had explicitly specified \-mouse. |
| 955 | Note that these controls override the values of \-[no]mouse, |
| 956 | \-[no]joystick, etc. |
| 957 | .\" |
| 958 | .\" ******************************************************* |
| 959 | .SS Debugging options |
| 960 | .\" ******************************************************* |
| 961 | .TP |
| 962 | .B \-[no]log |
| 963 | Creates a file called error.log which contains all of the internal |
| 964 | log messages generated by the MESS core and system drivers. The default |
| 965 | is OFF (\-nolog). |
| 966 | .TP |
| 967 | .B \-[no]verbose, \-[no]v |
| 968 | Displays internal diagnostic information. This information is very |
| 969 | useful for debugging problems with your configuration. |
| 970 | Please use the \-verbose option and include the resulting information |
| 971 | when reporting bugs. The default is OFF (\-noverbose). |
| 972 | .TP |
| 973 | .B \-update_in_pause |
| 974 | Enables updating the screen bitmap while the system is paused. This is |
| 975 | useful for debuggin in some scenarios (and gets in the way in others). |
| 976 | .TP |
| 977 | .B \-[no]debug, \-[no]d |
| 978 | Activates the integrated debugger. By default, the debugger is entered |
| 979 | by pressing the tilde (~) key during emulation. It is also entered |
| 980 | immediately at startup. The default is OFF (\-nodebug). |
| 981 | .TP |
| 982 | .B \-debugscript \fIfilename |
| 983 | Specifies a file that contains a list of debugger commands to execute |
| 984 | immediately upon startup. The default is NULL (no commands). |
| 985 | .TP |
| 986 | .B \-debug_internal, \-di |
| 987 | Use the internal debugger for debugging. |
| 988 | .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 989 | .\" SDL specific |
| 990 | .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 991 | .TP |
| 992 | .B \-[no]oslog |
| 993 | Outputs the error.log data to the system debugger. This can be used at |
| 994 | the same time as \-log to output the log data to both targets as well. |
| 995 | Default is OFF (\-nooslog). |
| 996 | .\" |
| 997 | .\" ******************************************************* |
| 998 | .SS Misc options |
| 999 | .\" ******************************************************* |
| 1000 | .TP |
| 1001 | .B \-bios \fIbiosname |
| 1002 | Specifies the specific BIOS to use with the current system, for |
| 1003 | systems that make use of a BIOS. The \-listxml output will list all of |
| 1004 | the possible BIOS names for a system. The default is 'default'. |
| 1005 | .TP |
| 1006 | .B \-[no]cheat, \-[no]c |
| 1007 | Enables the reading of the cheat database, if present, and the Cheat |
| 1008 | menu in the user interface. The default is OFF (\-nocheat). |
| 1009 | .TP |
| 1010 | .B \-[no]skip_gameinfo |
| 1011 | Forces MESS to skip displaying the system info screen. The default is OFF |
| 1012 | (\-noskip_gameinfo). |
| 1013 | .TP |
| 1014 | .B \-uifont \fIfontname |
| 1015 | Specifies the name of a BDF font file to use for the UI font. If this |
| 1016 | font cannot be found or cannot be loaded, the system will fall back |
| 1017 | to its built\-in UI font. On some platforms \fIfontname\fP can be a system |
| 1018 | font name instead of a BDF font file. The default is 'default' (use |
| 1019 | the OSD\-determined default font). |
| 1020 | .TP |
| 1021 | .B \-ramsize, \-ram |
| 1022 | Size of RAM (if supported by driver). |
| 1023 | .TP |
| 1024 | .B \-confirm_quit |
| 1025 | Display confirm quit screen on exit. |
| 1026 | .TP |
| 1027 | .B \-ui_mouse |
| 1028 | Display UI mouse cursor. |
| 1029 | .TP |
| 1030 | .B \-newui, \-nu |
| 1031 | Use the new MESS UI. |
| 1032 | .TP |
| 1033 | .B \-watchdog |
| 1034 | Specifies a number of seconds after which MESS should automatically exit |
| 1035 | if it detects that the emulation has locked up. |
| 1036 | .\" |
| 1037 | .\" |
| 1038 | .\" LEGAL NOTICE chapter |
| 1039 | .SH LEGAL NOTICE |
| 1040 | Please visit the MAME website for some important legal information: |
| 1041 | .PP |
| 1042 | http://mamedev.org/legal.html |