From 1e82d107eefe2d494b0ffa1c8eded84af2c5756d Mon Sep 17 00:00:00 2001 From: thrust26 Date: Sun, 26 Nov 2017 10:15:33 +0100 Subject: [PATCH] documentation for "Developer Settings" started --- docs/graphics/options_debugger.png | Bin 3847 -> 4535 bytes docs/index.html | 97 +++++++++++++++++++++++------ 2 files changed, 77 insertions(+), 20 deletions(-) diff --git a/docs/graphics/options_debugger.png b/docs/graphics/options_debugger.png index 2605d266cba447b931f31784036368683a181e50..dee99f9947272ab4e549ad05f8bc321d36b4c883 100644 GIT binary patch literal 4535 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 N=6K>ro&DM5{{{jGdaM8d literal 3847 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 wy++)>+NSNAFullscreenself-explanatory-fullscreen Fullscreen Fillcompletely fill TIA image in fullscreen-tia.fsfill VSyncenable vertical sync'ed updates-vsync - PAL color-lossuse PAL color-loss effect-colorloss Fast SC/AR BIOSskip progress loading bars for SuperCharger ROMs-fastscbios Show UI messagesoverlay UI messages onscreen-uimessages Center windowattempt to center application window-center @@ -2530,8 +2529,6 @@ TV Phosphorenable phosphor mode under what conditions-tv.phosphor Phosphor (Default)default blend level to use in phosphor mode
(needs to be manually set for your particular hardware)-tv.phosblend - Jitter/Roll effectemulate screen roll with inconsistent scanline count-tv.jitter - Jitter/Roll recoverydetermines recovery time for screen rolling-tv.jitter_recovery Scanline Intensitysets scanline black-level intensity-tv.scanlines Scanline Interpolationsmooth/blend scanlines into image-tv.scaninter Adjustable slidersset specific attribute in 'Custom' mode-tv.contrast, tv.hue, etc. @@ -2590,7 +2587,7 @@
-

UI Settings dialog (3 tabs):

+

UI Settings dialog (2 tabs):

@@ -2600,21 +2597,6 @@

- - - - - - -
     - - - - - -
ItemBrief descriptionFor more information,
see CommandLine
Debugger Width/Heightself-explanatory (requires ROM reload)-dbg.res
Set window size for ...self-explanatory presets (requires ROM reload)N/A
Font Styleself-explanatory (requires ROM reload)-dbg.fontstyle
-
-
@@ -2689,6 +2671,18 @@
+ +
+

Developer Settings dialog:

+ + + + + + + +
    
This tab is described in further detail in + Advanced Configuration - Developer Options/Integrated Debugger.

3. Event Remapping / Input Devices

@@ -3002,7 +2996,70 @@

8. Developer Options/Integrated Debugger

-

Many options are available for ROM developers, which are described in +

Several developer related settings can be configured in the 'Developer Settings' dialog. + Two sets ('Player settings', 'Developer settings') allow easy switching between different + settings (for playing or developing games) at once.

+ +

Developer Settings dialog (Emulator)

+ + + + + + +
     + + + + + + + + + + + + + +
ItemBrief descriptionFor more information,
see CommandLine
Player/Developer settingsSelects the active settings set-dev.settings
Frame StatisticsOverlay console info on the TIA image during emulation.-plr.stats
-dev.stats
ConsoleSelect the console type, this affects Color/B&W/Pause key emulation and zero-page RAM initialzation-plr.console
-dev.console
Random startup bankRandomize the startup bank for several bankswitch types-plr.bankrandom
-dev.bankrandom
Randomize zero-page...When loading a ROM, randomize all RAM content instead of initializing with all zeroes (console = 2600) or startup values (console = 7800)-plr.ramrandom
-dev.ramrandom
Randomize CPUWhen loading a ROM, randomize the content of the specified CPU registers-plr.cpurandom
-dev.cpurandom
PAL color-lossUse PAL color-loss effect-plr.colorloss
-dev.colorloss
Debug colorsUse fixed debug colors-plr.debugcolors
-dev.debugcolors
Jitter/roll effectEmulate screen roll with inconsistent scanline count-plr.tv.jitter
-dev.tv.jitter
Jitter/roll recoveryDetermines recovery time for screen rolling-plr.tv.jitter_recovery
-dev.tv.jitter_recovery
Drive unused TIA pins...Unused TIA pins are read random instead of the last databus value-plr.tiadriven
-dev.tiadriven
+
+ +

Developer Settings dialog (States) TODO

+ + + + + + +
     + + + + + + + +
ItemBrief descriptionFor more information,
see CommandLine
-.plr
-.dev
-.plr
-.dev
-.plr
-.dev
-.plr
-.dev
-.plr
-.dev
+
+ +

Developer Settings dialog (Debugger)

+ + + + + + +
     + + + + + +
ItemBrief descriptionFor more information,
see CommandLine
Font Styleself-explanatory (requires ROM reload)-dbg.fontstyle
Font Sizeself-explanatory (requires ROM reload)N/A
Debugger Width/Heightself-explanatory (requires ROM reload)-dbg.res
+
+
+ +

Many more options are available for ROM developers, which are described in different sections of this manual, as follows: