diff --git a/Changes.txt b/Changes.txt
index 222b1e8a3..83f2abc26 100644
--- a/Changes.txt
+++ b/Changes.txt
@@ -14,26 +14,29 @@
6.1.2 to 6.2: (??? ??, 2020)
- * Added that paddle centering and sensitivity can be adjusted (TODO: Doc)
-
- * Added that Driving controller sensitivity can be adjusted (TODO: Doc)
-
* Added high scores: Score addresses, game variation etc. can be defined for
a game. This allows the user to save high scores for these games. For each
game and variation, the top 10 scores can be saved. (TODO: Doc)
- * Added interactive palette to Video & Audio settings
+ * Added interactive palette to Video & Audio settings.
* Added 'Custom' palette, generated from user controlled phase shifts.
* Added 'Turbo' mode, runs the game as fast as the computer allows.
+ * Added that paddle centering (per ROM) and sensitivity can be adjusted
+
+ * Added that mouse sensitivity for Driving controller can be adjusted
+
* Added selectable dialog fonts
* Added separate positioning of launcher, emulator and debugger
* Added option which lets default ROM path follow launcher navigation
+ * Added debugger 'saveaccess' function, which saves memory access counts to
+ a CSV file.
+
* Added displaying last write address in the debugger.
* Added detection of color and audio data in DiStella.
diff --git a/docs/debugger.html b/docs/debugger.html
index 91e71bd47..423a20aa1 100644
--- a/docs/debugger.html
+++ b/docs/debugger.html
@@ -978,6 +978,7 @@ clearsavestateifs - Clear all savestate points
runtopc - Run until PC is set to value xx
s - Set Stack Pointer to value xx
save - Save breaks, watches, traps and functions to file xx
+ saveaccess - Save access counters to CSV file
saveconfig - Save Distella config file (with default name)
savedis - Save Distella disassembly (with default name)
saverom - Save (possibly patched) ROM (with default name)
diff --git a/docs/graphics/eventmapping.png b/docs/graphics/eventmapping.png
index 86deacd4a..f9b089b6d 100644
Binary files a/docs/graphics/eventmapping.png and b/docs/graphics/eventmapping.png differ
diff --git a/docs/graphics/eventmapping_devsports.png b/docs/graphics/eventmapping_devsports.png
index d66197a72..ab187595e 100644
Binary files a/docs/graphics/eventmapping_devsports.png and b/docs/graphics/eventmapping_devsports.png differ
diff --git a/docs/graphics/eventmapping_remap.png b/docs/graphics/eventmapping_remap.png
index a2e3ce949..34df62937 100644
Binary files a/docs/graphics/eventmapping_remap.png and b/docs/graphics/eventmapping_remap.png differ
diff --git a/docs/graphics/options.png b/docs/graphics/options.png
index db86da3fb..9f8a95430 100644
Binary files a/docs/graphics/options.png and b/docs/graphics/options.png differ
diff --git a/docs/graphics/options_audio.png b/docs/graphics/options_audio.png
index e77d69a5e..f37f07c6f 100644
Binary files a/docs/graphics/options_audio.png and b/docs/graphics/options_audio.png differ
diff --git a/docs/graphics/options_developer_timemachine.png b/docs/graphics/options_developer_timemachine.png
index ddb58f28e..498f83c0f 100644
Binary files a/docs/graphics/options_developer_timemachine.png and b/docs/graphics/options_developer_timemachine.png differ
diff --git a/docs/graphics/options_gameinfo_controller.png b/docs/graphics/options_gameinfo_controller.png
index 9b9413ab2..04cc025db 100644
Binary files a/docs/graphics/options_gameinfo_controller.png and b/docs/graphics/options_gameinfo_controller.png differ
diff --git a/docs/graphics/options_misc.png b/docs/graphics/options_misc.png
index b1930b45d..1faa756b5 100644
Binary files a/docs/graphics/options_misc.png and b/docs/graphics/options_misc.png differ
diff --git a/docs/graphics/options_video.png b/docs/graphics/options_video.png
index be67fe065..deb857ca4 100644
Binary files a/docs/graphics/options_video.png and b/docs/graphics/options_video.png differ
diff --git a/docs/graphics/options_video_tv.png b/docs/graphics/options_video_tv.png
index e76d32ba6..5ce3c3f2a 100644
Binary files a/docs/graphics/options_video_tv.png and b/docs/graphics/options_video_tv.png differ
diff --git a/docs/index.html b/docs/index.html
index 82b8c4a38..b2da54d33 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -19,7 +19,7 @@
A multi-platform Atari 2600 VCS emulator
- Release 6.1
+ Release 6.2
User's Guide
@@ -70,7 +70,7 @@
- February 1999 - March 2020
+ February 1999 - ??? 2020
The Stella Team
Stella Homepage
@@ -2008,11 +2008,11 @@
-center <1|0> |
- Centers game window (if possible). |
+ Centers all windows (if possible). |
- -windowedpos <WxH> |
+ -windowedpos <XxY> |
Sets the window position in windowed emulator mode. |
@@ -2029,13 +2029,38 @@
- -phase_ntsc <number> |
- Set phase shift for custom NTSC palette. |
+ -pal.phase_ntsc <number> |
+ Adjust phase shift of 'custom' NTSC palette. |
- -phase_pal <number> |
- Set phase shift for custom PAL palette. |
+ -pal.phase_pal <number> |
+ Adjust phase shift of 'custom' PAL palette. |
+
+
+
+ -pal.hue <number> |
+ Adjust hue of current palette (range -1.0 to 1.0). |
+
+
+
+ -pal.saturation <number> |
+ Adjust saturation of current palette (range -1.0 to 1.0). |
+
+
+
+ -pal.contrast <number> |
+ Adjust contrast of current palette (range -1.0 to 1.0). |
+
+
+
+ -pal.brightness <number> |
+ Adjust brightness of current palette (range -1.0 to 1.0). |
+
+
+
+ -pal.gamma <number> |
+ Adjust gamma of current palette (range -1.0 to 1.0). |
@@ -2152,36 +2177,6 @@
and 'Custom' modes.
-
- -tv.contrast <number> |
- Blargg TV effects 'contrast' (only available in custom mode,
- range -1.0 to 1.0). |
-
-
-
- -tv.brightness <number> |
- Blargg TV effects 'brightness' (only available in custom mode,
- range -1.0 to 1.0). |
-
-
-
- -tv.hue <number> |
- Blargg TV effects 'hue' (only available in custom mode,
- range -1.0 to 1.0). |
-
-
-
- -tv.saturation <number> |
- Blargg TV effects 'saturation' (only available in custom mode,
- range -1.0 to 1.0). |
-
-
-
- -tv.gamma <number> |
- Blargg TV effects 'gamma' (only available in custom mode,
- range -1.0 to 1.0). |
-
-
-tv.sharpness <number> |
Blargg TV effects 'sharpness' (only available in custom mode,
@@ -2319,6 +2314,13 @@
faster movement. |
+
+ -dcsense <number> |
+ Sensitivity for emulation of driving controllers when using a mouse.
+ Valid range of values is from 1 to 20, with larger numbers causing
+ faster movement. |
+
+
-saport <lr|rl> |
Determines how to enumerate the Stelladaptor/2600-daptor devices in the
@@ -2410,7 +2412,7 @@
|
- -launcherpos <WxH> |
+ -launcherpos <XxY> |
Sets the window position in windowed ROM launcher mode. |
@@ -2566,7 +2568,7 @@
- -dbg.pos <WxH> |
+ -dbg.pos <XxY> |
Sets the window position in windowed debugger mode. |
@@ -2703,6 +2705,16 @@
Set "Controller.SwapPaddles" property. |
+
+ -pxcenter <-10..30> |
+ Set "Controller.PaddlesXCenter" property. |
+
+
+
+ -pycenter <-10..30> |
+ Set "Controller.PaddlesYCenter" property. |
+
+
-ma <Auto|XY> |
Set "Controller.MouseAxis" property.
@@ -2860,7 +2872,7 @@
Options Menu dialog:
- Video Settings dialog:
+ Video & Audio Settings dialog (Display):
 |
@@ -2869,29 +2881,42 @@
| Item | Brief description | For more information,
see CommandLine |
|---|
| Renderer | Use specified rendering mode | -video |
- | Palette | Palette for emulation mode | -palette |
- | NTSC phase | Phase shift for custom NTSC palette | -phase_ntsc |
- | PAL phase | Phase shift for custom PAL palette | -phase_pal |
- | Interpolation | Interpolation for TIA image | -tia.inter |
- | Zoom | Zoom level for emulation mode | -tia.zoom |
- | V-Size adjust | Adjust height of TIA image | -tia.vsizeadjust |
- | Emul. speed | Emulation speed | -speed |
- | VSync | Enable vertical synced updates | -vsync |
+ | Interpolation | Interpolation of TIA image | -tia.inter |
+ | Zoom | Zoom level of TIA image | -tia.zoom |
| Fullscreen | Self-explanatory - Note that colors may slightly change.
This depends on the OS and renderer used. | -fullscreen |
| Stretch | In fullscreen mode, completely fill screen with TIA image | -tia.fs_stretch |
| Overscan | In fullscreen mode, add overscan to the TIA image | -tia.fs_overscan |
- | Fast SuperCharger load | Skip progress loading bars for SuperCharger ROMs | -fastscbios |
- | Show UI messages | Overlay UI messages onscreen | -uimessages |
- | Center window | Attempt to center application windows, else position at last position | -center |
- | Multi-threading | Enable multi-threaded rendering | -threads |
+ | V-Size adjust | Adjust height of TIA image | -tia.vsizeadjust |
- Video Settings dialog (TV Effects):
+ Video & Audio Settings dialog (Palettes):
+
+
+  |
+ |
+
+
+ | Item | Brief description | For more information,
see CommandLine |
|---|
+ | Palette | Palette used for emulation mode | -palette |
+ | NTSC phase | Adjust phase shift for 'Custom' NTSC palette | -pal.phase_ntsc |
+ | PAL phase | Adjust phase shift for 'Custom' PAL palette | -pal.phase_pal |
+ | Hue | Adjust hue of currently selected palette | -pal.hue |
+ | Saturation | Adjust saturation of currently selected palette | -pal.saturation |
+ | Contrast | Adjust contrast of currently selected palette | -pal.contrast |
+ | Brightness | Adjust brightness of currently selected palette | -pal.brightness |
+ | Gamma | Adjust gamma of currently selected palette | -pal.gamma |
+
+ |
+
+
+
+
+ Video & Audio Settings dialog (TV Effects):
 |
@@ -2900,24 +2925,24 @@
| Item | Brief description | For more information,
see CommandLine |
|---|
| TV mode | Disable TV effects, or select TV preset | -tv.filter |
- | Adjustable sliders | Set specific attribute in 'Custom' TV mode | -tv.contrast, -tv.hue, etc. |
+ | Adjustable sliders | Set specific attribute in 'Custom' TV mode | -tv.sharpness, -tv.resolution, etc. |
| Phosphor for all ROMs | Enable phosphor mode for all ROMs | -tv.phosphor |
| Blend (phosphor) | Blend level to use in phosphor mode for all ROMs
(needs to be manually adjusted for your particular hardware) | -tv.phosblend |
| Scanline intensity | Sets scanline black-level intensity.
Note: No scanlines in 1x mode snapshots. | -tv.scanlines |
- | Clone Composite | Copy 'Composite' attributes to 'Custom' sliders | |
- | Clone S-Video | Copy 'S-Video' attributes to 'Custom' sliders | |
- | Clone RGB | Copy 'RGB' attributes to 'Custom' sliders | |
- | Clone Bad adjust | Copy 'Bad Adjust' attributes to 'Custom' sliders | |
- | Revert | Revert attribute sliders to saved 'Custom' settings | |
+ | Clone RGB | Copy 'RGB' attributes to 'Custom' TV mode sliders | |
+ | Clone S-Video | Copy 'S-Video' attributes to 'Custom' TV mode sliders | |
+ | Clone Composite | Copy 'Composite' attributes to 'Custom' TV mode sliders | |
+ | Clone Bad adjust | Copy 'Bad Adjust' attributes to 'Custom' TV mode sliders | |
+ | Revert | Revert attribute sliders to saved 'Custom' TV mode settings | |
- Audio Settings dialog:
+ Video & Audio Settings dialog (Audio):
 |
@@ -2941,7 +2966,7 @@
-audio.resampling_quality |
| Headroom | Number of frames to buffer before playback starts. Higher values increase latency, but reduce the potential for dropouts. | -audio.headroom |
| Buffer size | Maximum size of the audio buffer. Higher values increase maximum latency, but reduce the potential for dropouts | -audio.buffer_size |
- | Stereo for all ROMs | Enables stereo mode for all ROMs. | -audio.stereo |
+ | Stereo for all ROMs | Enable stereo mode for all ROMs. | -audio.stereo |
| Pitfall II music pitch | Defines the pitch of Pitfall II music (which may vary between carts). | -audio.dpc_pitch |
@@ -2960,6 +2985,44 @@
|
+
+ Emulation dialog:
+
+
+  |
+ |
+
+
+ | Item | Brief description | For more information,
see CommandLine |
|---|
+ | Emulation speed | Emulation speed | -speed |
+ | VSync | Enable vertical synced updates | -vsync |
+ | Turbo | Enable 'Turbo' mode for maximum emulation speed. This overwrites 'Emulation speed' setting and disables 'VSync'. | -turbo |
+ | Multi-threading | Enable multi-threaded rendering | -threads |
+ | Fast SuperCharger load | Skip progress loading bars for SuperCharger ROMs | -fastscbios |
+ | Show UI messages | Overlay UI messages onscreen | -uimessages |
+ | Confirm exiting... | Display a popup when emulation is exited | -confirmexit |
+
+ | When entering/exiting emulation: |
+
+ Automatically save no, current or all Time Machine states when exiting emulation.
+ The latter also loads all states when entering emulation. When this is enabled, you
+ can always continue your game session from where you exited it. Even including the
+ Time Machine buffer!
+ |
+ -saveonexit |
+
+ | Automatically change... |
+
+ Automatically change to the next available save state slot after saving a ROM state file.
+ |
+ -autoslot |
+
+
+ |
+
+
+
+
Input Settings dialog:
@@ -2980,9 +3043,9 @@
| Item | Brief description | For more information,
see CommandLine |
|---|
| Theme | Theme to use for UI elements (see examples) | -uipalette |
| Dialogs font | The font used in the dialogs | -dialogfont |
- | HiDPI mode | Scales the UI by a factor of two when enabled | -hidpi |
+ | HiDPI mode | Scale the UI by a factor of two when enabled | -hidpi |
| Dialogs position | Position of dialogs with Stella window | -dialogpos |
- | Confirm exiting... | Display a popup when emulation is exited | -confirmexit |
+ | Center windows | Attempt to center application windows, else position at last position | -center |
| List input delay | Maximum delay between keypresses in filelist-widgets before a search string resets. | -listdelay |
| Mouse wheel scroll | Number of lines a mouse scroll will move in list-widgets | -mwheel |
| Double-click speed | Speed of mouse double-clicks | -mdouble |
@@ -3129,16 +3192,12 @@
| Item | Brief description | For more information,
see CommandLine |
|---|
- | Use mouse as ... | Allow the mouse to emulate various controllers | -usemouse |
- | Mouse cursor visibility | Show/hide cursor depending on current state | -cursor |
| Joystick deadzone size | Deadzone area for axes on joysticks/gamepads | -joydeadzone |
- | Paddle dejitter strength | Strenght of paddle input averaging (base) and reaction to fast paddle movements (diff) | -dejitter.base, -dejitter.diff |
+ | (Analog paddle) Sensitivity | Sensitivity of an analog paddle | -psense |
+ | Analog paddle) Dejitter averaging | Strength of paddle input averaging, suppresses mouse jitter | -dejitter.base |
+ | (Analog paddle) Dejitter reaction | Strength of paddle reaction to fast paddle movements, suppresses mouse jitter | -dejitter.diff |
| Digital paddle sensitivity | Sensitivity used when emulating a paddle using a digital device | -dsense |
- | Mouse paddle sensitivity | Sensitivity used when emulating a paddle using a mouse | -msense |
- | Trackball sensitivity | Sensitivity used when emulating a trackball device using a mouse | -tsense |
| Allow all 4 directions ... | Allow all 4 joystick directions to be pressed simultaneously | -joyallow4 |
- | Grab mouse ... | Keep mouse in window in emulation mode
(only when used as controller)
- Note: The sensitivity may greatly vary when the mouse is not grabbed. | -grabmouse |
| Use modifier key combos | Enable using modifier keys in keyboard actions | -modcombo |
| Swap Stelladaptor ports | Swap the order of the detected Stelladaptors/2600-daptors (see Advanced Configuration - Stelladaptor/2600-daptor Support) | -saport |
| Joystick database | Show all joysticks that Stella knows about, with the option to remove them | |
@@ -3148,6 +3207,27 @@
+
+ Mouse settings can be configured under the 'Mouse' tab, shown below:
+
+
+  |
+ |
+
+
+ | Item | Brief description | For more information,
see CommandLine |
|---|
+ | Use mouse as ... | Allow the mouse to emulate various controllers | -usemouse |
+ | (Sensitivity) Paddle | Sensitivity used when emulating a paddle using a mouse | -msense |
+ | (Sensitivity) Trackball | Sensitivity used when emulating a trackball device using a mouse | -tsense |
+ | (Sensitivity) Driving controller | Sensitivity used when emulating a driving controller device using a mouse | -dcsense |
+ | Mouse cursor visibility | Show/hide cursor depending on current state | -cursor |
+ | Grab mouse ... | Keep mouse in window in emulation mode
(only when used as controller)
+ Note: The sensitivity may greatly vary when the mouse is not grabbed. | -grabmouse |
+
+ |
+
+
+
@@ -3233,8 +3313,6 @@
|
-
-
Show only ROM files: Selecting this reloads the current listing,
showing only files that have a valid ROM extension.
@@ -3518,21 +3596,6 @@
'Buffer size'.
-plr.tm.horizon
-dev.tm.horizon |
-
- | When entering/exiting emulation: |
-
- Automatically save no, current or all Time Machine states when exiting emulation.
- The latter also loads all states when entering emulation. When this is enabled, you
- can always continue your game session from where you exited it. Even including the
- Time Machine buffer!
- |
- -saveonexit |
-
- | Automatically change... |
-
- Automatically change to the next available save state slot after saving a ROM state file.
- |
- -autoslot |
@@ -4032,6 +4095,16 @@ Ms Pac-Man (Stella extended codes):
'Console.SwapPorts'. The value must be Yes or No.
+
+ | Controller.PaddlesXCenter: |
+ Defines the horizontal center of the paddles (range -10..30). |
+
+
+
+ | Controller.PaddlesYCenter: |
+ Defines the vertical center of the paddles (range -10..30). |
+
+
| Controller.MouseAxis: |
Indicates how the mouse should emulate virtual controllers.
|