Next: GTK3 specific features, Up: Platform-specific features [Contents][Index]
This section lists the settings and commands that are common and specific to SDL, and are thus not present in other platforms.
HotkeyFile
String specifying the name of the hotkey file (all emulators except vsid).
MenuKey
Integer specifying the keycode for activating the SDL menu.
MenuKeyUp
Integer specifying the keycode for ’up’ in the SDL menu.
MenuKeyDown
Integer specifying the keycode for ’down’ in the SDL menu.
MenuKeyLeft
Integer specifying the keycode for ’left’ in the SDL menu.
MenuKeyRight
Integer specifying the keycode for ’right’ in the SDL menu.
MenuKeyPageUp
Integer specifying the keycode for ’page up’ in the SDL menu.
MenuKeyPageDown
Integer specifying the keycode for ’page down’ in the SDL menu.
MenuKeyHome
Integer specifying the keycode for ’home’ in the SDL menu.
MenuKeyEnd
Integer specifying the keycode for ’end’ in the SDL menu.
MenuKeySelect
Integer specifying the keycode for ’select’ in the SDL menu.
MenuKeyCancel
Integer specifying the keycode for ’cancel’ in the SDL menu.
MenuKeyExit
Integer specifying the keycode for ’exit’ in the SDL menu.
MenuKeyMap
Integer specifying the keycode for ’map’ in the SDL menu.
SaveResourcesOnExit
Boolean specifying whether the emulator should save changed settings before exiting. If this is enabled, the user will be always prompted first, in case the settings have changed.
ConfirmOnExit
Boolean specifying whether to show a confirmation dialog on exit.
PauseOnSettings
Boolean specifying wheter to pause the emulation when triggering the settings dialog. If set, the emulation will pause when triggering the settings dialog. When closing the settings dialog the pause state will revert to its state before triggering the settings UI.
SDLStatusbar
Boolean to enable/disable the statusbar (all emulators except vsid).
SDLBitdepth
Integer specifying the bitdepth used. (0: current, 8, 15, 16, 24, 32)
SDLLimitMode
Integer specifying the resolution limit mode. (0: off, 1: max, 2: fixed)
SDLCustomWidth
Integer specifying the custom resolution width.
SDLCustomHeight
Integer specifying the custom resolution height.
KbdStatusbar
Boolean specifying whether the keyboard-status bar is enabled.
SDL2Renderer
String specifying the preferred SDL2 renderer.
SDLWindowWidth
Integer specifying the SDL window width.
SDLWindowHeight
Integer specifying the SDL window height.
SDLGLFilter
Integer specifying the OpenGL filtering mode.
JoyDevice1
Integer specifying which joystick device the emulator should use for the emulation of joystick 1 (all emulators except xcbm2, xpet and vsid). (0: None, 1: Numpad, 2: Keyset 1, 3: Keyset 2, 4: Joystick (only if joystick support was present in the compile time SDL library))
JoyDevice2
Integer specifying which joystick device the emulator should use for the emulation of joystick 2 (all emulators except xcbm2, xpet, xvic and vsid). (0: None, 1: Numpad, 2: Keyset 1, 3: Keyset 2, 4: Joystick (only if joystick support was present in the compile time SDL library))
JoyDevice3
Integer specifying which joystick device the emulator should use for the emulation of extra joystick 1 (all emulators except xcbm5x0 and vsid). (0: None, 1: Numpad, 2: Keyset 1, 3: Keyset 2, 4: Joystick (only if joystick support was present in the compile time SDL library))
JoyDevice4
Integer specifying which joystick device the emulator should use for the emulation of extra joystick 2 (all emulators except xcbm5x0, xplus4 and vsid). (0: None, 1: Numpad, 2: Keyset 1, 3: Keyset 2, 4: Joystick (only if joystick support was present in the compile time SDL library))
CrtcSDLFullscreenMode
Integer specifying the fullscreen mode (xcbm2 and xpet only).
CrtcHwScale
Boolean specifying whether to enable or disable hardware scaling (xcbm2 and xpet only).
CrtcFullscreenDevice
String specifying the fullscreen device (xcbm2 and xpet only).
CrtcFullscreen
Boolean specifying whether to use fullscreen mode or not (xcbm2 and xpet only).
CrtcFullscreenStatusbar
Boolean specifying whether to show the status bar in fullscreen mode or not (xcbm2 and xpet only).
TEDSDLFullscreenMode
Integer specifying the fullscreen mode (xplus4 only).
TEDHwScale
Boolean specifying whether to enable or disable hardware scaling (xplus4 only).
TEDFullscreenDevice
String specifying the fullscreen device (xplus4 only).
TEDFullscreen
Boolean specifying whether to use fullscreen mode or not (xplus4 only).
TEDFullscreenStatusbar
Boolean specifying whether to show the status bar in fullscreen mode or not (xplus4 only).
VDCSDLFullscreenMode
Integer specifying the fullscreen mode (x128 only).
VDCHwScale
Boolean specifying whether to enable or disable hardware scaling (x128 only).
VDCFullscreenDevice
String specifying the fullscreen device (x128 only).
VDCFullscreen
Boolean specifying whether to use fullscreen mode or not (x128 only).
VDCFullscreenStatusbar
Boolean specifying whether to show the status bar in fullscreen mode or not (x128 only).
VICSDLFullscreenMode
Integer specifying the fullscreen mode (xvic only).
VICHwScale
Boolean specifying whether to enable or disable hardware scaling (xvic only).
VICFullscreenDevice
String specifying the fullscreen device (xvic only).
VICFullscreen
Boolean specifying whether to use fullscreen mode or not (xvic only).
VICFullscreenStatusbar
Boolean specifying whether to show the status bar in fullscreen mode or not (xvic only).
VICIISDLFullscreenMode
Integer specifying the fullscreen mode (all emulators except xcbm2, xpet, xplus4, xvic and vsid).
VICIIHwScale
Boolean specifying whether to enable or disable hardware scaling (all emulators except xcbm2, xpet, xplus4, xvic and vsid).
VICIIFullscreenDevice
String specifying the fullscreen device (all emulators except xcbm2, xpet, xplus4, xvic and vsid).
VICIIFullscreen
Boolean specifying whether to use fullscreen mode or not (all emulators except xcbm2, xpet, xplus4, xvic and vsid).
VICIIFullscreenStatusbar
Boolean specifying whether to show the status bar in fullscreen mode or not (all emulators except xcbm2, xpet, xplus4, xvic and vsid).
The following resources are only present if the OpenGL library is present and used at compile time.
AspectRatio
String/float specifying the aspect ratio. (0.5-2.0)
SDLGLAspectMode
Integer specifying the OpenGL aspect mode. (0: off, 1: custom, 2: true)
SDLGLFlipX
Boolean to enable/disable OpenGL horizontal screen flip.
SDLGLFlipY
Boolean to enable/disable OpenGL vertical screen flip.
The following resources are only present if the SDL library has joystick support at compile time and applies to all emulators except vsid.
JoyMapFile
String specifying the name of the joystick map file.
JoyThreshold
Integer specifying the joystick threshold. (0..32767)
JoyFuzz
Integer specifying the joystick fuzz. (0..32767)
-hotkeyfile <name>
Set the hotkey file name
(HotkeyFile
)
(all emulators except vsid).
-menukey <key>
Set the keycode of the SDL menu activation key
(MenuKey
).
-menukeyup <key>
Set the keycode of the ’up’ key in the SDL menu
(MenuKeyUp
).
-menukeydown <key>
Set the keycode of the ’down’ key in the SDL menu
(MenuKeyDown
).
-menukeyleft <key>
Set the keycode of the ’left’ key in the SDL menu
(MenuKeyLeft
).
-menukeyright <key>
Set the keycode of the ’right’ key in the SDL menu
(MenuKeyRight
).
-menukeypageup <key>
Set the keycode of the ’page up’ key in the SDL menu
(MenuKeyPageUp
).
-menukeypagedown <key>
Set the keycode of the ’page down’ key in the SDL menu
(MenuKeyPageDown
).
-menukeyhome <key>
Set the keycode of the ’home’ key in the SDL menu
(MenuKeyHome
).
-menukeyend <key>
Set the keycode of the ’end’ key in the SDL menu
(MenuKeyEnd
).
-menukeyselect <key>
Set the keycode of the ’select’ key in the SDL menu
(MenuKeySelect
).
-menukeycancel <key>
Set the keycode of the ’cancel’ key in the SDL menu
(MenuKeyCancel
).
-menukeyexit <key>
Set the keycode of the ’exit’ key in the SDL menu
(MenuKeyExit
).
-menukeymap <key>
Set the keycode of the ’map’ key in the SDL menu
(MenuKeyMap
).
-saveres
+saveres
Enable/disable automatic saving of settings on exit
(SaveResourcesOnExit=1
, SaveResourcesOnExit=0
).
-confirmonexit
Confirm quitting VICE
(ConfirmOnExit=1
).
+confirmonexit
Never confirm quitting VICE
(ConfirmOnExit=0
).
-pauseonsettings
Pause emulation when enabling the settings dialog.
(PauseOnSettings=1
).
+pauseonsettings
Do not pause emulation when enabling the settings dialog.
(PauseOnSettings=0
).
-statusbar
+statusbar
Enable/disable the statusbar
(SDLStatusbar=1
, SDLStatusbar=0
)
(all emulators except vsid).
-sdlbitdepth <bpp>
Set the display bitdepth
(SDLBitdepth
).
(0: current, 8, 15, 16, 24, 32)
-sdllimitmode <mode>
Set the resolution limit mode
(SDLLimitMode
).
(0: off, 1: max, 2: fixed)
-sdlcustomw <width>
Set the custom resolution width
(SDLCustomWidth
).
-sdlcustomh <height>
Set the custom resolution height
(SDLCustomHeight
).
-sdlinitialw <width>
Set initial window width.
-sdlinitialh <height>
Set initial window height.
-kbdstatusbar
+kbdstatusbar
Enable/Disable keyboard-status bar (when status bar is enabled)
(KbdStatusbar=1
, KbdStatusbar=0
).
-sdlglfilter <mode>
Set OpenGL filtering mode (0 = nearest, 1 = linear)
(SDLGLFilter
).
-sdl2renderer <renderer name>
Set the preferred SDL2 renderer
(SDL2Renderer
).
-joydev1 <0-3> / <0-4>
Set the device for joystick emulation of port 1
(JoyDevice1
)
(all emulators except xcbm2, xpet and vsid).
(0: None, 1: Numpad, 2: Keyset 1, 3: Keyset 2, 4: Joystick (only if joystick support was present in the compile time SDL library))
-joydev2 <0-3> / <0-4>
Set the device for joystick emulation of port 2
(JoyDevice2
)
(all emulators except xcbm2, xpet, xvic and vsid).
(0: None, 1: Numpad, 2: Keyset 1, 3: Keyset 2, 4: Joystick (only if joystick support was present in the compile time SDL library))
-extrajoydev1 <0-3> / <0-4>
Set device for extra joystick port 1
(JoyDevice3
)
(all emulators except xcbm5x0 and vsid).
(0: None, 1: Numpad, 2: Keyset 1, 3: Keyset 2, 4: Joystick (only if joystick support was present in the compile time SDL library))
-extrajoydev2 <0-3> / <0-4>
Set device for extra joystick port 2
(JoyDevice4
)
(all emulators except xcbm5x0, xplus4 and vsid).
(0: None, 1: Numpad, 2: Keyset 1, 3: Keyset 2, 4: Joystick (only if joystick support was present in the compile time SDL library))
-CRTCSDLfullmode <Mode>
Set the fullscreen mode
(CrtcSDLFullscreenMode
)
(xcbm2 and xpet only).
-CRTChwscale
+CRTChwscale
Enable/Disable hardware scaling
(CrtcHwScale=1
, CrtcHwScale=0
)
(xcbm2 and xpet only).
-CRTCfulldevice <device>
Select fullscreen device
(CrtcFullscreenDevice
)
(xcbm2 and xpet only).
-CRTCfull
+CRTCfull
Enable/Disable fullscreen
(CrtcFullscreen=1
, CrtcFullscreen=0
)
(xcbm2 and xpet only).
-TEDSDLfullmode <Mode>
Set the fullscreen mode
(TEDSDLFullscreenMode
)
(xplus4 only).
-TEDhwscale
+TEDhwscale
Enable/Disable hardware scaling
(TEDHwScale=1
, TEDHwScale=0
)
(xplus4 only).
-TEDfulldevice <device>
Select fullscreen device
(TEDFullscreenDevice
)
(xplus4 only).
-TEDfull
+TEDfull
Enable/Disable fullscreen
(TEDFullscreen=1
, TEDFullscreen=0
)
(xplus4 only).
-VDCSDLfullmode <Mode>
Set the fullscreen mode
(VDCSDLFullscreenMode
)
(x128 only).
-VDChwscale
+VDChwscale
Enable/Disable hardware scaling
(VDCHwScale=1
, VDCHwScale=1
)
(x128 only).
-VDCfulldevice <device>
Select fullscreen device
(VDCFullscreenDevice
)
(x128 only).
-VDCfull
+VDCfull
Enable/Disable fullscreen
(VDCFullscreen=1
, VDCFullscreen=0
)
(x128 only).
-VICSDLfullmode <Mode>
Set the fullscreen mode
(VICSDLFullscreenMode
)
(xvic only).
-VIChwscale
+VIChwscale
Enable/Disable hardware scaling
(VICHwScale=1
, VICHwScale=0
)
(xvic only).
-VICfulldevice <device>
Select fullscreen device
(VICFullscreenDevice
)
(xvic only).
-VICfull
+VICfull
Enable/Disable fullscreen
(VICFullscreen=1
, VICFullscreen=0
)
(xvic only).
-VICIISDLfullmode <Mode>
Set the fullscreen mode
(VICIISDLFullscreenMode
)
(all emulators except xcbm2, xpet, xplus4, xvic and vsid).
-VICIIhwscale
+VICIIhwscale
Enable/Disable hardware scaling
(VICIIHwScale=1
, VICIIHwScale=0
)
(all emulators except xcbm2, xpet, xplus4, xvic and vsid).
-VICIIfulldevice <device>
Select fullscreen device
(VICIIFullscreenDevice
)
(all emulators except xcbm2, xpet, xplus4, xvic and vsid).
-VICIIfull
+VICIIfull
Enable/Disable fullscreen
(VICIIFullscreen=1
, VICIIFullscreen=0
)
(all emulators except xcbm2, xpet, xplus4, xvic and vsid).
The following command-line options are only present if the OpenGL library is present and used at compile time.
-aspect <aspect ratio>
Set the aspect ratio
(AspectRatio
).
(0.5-2.0)
-sdlaspectmode <mode>
Set the aspect mode
(SDLGLAspectMode
).
(0: off, 1: custom, 2: true)
-sdlflipx
+sdlflipx
Enable/disable OpenGL horizontal screen flip
(SDLGLFlipX=1
, SDLGLFlipX=0
).
-sdlflipy
+sdlflipy
Enable/disable OpenGL vertical screen flip
(SDLGLFlipY=1
, SDLGLFlipY=0
).
The following command-line options are only present if the SDL library has joystick support at compile time and applies to all emulators except vsid.
-joymap <name>
Set the joystick map file name
(JoyMapFile
).
-joythreshold <0-32767>
Set the joystick threshold
(JoyThreshold
).
-joyfuzz <0-32767>
Set the joystick fuzz
(JoyFuzz
).
Next: GTK3 specific features, Up: Platform-specific features [Contents][Index]