From 6bc35b45de157b63ee632af77549b36bd3b5858e Mon Sep 17 00:00:00 2001 From: thrust26 Date: Sat, 25 Nov 2017 12:32:46 +0100 Subject: [PATCH] started to document the developer options dialog and commandline parameters. --- docs/graphics/options.png | Bin 3430 -> 4347 bytes docs/index.html | 107 ++++++++++++++++++++++++-------------- 2 files changed, 69 insertions(+), 38 deletions(-) diff --git a/docs/graphics/options.png b/docs/graphics/options.png index 5497cb1542c5a4700e2262359fb40eff72402645..f242fab3d156d3e3ddf3e303a21fbf8e355b8d06 100644 GIT binary patch literal 4347 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 diff --git a/docs/index.html b/docs/index.html index cf8b9aeb5..89ae662ed 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1791,11 +1791,6 @@ emulator, or a user-defined palette. - -
-colorloss <1|0>
- Enable/disable the PAL color-loss effect. - -
-framerate <number>
Display the given number of frames per second. Normally, Stella @@ -1909,18 +1904,6 @@ - -
-tv.jitter <1|0>
- Enable TV jitter/roll effect, when there are too many or too few scanlines - per frame. - - - -
-tv.jitter_recovery <1 - 20>
- When TV jitter/roll effect is enabled, determines how long to delay recovery - time (recovery spread over multiple frames). - -
-tv.scanlines <0 - 100>
Blargg TV effects scanline intensity, where 0 means completely off. @@ -2085,11 +2068,6 @@ saving a ROM state file. - -
-stats <1|0>
- Overlay console info on the TIA image during emulation. - -
-fastscbios <1|0>
Disable Supercharger BIOS progress loading bars. @@ -2327,22 +2305,6 @@ event. - -
-tiadriven <1|0>
- Set unused TIA pins to be randomly driven high or low on a read/peek. - If disabled, use the last databus value for those pins instead. - - - -
-cpurandom <S,A,X,Y,P>
- On reset, randomize the content of the specified CPU registers. - - - -
-ramrandom <1|0>
- On reset, either randomize all RAM content, or zero it out instead. - -
-bs <type>
Set "Cartridge.Type" property. See the Game Properties section @@ -2444,6 +2406,75 @@ to real hardware. + +

The following are available in two sets, one for players (prefixed by "plr.") and one + for developers (prefixd by "dev."). Only use them if you know what you're doing! Note + that in all cases, the values supplied to the arguments are not case sensitive.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ArgumentDescription
-dev.settings <1|0>
Select developer (1) or player (0) set.
-<plr.|dev.>stats <1|0>
Overlay console info on the TIA image during emulation.
-<plr.|dev.>console <2600|7800>
Select console for B/W and Pause key handling and RAM initialization.
-<plr.|dev.>bankrandom <1|0>
On reset, randomize the startup bank.
-<plr.|dev.>ramrandom <1|0>
On reset, either randomize all RAM content, or initialize with zero (console = 2600)/startup values (console = 7800) instead.
-<plr.|dev.>cpurandom <S,A,X,Y,P>
On reset, randomize the content of the specified CPU registers.
-<plr.|dev.>debugcolors <1|0>
Enable/disable the fixed debug colors.
-<plr.|dev.>colorloss <1|0>
Enable/disable the PAL color-loss effect.
-<plr.|dev.>tv.jitter <1|0>
Enable TV jitter/roll effect, when there are too many or too few scanlines + per frame.
-<plr.|dev.>tv.jitter_recovery <1 - 20>
When TV jitter/roll effect is enabled, determines how long to delay recovery + time (recovery spread over multiple frames).
-<plr.|dev.>tiadriven <1|0>
Set unused TIA pins to be randomly driven high or low on a read/peek. + If disabled, use the last databus value for those pins instead.

2. Changing Options