Previous: SDL-specific features, Up: Platform-specific features [Contents][Index]
This section lists the settings and commands that are common and specific to Unix, and are thus not present in other platforms.
GTKBackend
Rendering backend to use for the Gtk3 UI (0: Cairo, 1: OpenGL).
GTKFilter
Rendering filter to use for the Gtk3 UI (0: Nearest neighbor, 1: Bilinear interpolation).
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
RestoreWindowGeometry
Boolean specifying whether to restore an emulator to its last-saved position and size.
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.
DisplayDepth
Integer specifying the depth of the host display. The value ‘0’ (the default) causes the emulator to autodetect it (all emulators except vsid). (0..32)
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).
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).
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).
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).
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).
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).
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.
MIDIInDev
String specifying the MIDI input device (x64, x64sc, xscpu64, x128 and xvic only).
MIDIOutDev
String specifying the MIDI output device (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 (x64, x64sc, xscpu64, x128 and xvic only). (0: OSS, 1: ALSA)
-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
).
-restore-window-geometry
+restore-window-geometry
Restore/ignore Window position(s) and dimension(s) stored in vicerc
(RestoreWindowGeometry=1
, RestoreWindowGeometry=0
).
-aspect <aspect ratio>
Set the aspect ratio
(AspectRatio
).
(0.5-2.0)
-gtkbackend <backend>
Set the Gtk3 rendering backend
(GTKBackend
)
(0: Cairo, 1: OpenGL)
-gtkfilter <filter>
(GTKFilter
)
(0: Nearest neighbor, 1: Bilinear interpolation)
-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
+fullscreen
Enable/disable fullscreen mode
(UseFullscreen=1
, (UseFullscreen=0
)
(all emulators except vsid).
-CRTChwscale
+CRTChwscale
Enable/Disable hardware scaling
(CrtcHwScale=1
, CrtcHwScale=0
)
(xcbm2 and xpet only).
-CRTCfulldevice <device>
Select fullscreen device
(CrtcFullscreenDevice
)
(xcbm2 and xpet only).
-TEDhwscale
+TEDhwscale
Enable/Disable hardware scaling
(TEDHwScale=1
, TEDHwScale=0
)
(xplus4 only).
-TEDfulldevice <device>
Select fullscreen device
(TEDFullscreenDevice
)
(xplus4 only).
-VDChwscale
+VDChwscale
Enable/Disable hardware scaling
(VDCHwScale=1
, VDCHwScale=1
)
(x128 only).
-VIChwscale
+VIChwscale
Enable/Disable hardware scaling
(VICHwScale=1
, VICHwScale=0
)
(xvic only).
-VICfulldevice <device>
Select fullscreen device
(VICFullscreenDevice
)
(xvic only).
-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).
-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.
-midiin <name>
Specify MIDI-In device
(MIDIInDev
)
(x64, x64sc, xscpu64, x128 and xvic only).
-midiout <name>
Specify MIDI-Out device
(MIDIOutDev
)
(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
)
(x64, x64sc, xscpu64, x128 and xvic only).
(0: OSS, 1: ALSA)
Previous: SDL-specific features, Up: Platform-specific features [Contents][Index]