Previous 199869 Revisions Next

r24777 Tuesday 6th August, 2013 at 22:09:48 UTC by Tafoid
SDL: Revise the *IX man pages  [wallyweek]
[src/osd/sdl/man]mame.6 mess.6

trunk/src/osd/sdl/man/mess.6
r24776r24777
1616.\" http://www.mess.org/
1717.\"
1818.\"
19.TH MESS 6 2013-01-28 0.148u1 "The Multiple Emulator Super System (MESS)"
19.TH MESS 6 2013-06-12 0.149 "The Multiple Emulator Super System (MESS)"
2020.\"
2121.\"
2222.\" NAME chapter
r24776r24777
154154.B \-listsoftware, \-lsoft
155155Output the list of known software for the system.
156156.TP
157.B \-verifysoftware, \-vsoft
158Verify known software for the system.
157.B \-verifysoftware, \-vsoft \fR[\fIgamename\fR|\fIwildcard\fR]
158Checks for invalid or missing ROM images in your software lists.
159By default all drivers that have valid ZIP files or directories
160in the rompath are verified; however, you can limit this list by
161specifying a specific driver name or wildcard.
159162.TP
160163.B \-getsoftlist, \-glist
161164Retrieve software list by name.
162165.TP
163.B \-verifysoftlist, \-vlist
164Verify software list by name.
166.B \-verifysoftlist, \-vlist \fR[\fIsoftwarelistname\fR]
167Checks a specified software list for missing ROM images if files exist
168for issued softwarelistname. By default, all drivers that have valid
169ZIP files or directories in the rompath are verified; however, you can
170limit this list by specifying a specific softwarelistname (without .XML).
165171.TP
166172.B \-listmidi, \-mlist
167173List available MIDI I/O devices.
r24776r24777
353359(.cfg), NVRAM (.nv), and memory card files deleted. The default is NULL
354360(no recording).
355361.TP
356.B \-snapname \fIname
357Describes how MESS should name files for snapshots. \fIname\fP is a string
358that provides a template that is used to generate a filename. Three
362.B \-snapname \fIstring
363Describes how MESS should name files for snapshots. \fIstring\fP
364provides a template that is used to generate a filename. Three
359365simple substitutions are provided: the / character represents the
360path separator on any target platform (even Windows); the string \fI%g\fP
361represents the driver name of the current system; and the string \fI%i\fP
362represents an incrementing index. If \fI%i\fP is omitted, then each
366path separator on any target platform (even Windows); the literal \fB%g\fP
367represents the driver name of the current system; and the literal \fB%i\fP
368represents an incrementing index. If \fB%i\fP is omitted, then each
363369snapshot taken will overwrite the previous one; otherwise, MESS will
364find the next empty value for \fI%i\fP and use that for a filename. The
365default is \fI%g/%i\fP, which creates a separate folder for each game,
370find the next empty value for \fB%i\fP and use that for a filename. The
371default is '%g/%i', which creates a separate folder for each game,
366372and names the snapshots under it starting with 0000 and increasing
367from there.
373from there. In addition to the above, for drivers using different
374media, like carts or floppy disks, you can also use the
375\fB%d\fP\fI_[media]\fP indicator. Replace \fI[media]\fP with the media
376switch you want to use. A few examples: if you use
377.B mess nes \-cart robby \-snapname %g/%d_cart
378snapshots will be saved as \fBsnaps/nes/robby.png\fP; if you use
379.B mess c64 \-flop1 robby \-snapname %g/%d_flop1/%i
380snapshots will be saved as \fBsnaps/c64/robby/0000.png\fP.
368381.TP
369382.B \-snapsize \fIwidth\fRx\fIheight
370383Hard\-codes the size for snapshots and movie recording. By default,
r24776r24777
388401\fIviewname\fP can also be 'auto', which selects the first view with all
389402screens present. The default value is 'internal'.
390403.TP
404.B \-statename \fIstring
405Describes how MESS should store save state files, relative to the
406state_directory path. \fIstring\fP provides a template that
407is used to generate a relative path. Two simple substitutions are
408provided: the / character represents the path separator on any target
409platform (even Windows); the literal \fB%g\fP represents the driver name of
410the current game. The default is '%g', which creates a separate folder
411for each game. In addition to the above, for drivers using different
412media, like carts or floppy disks, you can also use the
413\fB%d_\fP\fI[media]\fP indicator. Replace \fI[media]\fP with the media
414switch you want to use. A few examples: if you use
415.B mess nes \-cart robby \-statename %g/%d_cart
416save states will be stored inside \fBsta/nes/robby/\fP; if you use
417.B mess c64 \-flop1 robby \-statename %g/%d_flop1
418save states will be stored inside \fBsta/c64/robby/\fP.
419.TP
391420.B \-mngwrite \fIfilename
392421Writes each video frame to the given file in MNG format, producing
393422an animation of the system session.
r24776r24777
893922The default is 0.85.
894923.TP
895924.B \-natural, \-nat
896Specifies whether to use a natural keyboard or not.
925Allows user to specify whether or not to use a natural keyboard.
926This allows you to start your game or system in a 'native' mode, depending
927on your region, allowing compatability for non\-"QWERTY" style keyboards.
928The default is OFF (-nonatural).
897929.TP
898930.B \-uimodekey, \-umk
899931Specifies the key used to toggle between full and partial UI mode.
r24776r24777
10301062.B \-ui_mouse
10311063Display UI mouse cursor.
10321064.TP
1065.B \-autoboot_command, \-ab \fIcommand
1066Command string to execute after machine boot (in quotes "").  To issue
1067a quote to the emulation, use \fB"""\fP in the string.
1068Using \fB\\n\fP will issue a create a new line, issuing what was
1069typed prior as a command. Example:
1070\fB\-autoboot_command "load """$""",8,1\\n"\fP.
1071.TP
1072.B \-autoboot_delay \fR[\fIseconds\fP]
1073Timer delay (in seconds) to trigger command execution on autoboot.
1074Default is 2.
1075.TP
1076.B \-autoboot_script, \-script \fR[\fIfilename.lua\fP]
1077File containing scripting to execute after machine boot.
1078.TP
10331079.B \-newui, \-nu
10341080Use the new MESS UI.
10351081.TP
trunk/src/osd/sdl/man/mame.6
r24776r24777
1313.\" and updated by Andrew Burton <burtona@gol.com>, July 2003
1414.\"
1515.\"
16.TH MAME 6 2013-01-28 0.148u1 "MAME \- The Multiple Arcade Machine Emulator"
16.TH MAME 6 2013-06-12 0.149 "MAME \- The Multiple Arcade Machine Emulator"
1717.\"
1818.\"
1919.\" NAME chapter
r24776r24777
155155.B \-listsoftware, \-lsoft
156156Output the list of known software for the system.
157157.TP
158.B \-verifysoftware, \-vsoft
159Verify known software for the system.
158.B \-verifysoftware, \-vsoft \fR[\fIgamename\fR|\fIwildcard\fR]
159Checks for invalid or missing ROM images in your software lists.
160By default all drivers that have valid ZIP files or directories
161in the rompath are verified; however, you can limit this list by
162specifying a specific driver name or wildcard.
160163.TP
161164.B \-getsoftlist, \-glist
162165Retrieve software list by name.
163166.TP
164.B \-verifysoftlist, \-vlist
165Verify software list by name.
167.B \-verifysoftlist, \-vlist \fR[\fIsoftwarelistname\fR]
168Checks a specified software list for missing ROM images if files exist
169for issued softwarelistname. By default, all drivers that have valid
170ZIP files or directories in the rompath are verified; however, you can
171limit this list by specifying a specific softwarelistname (without .XML).
166172.TP
167173.B \-listmidi, \-mlist
168List available MIDI I/O devices.
174Create a list of list available MIDI I/O devices for use with emulation.
175
169176.\"
170177.\" *******************************************************
171178.SS Configuration options
r24776r24777
179186.br
180187the main configuration file
181188.br
1822. \fI[name]\fB.ini\fR
1892. \fIname\fB.ini\fR
183190.br
184191where \fIname\fR is your executable name, i.e. mame unless you changed it
185192(e.g. if you renamed mame to mame0137, the parsed file will be
r24776r24777
361368(.cfg), NVRAM (.nv), and memory card files deleted. The default is NULL
362369(no recording).
363370.TP
364.B \-snapname \fIname
365Describes how MAME should name files for snapshots. \fIname\fP is a string
366that provides a template that is used to generate a filename. Three
371.B \-snapname \fIstring
372Describes how MAME should name files for snapshots. \fIstring\fP
373provides a template that is used to generate a filename. Three
367374simple substitutions are provided: the / character represents the
368path separator on any target platform (even Windows); the string \fI%g\fP
369represents the driver name of the current game; and the string \fI%i\fP
370represents an incrementing index. If \fI%i\fP is omitted, then each
375path separator on any target platform (even Windows); the literal \fB%g\fP
376represents the driver name of the current game; and the literal \fB%i\fP
377represents an incrementing index. If \fB%i\fP is omitted, then each
371378snapshot taken will overwrite the previous one; otherwise, MAME will
372find the next empty value for \fI%i\fP and use that for a filename. The
373default is \fI%g/%i\fP, which creates a separate folder for each game,
379find the next empty value for \fB%i\fP and use that for a filename. The
380default is \fB%g/%i\fP, which creates a separate folder for each game,
374381and names the snapshots under it starting with 0000 and increasing
375from there.
382from there. Example: if you use
383.B mame robby \-snapname foo/%g%i
384snapshots will be saved as \fBsnaps/foo/robby0000.png\fP,
385\fBsnaps/foo/robby0001.png\fP and so on.
376386.TP
377387.B \-snapsize \fIwidth\fPx\fIheight
378388Hard\-codes the size for snapshots and movie recording. By default,
r24776r24777
396406\fIviewname\fP can also be 'auto', which selects the first view with all
397407screens present. The default value is 'internal'.
398408.TP
409.B \-statename \fIstring
410Describes how MAME should store save state files, relative to the
411state_directory path. \fIstring\fP provides a template that
412is used to generate a relative path. Two simple substitutions are
413provided: the / character represents the path separator on any target
414platform (even Windows); the literal \fB%g\fP represents the driver name of
415the current game. The default is '%g', which creates a separate folder
416for each game. Example: if you use
417.B mame robby \-statename foo/%g
418save states will be stored inside \fBsta/foo/robby/\fP.
419.TP
399420.B \-mngwrite \fIfilename
400421Writes each video frame to the given \fIfilename\fP in MNG format, producing
401422an animation of the   game session. Note that \-mngwrite only writes video
r24776r24777
913934The default is 0.85.
914935.TP
915936.B \-natural, \-nat
916Specifies whether to use a natural keyboard or not.
937Allows user to specify whether or not to use a natural keyboard.
938This allows you to start your game or system in a 'native' mode, depending
939on your region, allowing compatability for non\-"QWERTY" style keyboards.
940The default is OFF (-nonatural).
917941.TP
918942.B \-joystick_contradictory
919943Enable contradictory direction digital joystick input at the same time.
r24776r24777
10551079.TP
10561080.B \-ui_mouse
10571081Display UI mouse cursor.
1082.TP
1083.B \-autoboot_command, \-ab \fIcommand
1084Command string to execute after machine boot (in quotes "").  To issue
1085a quote to the emulation, use \fB"""\fP in the string.
1086Using \fB\\n\fP will issue a create a new line, issuing what was
1087typed prior as a command. Example:
1088\fB\-autoboot_command "load """$""",8,1\\n"\fP.
1089.TP
1090.B \-autoboot_delay \fR[\fIseconds\fP]
1091Timer delay (in seconds) to trigger command execution on autoboot.
1092Default is 2.
1093.TP
1094.B \-autoboot_script, \-script \fR[\fIfilename.lua\fP]
1095File containing scripting to execute after machine boot.
10581096.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++
10591097.\" SDL specific
10601098.\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++

Previous 199869 Revisions Next


© 1997-2024 The MAME Team