diff options
Diffstat (limited to 'games/mame/man/mess.6')
| -rw-r--r-- | games/mame/man/mess.6 | 1064 |
1 files changed, 0 insertions, 1064 deletions
diff --git a/games/mame/man/mess.6 b/games/mame/man/mess.6 deleted file mode 100644 index 879fd0568f..0000000000 --- a/games/mame/man/mess.6 +++ /dev/null @@ -1,1064 +0,0 @@ -.\" -*- nroff -*- -.\" -.\" mess.6 -.\" -.\" Man page created from usage and source information: -.\" * commands: see src/emu/clifront.c clifront.h -.\" * options: core entries, see src/emu/emuopts.c emuopts.h -.\" SDL-specific entries, see src/osd/sdl/sdlmain.c osdsdl.h -.\" Cesare Falco <cesare.falco@gmail.com>, March 2011 -.\" -.\" Some text borrowed from the xmame 0.106 man page, -.\" done by Rene Herrmann <rene.herrmann@berlin.de>, September 2000 -.\" and updated by Andrew Burton <burtona@gol.com>, July 2003 -.\" -.\" Other info's taken from MESS Wiki as well: -.\" http://mess.redump.net/ -.\" -.\" -.TH mess 6 2011-03-02 0.141 "The Multiple Emulator Super System (MESS)" -.\" -.\" -.\" NAME chapter -.SH NAME -MESS \- The Multiple Emulator Super System -.\" -.\" -.\" SYNOPSIS chapter -.SH SYNOPSIS -.B mess -.RI [ options ] -.I system -.\" -.\" -.\" DESCRIPTION chapter -.SH DESCRIPTION -MESS documents the hardware for a wide variety of (mostly vintage) computers, -video game consoles, and calculators through software emulation. As a nice -side effect, MESS allows software and games for these hardware platforms -to run on modern PCs. -.\" -.\" -.\" OPTIONS chapter -.SH OPTIONS -.\" -.\" ******************************************************* -.SS Core commands -.\" ******************************************************* -.TP -.B \-help, \-? -Displays current MESS version and copyright notice. -.TP -.B \-validate, \-valid -Performs internal validation on every driver in MESS. Run this -before submitting changes to ensure that you haven't violated any of -the core system rules. -.\" -.\" ******************************************************* -.SS Configuration commands -.\" ******************************************************* -.TP -.B \-createconfig, \-cc -Creates the default 'mess.ini' file in the current directory. All the -configuration options (not commands) described below can be permanently -changed by editing this configuration file. -.TP -.B \-showconfig, \-sc -Displays the current configuration settings. -.TP -.B \-showusage, \-su -Displays a summary of all the command line options. For options that -are not mentioned here, the short summary given by \-showusage -is usually sufficient. -.\" -.\" ******************************************************* -.SS Frontend commands -.\" ******************************************************* -All the '\-list' commands below write info to the screen. -If you wish to write the info to a textfile instead, use redirection. -For example, -.B mess \-listxml > ~/messlist.xml -writes the full list of supported systems to 'messlist.xml' in your -home directory. -.TP -.B \-listxml, \-lx \fR[\fIsystem\fR|\fIwildcard\fR] -List comprehensive details for all of the supported systems. The output -is quite long, so it is usually better to redirect this into a file. -The output is in XML format. By default all systems are listed; however, -you can limit this list by specifying a driver name or wildcard. -.TP -.B \-listfull, \-ll \fR[\fIsystem\fR|\fIwildcard\fR] -Displays a list of system driver names and descriptions. By default all -systems are listed; however, you can limit this list by specifying a -driver name or wildcard. -.TP -.B \-listsource, \-ls \fR[\fIsystem\fR|\fIwildcard\fR] -Displays a list of drivers and the names of the source files their system -drivers live in. Useful for finding which driver a system runs on in -order to fix bugs. By default all systems are listed; however, you can -limit this list by specifying a driver name or wildcard. -.TP -.B \-listclones, \-lc \fR[\fIsystem\fR|\fIwildcard\fR] -Displays a list of clones. By default all clones are listed; however, -you can limit this list by specifying a driver name or wildcard. -.TP -.B \-listbrothers, \-lb \fR[\fIsystem\fR|\fIwildcard\fR] -Displays a list of "brothers" or other drivers from same sourcefile. -By default all systems are listed; however, you can limit this list by -specifying a driver name or wildcard. -.TP -.B \-listcrc -Displays a full list of CRCs of all ROM images referenced by all -drivers within MESS code. -.TP -.B \-listroms \fIsystem -Displays a list of ROM images referenced by the specified system. -.TP -.B \-listsamples \fIsystem -Displays a list of samples referenced by the specified system. -.TP -.B \-verifyroms \fR[\fIsystem\fR|\fIwildcard\fR] -Checks for invalid or missing ROM images. By default all drivers that -have valid ZIP files or directories in the rom path are verified; -however, you can limit this list by specifying a driver name or -wildcard. -.TP -.B \-verifysamples \fR[\fIsystem\fR|\fIwildcard\fR] -Checks for invalid or missing samples. By default all drivers that -have valid ZIP files or directories in the samplepath are verified; -however, you can limit this list by specifying a driver name or wildcard. -.TP -.B \-romident -Attempts to identify ROM files, if they are known to MESS, in the -specified .zip file or directory. This command can be used to try and -identify ROM sets taken from unknown boards. On exit, the errorlevel -is returned as one of the following: -.RS -.TP -.B 0 -all files were identified -.TP -.B 7 -all files were identified except for some "non\-ROM" files -.TP -.B 8 -some files were identified -.TP -.B 9 -no files were identified -.RE -.TP -.B \-listdevices, \-ld -Output the list of devices referenced by a given system or set of systems. -.TP -.B \-listmedia, \-lm -Output the list of available media for the system. -.TP -.B \-listsoftware -Output the list of known software for the system. -.\" -.\" ******************************************************* -.SS Configuration options -.\" ******************************************************* -.TP -.B \-[no]readconfig, \-[no]rc -Enables or disables the reading of the config files. When enabled -(which is the default), MESS reads the following config files in order: -.RS -.TP 15 -.B mess.ini -the main configuration file -.TP -.IB driver .ini -based on the source file name of the system driver -.TP -.IB parent .ini -for clones only, may be called recursively -.TP -.IB system .ini -note this sometimes resolves to the same of the source driver -.P -The settings in the later ini's override those in the earlier ini's. -The default is ON (\-readconfig). -.RE -.\" -.\" ******************************************************* -.SS Search path options -.\" ******************************************************* -Be careful to use the path, directory and file options in -mess.ini ONLY. Otherwise, the outcome may be unpredictable and not -consistent across releases. -.TP -.B \-rompath, \-rp, \-biospath, \-bp \fIpath -Specifies a list of paths within which to find ROM or hard disk images. -Multiple paths can be specified by separating them with semicolons. -The default is 'roms' (that is, a directory 'roms' in the same directory -as the MESS executable). -.TP -.B \-samplepath, \-sp \fIpath -Specifies a list of paths within which to find sample files. Multiple -paths can be specified by separating them with semicolons. The default -is 'samples' (that is, a directory 'samples' in the same directory as -the MESS executable). -.TP -.B \-artpath, \-artwork_directory \fIpath -Specifies a list of paths within which to find artwork files. Multiple -paths can be specified by separating them with semicolons. The default -is 'artwork' (that is, a directory 'artwork' in the same directory as -the MESS executable). -.TP -.B \-ctrlrpath, \-ctrlr_directory \fIpath -Specifies a list of paths within which to find controller\-specific -configuration files. Multiple paths can be specified by separating -them with semicolons. The default is 'ctrlr' (that is, a -directory 'ctrlr' in the same directory as the MESS executable). -.TP -.B \-inipath \fIpath -Specifies a list of paths within which to find .ini files. Multiple -paths can be specified by separating them with semicolons. The default -is '/etc/mess'. -.TP -.B \-fontpath \fIpath -Specifies a list of paths within which to find .bdf font files. Multiple -paths can be specified by separating them with semicolons. The default -is '.' (that is, search in the same directory as the MESS executable). -.TP -.B \-cheatpath \fIpath -Specifies a list of paths within which to find cheat files. Multiple -paths can be specified by separating them with semicolons. The default -is 'cheat' (that is, a directory 'cheat' in the same directory as -the MESS executable). -.TP -.B \-crosshairpath \fIpath -Specifies a list of paths within which to find crosshair files. Multiple -paths can be specified by separating them with semicolons. The default -is 'crosshair' (that is, a directory 'crosshair' in the same directory as -the MESS executable). If the Crosshair is set to default in the menu, -MESS will look for system/cross#.png and then cross#.png in the -specified path, where # is the player number. Failing that, -MESS will use built\-in default crosshairs. -.TP -.B \-hashpath \fIpath -Specifies a list of paths within which to search for software hash files. -Multiple paths can be specified by separating them with semicolons. -The default is 'hash' (that is, a directory 'hash' in the same directory -as the MESS executable). -.\" -.\" ******************************************************* -.SS Output Directory Options -.\" ******************************************************* -.TP -.B \-cfg_directory \fIpath -Specifies a single directory where configuration files are stored. -Configuration files store user configurable settings that are read at -startup and written when MESS exits. The default is 'cfg' (that is, -a directory 'cfg' in the same directory as the MESS executable). If this -directory does not exist, it will be automatically created. -.TP -.B \-nvram_directory \fIpath -Specifies a single directory where NVRAM files are stored. NVRAM files -store the contents of EEPROM and non\-volatile RAM (NVRAM) for systems -which used this type of hardware. This data is read at startup and -written when MESS exits. The default is 'nvram' (that is, a -directory 'nvram' in the same directory as the MESS executable). If this -directory does not exist, it will be automatically created. -.TP -.B \-memcard_directory \fIpath -Specifies a single directory where memory card files are stored. Memory -card files store the contents of removable memory cards for systems which -used this type of hardware. This data is read and written under control -of the user via the 'Memory Card' menu in the user interface. The -default is 'memcard' (that is, a directory 'memcard' in the same -directory as the MESS executable). If this directory does not exist, -it will be automatically created. -.TP -.B \-input_directory \fIpath -Specifies a single directory where input recording files are stored. -Input recordings are created via the \-record option and played back via -the \-playback option. The default is 'inp' (that is, a directory 'inp' -in the same directory as the MESS executable). If this directory -does not exist, it will be automatically created. -.TP -.B \-state_directory \fIpath -Specifies a single directory where save state files are stored. Save -state files are read and written either upon user request, or when using -the \-autosave option. The default is 'sta' (that is, a directory 'sta' -in the same directory as the MESS executable). If this directory does -not exist, it will be automatically created. -.TP -.B \-snapshot_directory \fIpath -Specifies a single directory where screen snapshots are stored, when -requested by the user. The default is 'snap' (that is, a directory 'snap' -in the same directory as the MESS executable). If this directory -does not exist, it will be automatically created. -.TP -.B \-diff_directory \fIpath -Specifies a single directory where hard drive differencing files are -stored. Hard drive differencing files store any data that is written -back to a hard disk image, in order to preserve the original image. The -differencing files are created at startup when a system with a hard disk -image. The default is 'diff' (that is, a directory 'diff' in the same -directory as the MESS executable). If this directory does not exist, -it will be automatically created. -.TP -.B \-comment_directory \fIpath -Specifies a single directory where debugger comment files are stored. -Debugger comment files are written by the debugger when comments are -added to the disassembly for a system. The default is 'comments' (that is, -a directory 'comments' in the same directory as the MESS executable). -If this directory does not exist, it will be automatically created. -.\" -.\" ******************************************************* -.SS State/playback options -.\" ******************************************************* -.TP -.B \-state \fIslot -Immediately after starting the specified system, will cause the save -state in the specified slot to be loaded. -.TP -.B \-[no]autosave -When enabled, automatically creates a save state file when exiting MESS -and automatically attempts to reload it when later starting MESS with -the same system. This only works for systems that have explicitly enabled -save state support in their driver. The default is OFF (\-noautosave). -.TP -.B \-playback, \-pb \fIfile -Specifies a file from which to play back a series of system inputs. This -feature does not work reliably for all systems, but can be used to watch -a previously recorded system session from start to finish. In order to -make things consistent, you should only record and playback with all -configuration (.cfg), NVRAM (.nv), and memory card files deleted. The -default is NULL (no playback). -.TP -.B \-record, \-rec \fIfile -Specifies a file to record all input from a system session. This can be -used to record a system session for later playback. This feature does not -work reliably for all systems, but can be used to watch a previously -recorded system session from start to finish. In order to make things -consistent, you should only record and playback with all configuration -(.cfg), NVRAM (.nv), and memory card files deleted. The default is NULL -(no recording). -.TP -.B \-snapname \fIname -Describes how MESS should name files for snapshots. -.I name -is a string that provides a template that is used to generate a file name. -Three simple substitutions are provided: -.RS -.TP -.B / -represents the path separator on any target platform (even Windows) -.TP -.B %g -represents the driver name of the current system -.TP -.B %i -represents an incrementing index. If omitted, then each snapshot taken -will overwrite the previous one; otherwise, MESS will find the next -empty value for %i and use that for a file name. -.P -The default is '%g/%i', which creates a separate folder for each system, -and names the snapshots under it starting with 0000 and increasing -from there. -.RE -.TP -.B \-snapsize \fIwidth\fRx\fIheight -Hard\-codes the size for snapshots and movie recording. By default, -MESS will create snapshots at the system's current resolution in raw -pixels, and will create movies at the system's starting resolution in -raw pixels. If you specify this option, then MESS will create both -snapshots and movies at the size specified, and will bilinear filter -the result. Note that this size does not automatically rotate if the -system is vertically oriented. The default is 'auto'. -.TP -.B \-snapview internal\fR|\fBauto\fR|\fIview -Specifies the view to use when rendering snapshots and movies. -.RS -.TP 12 -.B internal -renders a separate snapshot per screen or renders movies only of the -first screen using the special 'internal' view. -.TP -.B auto -selects the first view with all screens present -.TP -.I view -select the first view whose name matches all the characters. -For example, -.B mame \-snapview native -will match the "Native (15:14)" view even though it is not a perfect -match. -.P -The default value is 'internal'. -.RE -.TP -.B \-mngwrite \fIfile -Writes each video frame to the given file in MNG format, producing -an animation of the system session. -Note that \-mngwrite only writes video frames; it does not save any audio -data. Use \-wavwrite for that, and reassemble the audio/video using -offline tools. The default is NULL (no recording). -.TP -.B \-aviwrite \fIfile -Stream video and sound data to the given file -in AVI format, producing an animation of the system session complete -with sound. The default is NULL (no recording). -.TP -.B \-wavwrite \fIfile -Writes the final mixer output to the given file -in WAV format, producing an audio recording of the system session. -The default is NULL (no recording). -.TP -.B \-[no]burnin -Tracks brightness of the screen during play and at the end of -emulation generates a PNG that can be used to simulate burn\-in -effects on other systems. The resulting PNG is created such that the -least\-used areas of the screen are fully white (since burned\-in areas -are darker, all other areas of the screen must be lightened a touch). -The intention is that this PNG can be loaded via an artwork file with -a low alpha (e.g, 0.1\-0.2 seems to work well) and blended over the -entire screen. The PNG files are saved in the snap directory under -the system/burnin\-<screen.name>.png. The default is OFF (\-noburnin). -.\" -.\" ******************************************************* -.SS Performance options -.\" ******************************************************* -.TP -.B \-[no]autoframeskip, \-[no]afs -Automatically determines the frameskip level while you're playing the -system, adjusting it constantly in a frantic attempt to keep the system -running at full speed. Turning this on overrides the value you have set -for \-frameskip below. The default is OFF (\-noautoframeskip). -.TP -.B \-frameskip, \-fs \fIvalue -Specifies the frameskip value (autoframeskip must be disabled). This is the -number of frames out of every 12 to drop when running. For example, if you -say \-frameskip 2, then MESS will display 10 out of every 12 frames. By -skipping those frames, you may be able to get full speed in a system that -requires more horsepower than your computer has. The default value is 0, -which skips no frames. -.TP -.B \-seconds_to_run, \-str \fIvalue -This option can be used for benchmarking and automated testing. It tells -MESS to stop execution after a fixed number of seconds. By combining -this with a fixed set of other command line options, you can set up a -consistent environment for benchmarking MESS performance. In addition, -upon exit, the \-str option will write a screenshot called final.png -to the system's snapshot directory. -.TP -.B \-[no]throttle -Configures the default thottling setting. When throttling is on, MESS -attempts to keep the system running at the system's intended speed. When -throttling is off, MESS runs the system as fast as it can. Note that the -fastest speed is more often than not limited by your graphics card, -especially for older systems. The default is ON (\-throttle). -.TP -.B \-[no]sleep -Allows MESS to give time back to the system when running with \-throttle. -This allows other programs to have some CPU time, assuming that the -system isn't taxing 100% of your CPU resources. This option can potentially -cause hiccups in performance if other demanding programs are running. -The default is ON (\-sleep). -.TP -.B \-speed -Controls the speed of gameplay, relative to realtime; smaller numbers are -slower. Default is 1.00. -.TP -.B \-refreshspeed, \-rs -Automatically adjusts the \-speed parameter to keep the effective refresh -rate below that of the lowest screen refresh rate. -.\" -.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -.\" SDL specific -.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -.TP -.B \-multithreading, \-mt -Enable multithreading; this enables rendering and blitting on a separate -thread. The default is OFF. -.TP -.B \-numprocessors, \-np -Set number of processors; this overrides the number the system reports. -.TP -.B \-sdlvideofps -Show SDL video performance. -.\" -.\" ******************************************************* -.SS Rotation options -.\" ******************************************************* -.TP -.B \-[no]rotate -Rotate the system to match its normal state (horizontal/vertical). This -ensures that both vertically and horizontally oriented systems show up -correctly without the need to rotate your monitor. If you want to keep -the system displaying 'raw' on the screen the way the actual machine would -have, turn this option off. The default is ON (\-rotate). -.TP -.B \-[no]ror -.TP -.B \-[no]rol -Rotate the system screen to the right (clockwise) or left -(counter\-clockwise) relative to either its normal state (if \-rotate -is specified) or its native state (if \-norotate is specified). The -default for both of these options is OFF (\-noror \-norol). -.TP -.B \-[no]autoror -.TP -.B \-[no]autorol -These options are designed for use with pivoting screens that only -pivot in a single direction. If your screen only pivots clockwise, -use \-autorol to ensure that the system will fill the screen either -horizontally or vertically in one of the directions you can handle. -If your screen only pivots counter\-clockwise, use \-autoror. -.TP -.B \-[no]flipx -.TP -.B \-[no]flipy -Flip (mirror) the system screen either horizontally (\-flipx) or -vertically (\-flipy). The flips are applied after the \-rotate and -\-ror/\-rol options are applied. The default for both of these options -is OFF (\-noflipx \-noflipy). -.\" -.\" ******************************************************* -.SS Artwork options -.\" ******************************************************* -.TP -.B \-[no]artwork_crop, \-[no]artcrop -Enable cropping of artwork to the system screen area only. This -option can also be controlled via the Video Options menu in the user -interface. The default is OFF (\-noartwork_crop). -.TP -.B \-[no]use_backdrops, \-[no]backdrop -Enables/disables the display of backdrops. The default is ON -(\-use_backdrops). -.TP -.B \-[no]use_overlays, \-[no]overlay -Enables/disables the display of overlays. The default is ON -(\-use_overlays). -.TP -.B \-[no]use_bezels, \-[no]bezel -Enables/disables the display of bezels. The default is ON -(\-use_bezels). -.\" -.\" ******************************************************* -.SS Screen options -.\" ******************************************************* -.TP -.B \-brightness \fIvalue -Controls the default brightness, or black level, of the system screens. -This option does not affect the artwork or other parts of the display. -Using the MESS UI, you can individually set the brightness for each system -screen; this option controls the initial value for all visible system -screens. The standard value is 1.0. Selecting lower values (down to 0.1) -will produce a darkened display, while selecting higher values (up to -2.0) will give a brighter display. The default is 1.0. -.TP -.B \-contrast \fIvalue -Controls the contrast, or white level, of the system screens. This option -does not affect the artwork or other parts of the display. Using the -MESS UI, you can individually set the contrast for each system screen; -this option controls the initial value for all visible system screens. The -standard value is 1.0. Selecting lower values (down to 0.1) will produce -a dimmer display, while selecting higher values (up to 2.0) will -give a more saturated display. The default is 1.0. -.TP -.B \-gamma \fIvalue -Controls the gamma, which produces a potentially nonlinear black to -white ramp, for the system screens. This option does not affect the -artwork or other parts of the display. Using the MESS UI, you can -individually set the gamma for each system screen; this option controls -the initial value for all visible system screens. The standard value is -1.0, which gives a linear ramp from black to white. Selecting lower -values (down to 0.1) will increase the nonlinearity toward black, -while selecting higher values (up to 3.0) will push the nonlinearity -toward white. The default is 1.0. -.TP -.B \-pause_brightness \fIvalue -This controls the brightness level when MESS is paused. The default -value is 0.65. -.\" -.\" ******************************************************* -.SS Vector rendering options -.\" ******************************************************* -.TP -.B \-[no]antialias, \-[no]aa -Enables antialiased line rendering for vector systems. The default is ON -(\-antialias). -.TP -.B \-beam \fIwidth -Sets the width of the vectors. This is a scaling factor against the -standard vector width. A value of 1.0 will keep the default vector line -width. Smaller values will reduce the width, and larger values will -increase the width. The default is 1.0. -.TP -.B \-flicker \fIvalue -Simulates a vector "flicker" effect, similar to a vector monitor that -needs adjustment. This option requires a float argument in the range of -0.00\-100.00 (0=none, 100=maximum). The default is 0. -.\" -.\" ******************************************************* -.SS Video options -.\" ******************************************************* -.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -.\" SDL specific -.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -.TP -.B \-video soft\fR|\fBopengl\fR|\fBopengl16\fR|\fBnone -Specifies which video subsystem to use for drawing: -.RS -.TP 12 -.B soft -uses software rendering, which is slower but more compatible. -.TP -.B opengl -uses OpenGL and your graphics accelerator to speed up many -aspects of drawing MESS including compositing artwork, overlays, and -bezels, as well as stretching the image to fit your screen. -.TP -.B opengl16 -uses alternate OpenGL code, which should provide faster -output on some cards. -.TP -.B none -does no drawing and is intended for CPU benchmarking. -.P -Default is 'soft'. -.RE -.TP -.B \-[no]window, \-[no]w -Run MESS in either full screen or a window. This is a fully\-featured window -mode where the window resizes as necessary to track what the system does. -And you can resize it yourself with your OS's standard window controls. -The default is OFF (\-nowindow). -.TP -.B \-[no]maximize, \-[no]max -Controls initial window size in windowed mode. If it is set on, the -window will initially be set to the maximum supported size when you -start MESS. If it is turned off, the window will start out at the -smallest supported size. This option only has an effect when the -\-window option is used. The default is ON (\-maximize). -.TP -.B \-keepaspect, \-ka -Forces the correct aspect ratio. This means when you're resizing the window -in windowed mode the actual system image will resize in discrete steps to -maintain the proper shape of the system graphics. If you turn this off you can -resize the window to anything you like and get funny squishing and stretching. -The same applies for full\-screen. Default is ON (\-keepaspect). -.TP -.B \-unevenstretch, \-ues -Allow non\-integer stretch factors. Video purists should stay far, far away -from this option, while everyone else will be happy to know that it lets you -fill the screen properly in full\-screen mode. Default is ON (\-unevenstretch). -.TP -.B \-effect none\fR|\fIfile -Name of a PNG file to use for visual effects, or 'none'. Default is 'none'. -.TP -.B \-centerh -Center horizontally within the view area. Default is ON (\-centerh). -.TP -.B \-centerv -Center vertically within the view area. Default is ON (\-centerv). -.TP -.B \-waitvsync -Enable waiting for the start of VBLANK before flipping screens; -reduces tearing effects. -.\" -.\" ******************************************************* -.SS Software video rendering subsystem options -.\" ******************************************************* -.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -.\" SDL specific -.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -All the options in this group are available only with softare video -rendering subsystem (\-video soft). -.TP -.B \-prescale \fIvalue -Scale screen rendering by this amount in software. Default is 1. -.TP -.B \-scalemode, \-sm none\fR|\fBasync\fR|\fByv12\fR|\fByuy2\fR\ -|\fByv12x2\fR|\fByuy2x2 -Hardware scaling mode. -.RS -.TP 12 -.B none -use software rendering -.TP -.B async -async overlay -.TP -.B yv12 -yv12 overlay -.TP -.B yuy2 -yuy2 overlay -.TP -.B yv12x2 -yv12 overlay using x2 prescaling -.TP -.B yuy2x2 -yuy2 overlay using x2 prescaling -.P -Default is 'none'. -.RE -.\" -.\" ******************************************************* -.SS OpenGL video rendering subsystem options -.\" ******************************************************* -.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -.\" SDL specific -.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -All the options in this group are available only with OpenGL video -rendering subsystem (\-video opengl or \-video opengl16). -.TP -.B \-filter, \-glfilter, \-flt -Enable bilinear filtering on screen output. Default is ON (\-filter). -.TP -.B \-gl_forcepow2texture -Force power of two textures. Default is NO. -.TP -.B \-gl_notexturerect -Don't use OpenGL GL_ARB_texture_rectangle. Default is ON: turn off -(set this to 0) if corruption occurs in OpenGL mode, at cost of some -performance loss. -.TP -.B \-gl_vbo -Enable OpenGL VBO, if available, for a performance increase. -Default is ON: turn off (set this to 0) if corruption occurs. -.TP -.B \-gl_pbo -Enable OpenGL PBO, if available, for a performance increase. -Default is ON: turn off (set this to 0) if corruption occurs. -.TP -.B \-gl_glsl -Enable OpenGL GLSL, if available, for a performance increase. -.TP -.B \-gl_glsl_filter \fIvalue -Enable OpenGL GLSL filtering instead of FF filtering. Allowed values are -.RS -.TP 8 -.B 0 -plain -.TP -.B 1 -bilinear -.P -Default is 1. -.RE -.TP -.BR \-glsl_shader_mame # -Preferred custom OpenGL GLSL shader set mame bitmap, with # ranging -from 0 to 9. -.TP -.BR \-glsl_shader_screen # -Preferred custom OpenGL GLSL shader screen bitmap, with # ranging -from 0 to 9. -.TP -.B \-gl_glsl_vid_attr -Enable OpenGL GLSL handling of brightness and contrast. Better RGB system -performance for free. Default is ON. -.TP -.B \-resolution, \-r -Select the resolution to use in full\-screen mode; \-switchres must -be enabled for this to work. -.\" -.\" ******************************************************* -.SS Full screen options -.\" ******************************************************* -.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -.\" SDL specific -.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -.TP -.B \-[no]switchres -Affects full screen mode only. Chooses if MESS can try to change the -screen resolution (color depth is normally left alone) when in -full\-screen mode. If it's off, you always get your desktop resolution -in full\-screen mode (which can be useful for LCDs). -.TP -.B \-useallheads -Split full screen image across monitors. -.\" -.\" ******************************************************* -.SS Sound options -.\" ******************************************************* -.TP -.B \-[no]sound -Enable or disable sound altogether. The default is ON (\-sound). -.TP -.B \-samplerate, \-sr \fIvalue -Sets the audio sample rate. Smaller values (e.g. 11025) cause lower -audio quality but faster emulation speed. Higher values (e.g. 48000) -cause higher audio quality but slower emulation speed. The default is -48000. -.TP -.B \-[no]samples -Use samples if available. The default is ON (\-samples). -.TP -.B \-volume, \-vol \fIvalue -Sets the startup volume. It can later be changed with the user interface -(see Keys section). The volume is an attenuation in dB: -for example, '\-volume \-12' will start with \-12dB attenuation. -The default is 0. -.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -.\" SDL specific -.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -.TP -.B \-audio_latency \fIvalue -This controls the amount of latency built into the audio streaming. -The latency parameter controls the lower threshold. The default is 3; -increase to reduce glitches, decrease for responsiveness. -.\" -.\" ******************************************************* -.SS Input options -.\" ******************************************************* -.TP -.B \-[no]coin_lockout, \-[no]coinlock -Enables simulation of the "coin lockout" feature that is implemented -on a number of arcade game PCBs. It was up to the operator whether or not -the coin lockout outputs were actually connected to the coin -mechanisms. If this feature is enabled, then attempts to enter a coin -while the lockout is active will fail and will display a popup message -in the user interface. If this feature is disabled, the coin lockout -signal will be ignored. The default is ON (\-coin_lockout). -.TP -.B \-ctrlr \fIcontroller -Enables support for special controllers. Configuration files are -loaded from the ctrlrpath. They are in the same format as the .cfg -files that are saved, but only control configuration data is read -from the file. The default is NULL (no controller file). -.TP -.B \-[no]mouse -Controls whether or not MESS looks for a mouse controller to use. Note -that in many cases, lightguns are treated as mice by the operating -system, so you may need to enable this to enable lightgun support. When -this is enabled, you will not be able to use your mouse while running -MESS. If you want to get control of your computer back, you will need -to either pause MESS or quit. The default is OFF (\-nomouse). -.TP -.B \-[no]joystick, \-[no]joy -Controls whether or not MESS looks for joystick/gamepad controllers. -The default is ON (\-joystick). -.TP -.B \-[no]lightgun, \-[no]gun -Controls whether or not MESS makes use of lightgun controllers. -Note that most lightguns map to the mouse, so using \-lightgun and -\-mouse together may produce strange results. The default is OFF -(\-nolightgun). -.TP -.B \-[no]multikeyboard, \-[no]multikey -Determines whether MESS differentiates between multiple keyboards. -Some systems may report more than one keyboard; by default, the data -from all of these keyboards is combined so that it looks like a single -keyboard. Turning this option on will enable MESS to report keypresses -on different keyboards independently. The default is OFF -(\-nomultikeyboard). -.TP -.B \-[no]multimouse -Determines whether MESS differentiates between multiple mice. Some -systems may report more than one mouse device; by default, the data -from all of these mice is combined so that it looks like a single -mouse. Turning this option on will enable MESS to report mouse -movement and button presses on different mice independently. The -default is OFF (\-nomultimouse). -.TP -.B \-[no]steadykey, \-[no]steady -Some systems require two or more buttons to be pressed at exactly the -same time to make special moves. Due to limitations in the PC keyboard -hardware, it can be difficult or even impossible to accomplish that -using the standard keyboard handling. This option selects a different -handling that makes it easier to register simultaneous button presses, -but has the disadvantage of making controls less responsive. The -default is OFF (\-nosteadykey). -.TP -.B \-[no]offscreen_reload, \-[no]reload -Controls whether or not MESS treats a second button input from a -lightgun as a reload signal. In this case, MESS will report the gun's -position as (0,MAX) with the trigger held, which is equivalent to an -offscreen reload. This is only needed for systems that required you to -shoot offscreen to reload, and then only if your gun does not support -off screen reloads. The default is OFF (\-nooffscreen_reload). -.TP -.B \-joystick_map, \-joymap \fImap -Controls how joystick values map to digital joystick controls. -See /usr/share/doc/mame\-common/config.txt for full details on -joymap format. -.TP -.B \-joystick_deadzone, \-joy_deadzone, \-jdz \fIvalue -If you play with an analog joystick, the center can drift a little. -joystick_deadzone tells how far along an axis you must move before the -axis starts to change. This option expects a float in the range of -0.0 to 1.0. Where 0 is the center of the joystick and 1 is the outer -limit. The default is 0.3. -.TP -.B \-joystick_saturation, \-joy_saturation, \-jsat \fIvalue -If you play with an analog joystick, the ends can drift a little, -and may not match in the +/\- directions. joystick_saturation tells how -far along an axis movement change will be accepted before it reaches -the maximum range. This option expects a float in the range of 0.0 to -1.0, where 0 is the center of the joystick and 1 is the outer limit. -The default is 0.85. -.TP -.B \-natural, \-nat -Specifies whether to use a natural keyboard or not. -.TP -.B \-uimodekey, \-umk -Specifies the key used to toggle between full and partial UI mode. -.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -.\" SDL specific -.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -.TP -.B \-keymap -Enable keymap for non\-QWERTY keyboards. Used in conjunction -with \-keymap_file. -.TP -.B \-keymap_file \fIfile -Specifies the full path to the keymap file to be used. A few -keymap files are available in /usr/share/games/mame\-common/keymaps. -.TP -.B \-joy_idx1 \fIjoystick -.TP -.B \-joy_idx2 \fIjoystick -.TP -.B \-joy_idx3 \fIjoystick -.TP -.B \-joy_idx4 \fIjoystick -.TP -.B \-joy_idx5 \fIjoystick -.TP -.B \-joy_idx6 \fIjoystick -.TP -.B \-joy_idx7 \fIjoystick -.TP -.B \-joy_idx8 \fIjoystick -With these options you can assign a joystick to a -specific index in MESS. Even if the kernel will list the joysticks -in a different order on the next boot, MESS will still see the joystick -as e.g. 'Joystick 2'. Use -.B mess \-v -to see which joysticks are recognized. Default is AUTO. -.TP -.B \-sixaxis -Use special handling for PS3 Sixaxis controllers. -.TP -.B \-videodriver, \-vd x11\fR|\fBdirectfb\fR|\fBauto -SDL video driver to use; auto selects SDL default. -.TP -.B \-audiodriver, \-ad alsa\fR|\fBarts\fR|\fBauto -SDL audio driver to use; auto selects SDL default. -.TP -.B \-gl_lib alsa\fR|\fBarts\fR|\fBauto -Alternative libGL.so to use; auto selects SDL default. -.\" -.\" ******************************************************* -.SS Input automatic enable options -.\" ******************************************************* -.TP -.B \-paddle_device, \-paddle none\fR|\fBkeyboard\fR|\fBmouse\fR\ -|\fBlightgun\fR|\fBjoystick -.TP -.B \-adstick_device, \-adstick none\fR|\fBkeyboard\fR|\fBmouse\fR\ -|\fBlightgun\fR|\fBjoystick -.TP -.B \-pedal_device, \-pedal none\fR|\fBkeyboard\fR|\fBmouse\fR\ -|\fBlightgun\fR|\fBjoystick -.TP -.B \-dial_device, \-dial none\fR|\fBkeyboard\fR|\fBmouse\fR\ -|\fBlightgun\fR|\fBjoystick -.TP -.B \-trackball_device, \-trackball none\fR|\fBkeyboard\fR|\fBmouse\fR\ -|\fBlightgun\fR|\fBjoystick -.TP -.B \-lightgun_device none\fR|\fBkeyboard\fR|\fBmouse\fR\ -|\fBlightgun\fR|\fBjoystick -.TP -.B \-positional_device none\fR|\fBkeyboard\fR|\fBmouse\fR\ -|\fBlightgun\fR|\fBjoystick -.TP -.B \-mouse_device none\fR|\fBkeyboard\fR|\fBmouse\fR\ -|\fBlightgun\fR|\fBjoystick -Each of these options controls auto\-enabling the mouse, or joystick -depending on the presence of a particular class of analog -control for a particular system. For example, if you specify the option -\-paddle mouse, then any system that has a paddle control will automatically -enable mouse controls just as if you had explicitly specified \-mouse. -Note that these controls override the values of \-[no]mouse, -\-[no]joystick, etc. -.\" -.\" ******************************************************* -.SS Debugging options -.\" ******************************************************* -.TP -.B \-[no]log -Creates a file called error.log which contains all of the internal -log messages generated by the MESS core and system drivers. The default -is OFF (\-nolog). -.TP -.B \-[no]verbose, \-[no]v -Displays internal diagnostic information. This information is very -useful for debugging problems with your configuration. -Please use the \-verbose option and include the resulting information -when reporting bugs. The default is OFF (\-noverbose). -.TP -.B \-update_in_pause -Enables updating the screen bitmap while the system is paused. This is -useful for debuggin in some scenarios (and gets in the way in others). -.TP -.B \-[no]debug, \-[no]d -Activates the integrated debugger. By default, the debugger is entered -by pressing the tilde (~) key during emulation. It is also entered -immediately at startup. The default is OFF (\-nodebug). -.TP -.B \-debugscript \fIfile -Specifies a file that contains a list of debugger commands to execute -immediately upon startup. The default is NULL (no commands). -.TP -.B \-debug_internal, \-di -Use the internal debugger for debugging. -.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -.\" SDL specific -.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -.TP -.B \-[no]oslog -Outputs the error.log data to the system debugger. This can be used at -the same time as \-log to output the log data to both targets as well. -Default is OFF (\-nooslog). -.\" -.\" ******************************************************* -.SS UI options -.\" ******************************************************* -.TP -.B \-uifont -Specify a font to use. -.TP -.B \-newui, \-nu -Use the new MESS UI. -.\" -.\" ******************************************************* -.SS Misc options -.\" ******************************************************* -.TP -.B \-bios default\fR|\fIbios -Specifies the specific BIOS to use with the current system, for -systems that make use of a BIOS. The \-listxml output will list all of -the possible BIOS names for a system. The default is 'default'. -.TP -.B \-[no]cheat, \-[no]c -Enables the reading of the cheat database, if present, and the Cheat -menu in the user interface. The default is OFF (\-nocheat). -.TP -.B \-[no]skip_gameinfo -Forces MESS to skip displaying the system info screen. The default is OFF -(\-noskip_gameinfo). -.TP -.B \-ramsize, \-ram -Size of RAM (if supported by driver). -.TP -.B \-writeconfig, \-wc -Writes configuration to -.IB driver .ini -on exit. -.\" -.\" -.\" FILES chapter -.SH FILES -.TP -.B /etc/mess/mess.ini -Main configuration file |