summaryrefslogtreecommitdiffstatshomepage
path: root/docs
diff options
context:
space:
mode:
author Fabio Priuli <etabeta78@users.noreply.github.com>2013-05-28 05:12:28 +0000
committer Fabio Priuli <etabeta78@users.noreply.github.com>2013-05-28 05:12:28 +0000
commit8d7e236c8352102d9b533e1de4697326e9fd7ee3 (patch)
treee34f6bedb591fa44d0a578c3fb77383ddf7c3bc4 /docs
parentb8b819fae7404c1f37ca3e91bfbd19fc563ade13 (diff)
emuopts.c: Added a new option -statename which allows to specify the location of state saving,
relative to -state_directory (whose usage remains unchanged). Syntax is basically the same as snapname, allowing for the / character as path separator, %g as the driver name, and %d_[media] as the image name mounted in the "media" device. For example, using -statename foo/%g when running "mame wrally" will store save states into the folder sta/foo/wrally/ ; using -statename %g/%d_cart when running "mess nes -cart smb" will store save states into the folder sta/nes/smb/ ; using -statename %g/%d_cdrm when running "mess pce -cart cdsys -cdrm draculax" will store save states into sta/pce/draculax/ Specifying a media switch which is not available (e.g. %d_cdrm in a c64) or a media switch where no image is mounted (e.g. %d_cdrm in pce while playing a hucard game) will revert the option to its default value %g and save states will be stored in sta/*gamename*/ as in previous versions. [Fabio Priuli] Needless to say, this option is very useful with home computers and consoles in MESS since it allows to have 36 save slots for each game instead of 36 for the whole system library Notice that a clean compile is required, due to the addition to the running_machine class
Diffstat (limited to 'docs')
-rw-r--r--docs/config.txt30
1 files changed, 26 insertions, 4 deletions
diff --git a/docs/config.txt b/docs/config.txt
index f0eb9395aee..7865ecf96b7 100644
--- a/docs/config.txt
+++ b/docs/config.txt
@@ -525,10 +525,15 @@ Core state/playback options
find the next empty value for %i and use that for a filename. The
default is %g/%i, which creates a separate folder for each game,
and names the snapshots under it starting with 0000 and increasing
- from there. In the case of using different media, you can use the
- %d_[media] indicator. Replace [media] with the default media being
- used. In the example: 'mess nes megaman2u -snapname %g/%d_cart'
- snapshots will then be placed in 'snaps\nes\megaman2u.png'
+ from there. In addition to the above, for drivers using different
+ media, like carts or floppy disks, you can also use the %d_[media]
+ indicator. Replace [media] with the media switch you want to use.
+ A few examples: if you use 'mame robby -snapname foo/%g%i' snapshots
+ will be saved as 'snaps\foo\robby0000.png' , 'snaps\foo\robby0001.png'
+ and so on ; if you use 'mess nes -cart robby -snapname %g/%d_cart'
+ snapshots will be saved as 'snaps\nes\robby.png' ; if you use
+ 'mess c64 -flop1 robby -snapname %g/%d_flop1/%i' snapshots will be
+ saved as 'snaps\c64\robby\0000.png'.
-snapsize <width>x<height>
@@ -554,6 +559,23 @@ Core state/playback options
<viewname> can also be 'auto', which selects the first view with all
screens present. The default value is 'internal'.
+-statename <name>
+
+ Describes how MAME should store save state files, relative to the
+ state_directory path. <name> is a string that provides a template that
+ is used to generate a relative path. Two simple substitutions are
+ provided: the / character represents the path separator on any target
+ platform (even Windows); the string %g represents the driver name of
+ the current game. The default is %g, which creates a separate folder for
+ each game. In addition to the above, for drivers using different
+ media, like carts or floppy disks, you can also use the %d_[media]
+ indicator. Replace [media] with the media switch you want to use.
+ A few examples: if you use 'mame robby -statename foo/%g' save states
+ will be stored inside 'sta\foo\robby\' ; if you use 'mess nes -cart
+ robby -statename %g/%d_cart' save states will be stored inside
+ 'sta\nes\robby\' ; if you use 'mess c64 -flop1 robby -statename
+ %g/%d_flop1' save states will be stored inside 'sta\c64\robby\'.
+
-[no]burnin
Tracks brightness of the screen during play and at the end of