Go to the first, previous, next, last section, table of contents.


8 Platform-specific features

This section lists the settings and commands that are platform specific.

8.1 SDL-specific features

This section lists the settings and commands that are common and specific to SDL, and are thus not present in other platforms.

8.1.1 SDL specific resources

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 fullscreen resolution width.
SDLCustomHeight
Integer specifying the custom fullscreen resolution height.
KbdStatusbar
Boolean specifying whether the keyboard-status bar is enabled.
SDL2Backend
String specifying the preferred SDL2 backend. (See startup log for available backends, valid ones might be eg: software, opengl, direct3d, direct3d11, opengles2)
Window0Width
Integer specifying the SDL window width.
Window0Height
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))
CrtcFullscreenMode
Integer specifying the fullscreen mode (xcbm2 and xpet only). (0: use desktop resolution, 1: switch to SDLCustomWidth, SDLCustomHeight)
CrtcFullscreen
Boolean specifying whether to use fullscreen mode or not (xcbm2 and xpet only).
TEDFullscreenMode
Integer specifying the fullscreen mode (xplus4 only). (0: use desktop resolution, 1: switch to SDLCustomWidth, SDLCustomHeight)
TEDFullscreen
Boolean specifying whether to use fullscreen mode or not (xplus4 only).
VDCFullscreenMode
Integer specifying the fullscreen mode (x128 only). (0: use desktop resolution, 1: switch to SDLCustomWidth, SDLCustomHeight)
VDCFullscreen
Boolean specifying whether to use fullscreen mode or not (x128 only).
VICFullscreenMode
Integer specifying the fullscreen mode (xvic only). (0: use desktop resolution, 1: switch to SDLCustomWidth, SDLCustomHeight)
VICFullscreen
Boolean specifying whether to use fullscreen mode or not (xvic only).
VICIIFullscreenMode
Integer specifying the fullscreen mode (all emulators except xcbm2, xpet, xplus4, xvic and vsid). (0: use desktop resolution, 1: switch to SDLCustomWidth, SDLCustomHeight)
VICIIFullscreen
Boolean specifying whether to use fullscreen mode or not (all emulators except xcbm2, xpet, xplus4, xvic and vsid).
CrtcShowStatusbar
Boolean specifying whether to show the status bar or not (xcbm2 and xpet only).
TEDShowStatusbar
Boolean specifying whether to show the status bar or not (xplus4 only).
TEDShowStatusbar
Boolean specifying whether to show the status bar or not (x128 only).
VICShowStatusbar
Boolean specifying whether to show the status bar or not (xvic only).
VICIIShowStatusbar
Boolean specifying whether to show the status bar or not (x64, x64sc, x64dtv, xscpu64, x128 and xcbm5x0).

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)
JoyMenuControl
Boolean to enable/disable controlling the SDL menu using a joystick.

8.1.2 SDL specific command-line options

-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 fullscreen resolution width (SDLCustomWidth).
-sdlcustomh <height>
Set the custom fullscreen resolution height (SDLCustomHeight).
-sdlinitialw <width>
Set initial window width.
-sdlinitialh <height>
Set initial window height.
-sdlinitialw1 <width>
Set initial window width for the second window (C128),
-sdlinitialh1 <height>
Set initial window height for the second window (C128),
-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).
-sdl2backend <renderer name>
Set the preferred SDL2 backend (SDL2Backend). See startup log for available backends, valid ones might be eg: software, opengl, direct3d, direct3d11, opengles2)
-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))
-CRTCfullmode <Mode>
Set the fullscreen mode (CrtcFullscreenMode) (xcbm2 and xpet only). (0: use desktop resolution, 1: switch to SDLCustomWidth, SDLCustomHeight)
-CRTCfull
+CRTCfull
Enable/Disable fullscreen (CrtcFullscreen=1, CrtcFullscreen=0) (xcbm2 and xpet only).
-TEDfullmode <Mode>
Set the fullscreen mode (TEDFullscreenMode) (xplus4 only). (0: use desktop resolution, 1: switch to SDLCustomWidth, SDLCustomHeight)
-TEDfull
+TEDfull
Enable/Disable fullscreen (TEDFullscreen=1, TEDFullscreen=0) (xplus4 only).
-VDCfullmode <Mode>
Set the fullscreen mode (VDCFullscreenMode) (x128 only). (0: use desktop resolution, 1: switch to SDLCustomWidth, SDLCustomHeight)
-VDCfull
+VDCfull
Enable/Disable fullscreen (VDCFullscreen=1, VDCFullscreen=0) (x128 only).
-VICfullmode <Mode>
Set the fullscreen mode (VICFullscreenMode) (xvic only). (0: use desktop resolution, 1: switch to SDLCustomWidth, SDLCustomHeight)
-VICfull
+VICfull
Enable/Disable fullscreen (VICFullscreen=1, VICFullscreen=0) (xvic only).
-VICIIfullmode <Mode>
Set the fullscreen mode (VICIIFullscreenMode) (all emulators except xcbm2, xpet, xplus4, xvic and vsid). (0: use desktop resolution, 1: switch to SDLCustomWidth, SDLCustomHeight)
-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).
-joymenucontrol
+joymenucontrol
Enable/disable controlling the SDL menu with a joystick (JoyMenuControl=1, JoyMenuControl=0).

8.2 GTK3 specific features

This section lists the settings and commands that are common and specific to Unix, and are thus not present in other platforms.

8.2.1 GTK3 specific resources

GTKFilter
Rendering filter to use for the Gtk3 UI (0: Nearest neighbor, 1: Bilinear, 2: Bicubic).
AspectRatio
String/float specifying the aspect ratio (0.5-2.0).
KeepAspectRatio
Boolean specifying whether the aspect ratio of the output window should be preserved. (0: free scaling, 1: scale with fixed aspect ratio)
TrueAspectRatio
Boolean specifying whether to use the true (non square pixels) aspect ratio.
VSync
Boolean specifying whether to enable vsync to prevent screen tearing. (0: vsync off, 1: vsync on)
StartMinimized
Boolean specifying whether the emulator should start minimized
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.
FullscreenDecorations
Boolean specifying whether the menu and statusbar are shown in full screen mode.
Window0Width
Window0Height
Window0Xpos
Window0Ypos
Integers specifying the position and size of the (first) emulator window (all emulators except vsid).
Window1Width
Window1Height
Window1Xpos
Window1Ypos
Integers specifying the position and size of the (second) emulator window (x128 only).
CrtcFullscreen
Boolean specifying whether to use fullscreen mode or not (xcbm2 and xpet only).
TEDFullscreen
Boolean specifying whether to use fullscreen mode or not (xplus4 only).
VDCFullscreen
Boolean specifying whether to use fullscreen mode or not (x128 only).
VICFullscreen
Boolean specifying whether to use fullscreen mode or not (xvic only).
VICIIFullscreen
Boolean specifying whether to use fullscreen mode or not (all emulators except xcbm2, xpet, xplus4, xvic and vsid).
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: Analog joystick 1, 5: Analog joystick 2, 6: Analog joystick 3, 7: Analog joystick 4, 8: Analog joystick 5, 9: Analog joystick 6, 10: Digital joystick 1, 11: Digital joystick 2, 12: USB joystick 1, 13: USB joystick 2)
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: Analog joystick 1, 5: Analog joystick 2, 6: Analog joystick 3, 7: Analog joystick 4, 8: Analog joystick 5, 9: Analog joystick 6, 10: Digital joystick 1, 11: Digital joystick 2, 12: USB joystick 1, 13: USB joystick 2)
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: Analog joystick 1, 5: Analog joystick 2, 6: Analog joystick 3, 7: Analog joystick 4, 8: Analog joystick 5, 9: Analog joystick 6, 10: Digital joystick 1, 11: Digital joystick 2, 12: USB joystick 1, 13: USB joystick 2)
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: Analog joystick 1, 5: Analog joystick 2, 6: Analog joystick 3, 7: Analog joystick 4, 8: Analog joystick 5, 9: Analog joystick 6, 10: Digital joystick 1, 11: Digital joystick 2, 12: USB joystick 1, 13: USB joystick 2)

The available joysticks might differ depending on operating system and joystick support in the OS.

Devices 4..9
Only available if joystick support is available at compile time.
Devices 10 and 11
Only available if digital joystick support is available at compile time.
Devices 12 and 13
Only available if USB joystick support is available at compile time.

The following resources are only available if MIDI support is available at compile time.

MIDIName
String specifying the name of the MIDI client (default:"VICE") (ALSA and macOS only, x64, x64sc, xscpu64, x128 and xvic only).
MIDIInDev
String specifying the OSS MIDI input device (Windows and OSS, x64, x64sc, xscpu64, x128 and xvic only).
MIDIOutDev
String specifying the OSS MIDI output device (Windows and OSS, x64, x64sc, xscpu64, x128 and xvic only).
MIDIInName
String specifying the name of the MIDI input port (default:"VICEInput") (macOS only, x64, x64sc, xscpu64, x128 and xvic only).
MIDIOutName
String specifying the name of the MIDI output port (default:"VICEOutput") (macOS only, x64, x64sc, xscpu64, x128 and xvic only).

The following resource is only available if MIDI support and ALSA support is available at compile time.

MIDIDriver
Enum specifying the MIDI driver (Unix - x64, x64sc, xscpu64, x128 and xvic only). (0: OSS, 1: ALSA)

8.2.2 GTK3 specific command-line options

-saveres
+saveres
Enable/disable automatic saving of settings on exit (SaveResourcesOnExit=1, SaveResourcesOnExit=0).
-minimized
+minimized
Start/Do not start with minimized window (StartMinimized=1, StartMinimized=0).
-aspect <aspect ratio>
Set the aspect ratio (AspectRatio). (0.5-2.0)
-gtkfilter <filter>
(GTKFilter) (0: Nearest neighbor, 1: Bilinear 2: Bicubic).
-keepaspect
Enable keeping of the aspect ratio when scaling (KeepAspectRatio=1).
+keepaspect
Disable keeping of the aspect ratio when scaling (freescaling) (KeepAspectRatio=0).
-trueaspect
+trueaspect
Enable/disable whether to use the true (non square pixels) aspect ratio (TrueAspectRatio=1, (TrueAspectRatio=0).
-vsync
Enable vsync to prevent screen tearing (VSync=1).
+vsync
Disable vsync to allow screen tearing (VSync=0).
-confirmonexit
Confirm quitting VICE (ConfirmOnExit=1).
+confirmonexit
Never confirm quitting VICE (ConfirmOnExit=0).
-fullscreen-decorations
+fullscreen-decorations
Enable/disable fullscreen decorations
-joydev1 <0-3> / <0-9> / <0-11> / <0-13>
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: Analog joystick 1, 5: Analog joystick 2, 6: Analog joystick 3, 7: Analog joystick 4, 8: Analog joystick 5, 9: Analog joystick 6, 10: Digital joystick 1, 11: Digital joystick 2, 12: USB joystick 1, 13: USB joystick 2)
-joydev2 <0-3> / <0-9> / <0-11> / <0-13>
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: Analog joystick 1, 5: Analog joystick 2, 6: Analog joystick 3, 7: Analog joystick 4, 8: Analog joystick 5, 9: Analog joystick 6, 10: Digital joystick 1, 11: Digital joystick 2, 12: USB joystick 1, 13: USB joystick 2)
-extrajoydev1 <0-3> / <0-9> / <0-11> / <0-13>
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: Analog joystick 1, 5: Analog joystick 2, 6: Analog joystick 3, 7: Analog joystick 4, 8: Analog joystick 5, 9: Analog joystick 6, 10: Digital joystick 1, 11: Digital joystick 2, 12: USB joystick 1, 13: USB joystick 2)
-extrajoydev2 <0-3> / <0-9> / <0-11> / <0-13>
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: Analog joystick 1, 5: Analog joystick 2, 6: Analog joystick 3, 7: Analog joystick 4, 8: Analog joystick 5, 9: Analog joystick 6, 10: Digital joystick 1, 11: Digital joystick 2, 12: USB joystick 1, 13: USB joystick 2)

The available joysticks might differ depending on operating system and joystick support in the OS.

Devices 4..9
Only available if joystick support is available at compile time.
Devices 10 and 11
Only available if digital joystick support is available at compile time.
Devices 12 and 13
Only available if USB joystick support is available at compile time.

The following command-line options are only available if MIDI support is available at compile time.

-midiname <name>
Specify the name of the MIDI client (default:"VICE") (MIDIName) (ALSA and macOS only, x64, x64sc, xscpu64, x128 and xvic only).
-midiin <name>
Specify OSS MIDI-In device (MIDIInDev) (Windows and OSS, x64, x64sc, xscpu64, x128 and xvic only).
-midiout <name>
Specify OSS MIDI-Out device (MIDIOutDev) (Windows and OSS, x64, x64sc, xscpu64, x128 and xvic only).
-midiinname <name>
Specify the name of the MIDI input port (default:"VICEInput") (MIDIInName) (macos, x64, x64sc, xscpu64, x128 and xvic only).
-midioutname <name>
Specify the name of the MIDI output port (default:"VICEOutput") (MIDIOutName) (macos, x64, x64sc, xscpu64, x128 and xvic only).

The following command-line option is only available if MIDI support and ALSA support is available at compile time.

-mididrv <driver>
Specify MIDI driver (MIDIDriver) (Unix - x64, x64sc, xscpu64, x128 and xvic only). (0: OSS, 1: ALSA)


Go to the first, previous, next, last section, table of contents.