VICE Manual - 8 Platform-specific features

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 AmigaOS-specific features

This section lists the settings and commands that are common and specific to all Amiga based platforms (this includes AmigaOS3, AmigaOS4, Morphos and AROS), and are thus not present in other platforms.

### 8.1.1 Amiga (AmigaOS3/AmigaOS4/MorphOS/AROS) specific resources

`InitialDefaultDir`
  String specifying the initial default directory, which is used by the generic file browser dialog.
`InitialTapeDir`
  String specifying the initial tape directory, which is used by the tape image file browser dialog (all emulators except xscpu64, x64dtv and vsid).
`InitialDiskDir`
  String specifying the initial tape directory, which is used by the disk image file browser dialog (all emulators except vsid).
`InitialAutostartDir`
  String specifying the initial autostart directory, which is used by the autostart image file browser dialog (all emulators except vsid).
`InitialCartDir`
  String specifying the initial cartridge directory, which is used by the cartridge image file browser dialog (all emulators except x64dtv and vsid).
`InitialSnapshotDir`
  String specifying the initial snapshots directory, which is used by the snapshots file browser dialog (all emulators except vsid).
`FullscreenEnabled`
  Boolean to enable/disable fullscreen mode.
`StatusBarEnabled`
  Boolean to enable/disable the statusbar.
`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.

### 8.1.2 Amiga (AmigaOS3/AmigaOS4/MorphOS/AROS) specific command-line options

`-initialdefaultdir <Name>`
  Select the initial default directory for the file browser dialog (`InitialDefaultDir`).
`-initialtapedir <Name>`
  Select the initial tape images directory for the file browser dialog (`InitialTapeDir`) (all emulators except xscpu64, x64dtv and vsid).
`-initialdiskdir <Name>`
  Select the initial disk images directory for the file browser dialog (`InitialDiskDir`) (all emulators except vsid).
`-initialautostartdir <Name>`
  Select the initial autostart directory for the file browser dialog (`InitialAutostartDir`) (all emulators except vsid).
`-initialcartdir <Name>`
  Select the initial cartridge images directory for the file browser dialog (`InitialCartDir`) (all emulators except x64dtv and vsid).
`-initialsnapshotdir <Name>`
  Select the initial snapshot directory for the file browser dialog (`InitialSnapshotDir`) (all emulators except vsid).
`-fullscreen`
`+fullscreen`
  Enable/disable fullscreen mode (`FullscreenEnabled=1`, `FullscreenEnabled=0`).
`-statusbar`
`+statusbar`
  Enable/Disable the statusbar (`StatusBarEnabled=1`, `StatusBarEnabled=0`).
`-saveres`
`+saveres`
  Enable/disable automatic saving of settings on exit (`SaveResourcesOnExit=1`, `SaveResourcesOnExit=0`).
`-confirmexit`
  Confirm quitting VICE (`ConfirmOnExit=1`).
`+confirmexit`
  Never confirm quitting VICE (`ConfirmOnExit=0`).

### 8.1.3 AmigaOS3-specific features

This section lists the settings and commands that are common and specific to AmigaOS3, and are thus not present in other platforms. The AmigaOS3 port uses the AHI sound system, the CGX or P96 graphics system, the LowLevel input system, the MUI GUI system, and optionally the OpenPCI library for access to expansion cards like Catweasel or HardSID. Please note that access to the Catweasel can also be done using catweaselsid.device.

#### 8.1.3.1 AmigaOS3 specific resources

`JoyFire1`
  Integer specifying the code of the button to use for fire for the emulation of joystick 1 (all emulators except xcbm2, xpet and vsid).
`JoyFire2`
  Integer specifying the code of the button to use for fire for the emulation of joystick 2 (all emulators except xcbm2, xpet, xvic and vsid).
`JoyFire3`
  Integer specifying the code of the button to use for fire for the emulation of extra joystick 1 (all emulators except xcbm5x0 and vsid).
`JoyFire4`
  Integer specifying the code of the button to use for fire for the emulation of extra joystick 2 (all emulators except xcbm5x0, xplus4 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: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`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: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`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: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`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: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)

The following resource is only present if the CGX video system is present and used at compile time, and cgxvideo.library is present at runtime.

`VideoOverlayEnabled`
  Boolean to enable/disable video overlay mode.

#### 8.1.3.2 AmigaOS3 specific command-line options

`-joydev1 <0-5>`
  Set the device for joystick emulation of port 1 (`JoyDevice1`) (all emulators except xcbm2, xpet and vsid). (0: None, 1: Numpad, 2: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`-joydev2 <0-5>`
  Set the device for joystick emulation of port 2 (`JoyDevice2`) (all emulators except xcbm2, xpet, xvic and vsid). (0: None, 1: Numpad, 2: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`-extrajoydev1 <0-5>`
  Set device for extra joystick port 1 (`JoyDevice3`) (all emulators except xcbm5x0 and vsid). (0: None, 1: Numpad, 2: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`-extrajoydev2 <0-5>`
  Set device for extra joystick port 2 (`JoyDevice4`) (all emulators except xcbm5x0, xplus4 and vsid). (0: None, 1: Numpad, 2: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)

The following command-line option is only present if the CGX video system is present and used at compile time, and cgxvideo.library is present at runtime.

`-videooverlay`
`+videooverlay`
  Enable/Disable video overlay mode (`VideoOverlayEnabled=1`, `VideoOverlayEnabled=0`).

### 8.1.4 AmigaOS4-specific features

This section lists the settings and commands that are common and specific to AmigaOS4, and are thus not present in other platforms. The AmigaOS4 port uses the AHI sound system, the P96 graphics system, the AmigaInput input system, the MUI GUI system, and optionally the expansion library for access to expansion cards like Catweasel or HardSID.

#### 8.1.4.1 AmigaOS4 specific resources

These are all generic joystick related resources and are therefor present in all emulators except vsid.

`JOYAI1_ID`
  String specifying the AmigaInput ID of hardware joystick 1.
`JOYAI2_ID`
  String specifying the AmigaInput ID of hardware joystick 2.
`JOYAI1_Up`
  String specifying the AmigaInput event ID for the up direction of hardware joystick 1.
`JOYAI2_Up`
  String specifying the AmigaInput event ID for the up direction of hardware joystick 2.
`JOYAI1_Down`
  String specifying the AmigaInput event ID for the down direction of hardware joystick 1.
`JOYAI2_Down`
  String specifying the AmigaInput event ID for the down direction of hardware joystick 2.
`JOYAI1_Left`
  String specifying the AmigaInput event ID for the left direction of hardware joystick 1.
`JOYAI2_Left`
  String specifying the AmigaInput event ID for the left direction of hardware joystick 2.
`JOYAI1_Right`
  String specifying the AmigaInput event ID for the right direction of hardware joystick 1.
`JOYAI2_Right`
  String specifying the AmigaInput event ID for the right direction of hardware joystick 2.
`JOYAI1_Fire`
  String specifying the AmigaInput event ID for the fire button of hardware joystick 1.
`JOYAI2_Fire`
  String specifying the AmigaInput event ID for the fire button of hardware joystick 2.

`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/AI, 3: Keyset 2/AI)
`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/AI, 3: Keyset 2/AI)
`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/AI, 3: Keyset 2/AI)
`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/AI, 3: Keyset 2/AI)

#### 8.1.4.2 AmigaOS4 specific command-line options

`-joydev1 <0-3>`
  Set the device for joystick emulation of port 1 (`JoyDevice1`) (all emulators except xcbm2, xpet and vsid). (0: None, 1: Numpad, 2: Keyset 1/AI, 3: Keyset 2/AI)
`-joydev2 <0-3>`
  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/AI, 3: Keyset 2/AI)
`-extrajoydev1 <0-3>`
  Set device for extra joystick port 1 (`JoyDevice3`) (all emulators except xcbm5x0 and vsid). (0: None, 1: Numpad, 2: Keyset 1/AI, 3: Keyset 2/AI)
`-extrajoydev2 <0-3>`
  Set device for extra joystick port 2 (`JoyDevice4`) (all emulators except xcbm5x0, xplus4 and vsid). (0: None, 1: Numpad, 2: Keyset 1/AI, 3: Keyset 2/AI)

### 8.1.5 MorphOS-specific features

This section lists the settings and commands that are common and specific to MorphOS, and are thus not present in other platforms. The MorphOS port uses the AHI or SDL sound system, the CGX graphics system, the LowLevel input system, the MUI GUI system, and optionally the OpenPCI library for access to expansion cards like Catweasel or HardSID. Please note that access to the Catweasel can also be done using catweaselsid.device.

#### 8.1.5.1 MorphOS specific resources

`JoyFire1`
  Integer specifying the code of the button to use for fire for the emulation of joystick 1 (all emulators except xcbm2, xpet and vsid).
`JoyFire2`
  Integer specifying the code of the button to use for fire for the emulation of joystick 2 (all emulators except xcbm2, xpet, xvic and vsid).
`JoyFire3`
  Integer specifying the code of the button to use for fire for the emulation of extra joystick 1 (all emulators except xcbm5x0 and vsid).
`JoyFire4`
  Integer specifying the code of the button to use for fire for the emulation of extra joystick 2 (all emulators except xcbm5x0, xplus4 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: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`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: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`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: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`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: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)

The following resource is only present if the CGX video system is present and used at compile time, and cgxvideo.library is present at runtime.

`VideoOverlayEnabled`
  Boolean to enable/disable video overlay mode.

#### 8.1.5.2 MorphOS specific command-line options

`-joydev1 <0-5>`
  Set the device for joystick emulation of port 1 (`JoyDevice1`) (all emulators except xcbm2, xpet and vsid). (0: None, 1: Numpad, 2: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`-joydev2 <0-5>`
  Set the device for joystick emulation of port 2 (`JoyDevice2`) (all emulators except xcbm2, xpet, xvic and vsid). (0: None, 1: Numpad, 2: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`-extrajoydev1 <0-5>`
  Set device for extra joystick port 1 (`JoyDevice3`) (all emulators except xcbm5x0 and vsid). (0: None, 1: Numpad, 2: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`-extrajoydev2 <0-5>`
  Set device for extra joystick port 2 (`JoyDevice4`) (all emulators except xcbm5x0, xplus4 and vsid). (0: None, 1: Numpad, 2: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)

The following command-line option is only present if the CGX video system is present and used at compile time, and cgxvideo.library is present at runtime.

`-videooverlay`
`+videooverlay`
  Enable/Disable video overlay mode (`VideoOverlayEnabled=1`, `VideoOverlayEnabled=0`).

### 8.1.6 AROS-specific features

This section lists the settings and commands that are common and specific to AROS, and are thus not present in other platforms. The AROS port uses the AHI or SDL sound system, the CGX graphics system, the LowLevel input system, the MUI GUI system.

#### 8.1.6.1 AROS specific resources

`JoyFire1`
  Integer specifying the code of the button to use for fire for the emulation of joystick 1 (all emulators except xcbm2, xpet and vsid).
`JoyFire2`
  Integer specifying the code of the button to use for fire for the emulation of joystick 2 (all emulators except xcbm2, xpet, xvic and vsid).
`JoyFire3`
  Integer specifying the code of the button to use for fire for the emulation of extra joystick 1 (all emulators except xcbm5x0 and vsid).
`JoyFire4`
  Integer specifying the code of the button to use for fire for the emulation of extra joystick 2 (all emulators except xcbm5x0, xplus4 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: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`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: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`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: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`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: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)

The following resource is only present if the CGX video system is present and used at compile time, and cgxvideo.library is present at runtime.

`VideoOverlayEnabled`
  Boolean to enable/disable video overlay mode.

#### 8.1.6.2 AROS specific command-line options

`-joydev1 <0-5>`
  Set the device for joystick emulation of port 1 (`JoyDevice1`) (all emulators except xcbm2, xpet and vsid). (0: None, 1: Numpad, 2: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`-joydev2 <0-5>`
  Set the device for joystick emulation of port 2 (`JoyDevice2`) (all emulators except xcbm2, xpet, xvic and vsid). (0: None, 1: Numpad, 2: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`-extrajoydev1 <0-5>`
  Set device for extra joystick port 1 (`JoyDevice3`) (all emulators except xcbm5x0 and vsid). (0: None, 1: Numpad, 2: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)
`-extrajoydev2 <0-5>`
  Set device for extra joystick port 2 (`JoyDevice4`) (all emulators except xcbm5x0, xplus4 and vsid). (0: None, 1: Numpad, 2: Joy0, 3: Joy1, 4: Joy2, 5: Joy3)

The following command-line option is only present if the CGX video system is present and used at compile time, and cgxvideo.library is present at runtime.

`-videooverlay`
`+videooverlay`
  Enable/Disable video overlay mode (`VideoOverlayEnabled=1`, `VideoOverlayEnabled=0`).

## 8.2 BeOS-specific features

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

### 8.2.1 BeOS specific resources

`JoystickDisplay`
  Boolean to enable/disable displaying the joystick status in the emulator window.
`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.
`DirectWindow`
  Boolean specifying whether to use the BeOS DirectWindow API.
`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..19: Hardware joysticks)
`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..19: Hardware joysticks)
`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..19: Hardware joysticks)
`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..19: Hardware joysticks)

### 8.2.2 BeOS specific command-line options

`-joydisplay`
`+joydisplay`
  Enable/Disable joystick display. (`JoystickDisplay=1`, `JoystickDisplay=0`).
`-saveres`
`+saveres`
  Enable/disable automatic saving of settings on exit (`SaveResourcesOnExit=1`, `SaveResourcesOnExit=0`).
`-confirmexit`
  Confirm quitting VICE (`ConfirmOnExit=1`).
`+confirmexit`
  Never confirm quitting VICE (`ConfirmOnExit=0`).
`-directwindow`
`+directwindow`
  Enable/disable usage of the BeOS DirectWindow API (`DirectWindow=1`, `DirectWindow=0`).
`-joydev1 <0-19>`
  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..19: Hardware joysticks)
`-joydev2 <0-19>`
  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..19: Hardware joysticks)
`-extrajoydev1 <0-19>`
  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..19: Hardware joysticks)
`-extrajoydev2 <0-19>`
  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..19: Hardware joysticks)

## 8.3 DOS-specific features

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

### 8.3.1 DOS joystick hardware types

Here is a list of joystick hardware types that are supported

`JOY_TYPE_AUTODETECT (0xFFFFFFFF, "auto")`
  Attempts to autodetect your joystick hardware. It isn't possible to reliably distinguish between all the possible input setups, so this routine can only ever choose the standard joystick, Sidewider, GamePad Pro, or GrIP drivers.
`JOY_TYPE_NONE (0x00000000, "none")`
  Dummy driver for machines without any joystick.
`JOY_TYPE_STANDARD (0x53544420, "standard")`
  A normal two button stick.
`JOY_TYPE_2PADS (0x32504144, "dual")`
  Dual joystick mode (two sticks, each with two buttons).
`JOY_TYPE_4BUTTON (0x34425554, "4button")`
  Enable the extra buttons on a 4-button joystick.
`JOY_TYPE_6BUTTON (0x36425554, "6button")`
  Enable the extra buttons on a 6-button joystick.
`JOY_TYPE_8BUTTON (0x38425554, "8button")`
  Enable the extra buttons on an 8-button joystick.
`JOY_TYPE_FSPRO (0x4650524F, "fspro")`
  CH Flightstick Pro or compatible stick, which provides four buttons, an analogue throttle control, and a 4-direction coolie hat.
`JOY_TYPE_WINGEX (0x57494E47, "wingex")`
  A Logitech Wingman Extreme, which should also work with any Thrustmaster Mk.I compatible joystick. It provides support for four buttons and a coolie hat. This also works with the Wingman Warrior, if you plug in the 15 pin plug (remember to unplug the 9-pin plug!) and set the tiny switch in front to the "H" position (you will not be able to use the throttle or the spinner though).
`JOY_TYPE_SIDEWINDER (0x53572020, "sidewinder")`
  The Microsoft Sidewinder digital pad (supports up to four controllers, each with ten buttons and a digital direction control).
`JOY_TYPE_SIDEWINDER_AG (0x53574147, "sidewinderag")`
  An alternative driver to JOY_TYPE_SIDEWINDER. Try this if your Sidewinder isn't recognized with JOY_TYPE_SIDEWINDER.
`JOY_TYPE_SIDEWINDER_PP (0x53575050, "sidewinderpp")`
  The Microsoft Sidewinder 3D/Precision/Force Feedback Pro joysticks.
`JOY_TYPE_GAMEPAD_PRO (0x4750524F, "gamepadpro")`
  The Gravis GamePad Pro (supports up to two controllers, each with ten buttons and a digital direction control).
`JOY_TYPE_GRIP (0x47524950, "grip")`
  Gravis GrIP driver, using the grip.gll driver file.
`JOY_TYPE_GRIP4 (0x47524934, "grip4")`
  Version of the Gravis GrIP driver that is constrained to only move along the four main axes.
`JOY_TYPE_SNESPAD_LPT1 (0x534E4531, "sneslpt1")`
`JOY_TYPE_SNESPAD_LPT2 (0x534E4532, "sneslpt2")`
`JOY_TYPE_SNESPAD_LPT3 (0x534E4533, "sneslpt3")`
  SNES joypads connected to LPT1, LPT2 and LPT3 respectively.
`JOY_TYPE_PSXPAD_LPT1 (0x50535831, "psxlpt1")`
`JOY_TYPE_PSXPAD_LPT2 (0x50535832, "psxlpt2")`
`JOY_TYPE_PSXPAD_LPT3 (0x50535833, "psxlpt3")`
  PSX joypads connected to LPT1, LPT2 and LPT3 respectively. See http://www.ziplabel.com/dpadpro/index.html for information about the parallel cable required. The driver automagically detects which types of PSX pads are connected out of digital, analog (red or green mode), NegCon, multi taps, Namco light guns, Jogcons (force feedback steering wheel) and the mouse. If the controller isn't recognised it is treated as an analog controller, meaning the driver should work with just about anything. You can connect controllers in any way you see fit, but only the first 8 will be used. The Sony Dual Shock or Namco Jogcon will reset themselves (to digital mode) after not being polled for 5 seconds. This is normal, the same thing happens on a Playstation, it's designed to stop any vibration in case the host machine crashes. Other mode switching controllers may have similar quirks. However, if this happens to a Jogcon controller the mode button is disabled. To reenable the mode button on the Jogcon you need to hold down the Start and Select buttons at the same time. The G-con45 needs to be connected to (and pointed at) a TV type monitor connected to your computer.
`JOY_TYPE_N64PAD_LPT1 (0x4E363431, "n64lpt1")`
`JOY_TYPE_N64PAD_LPT2 (0x4E363432, "n64lpt2")`
`JOY_TYPE_N64PAD_LPT3 (0x4E363433, "n64lpt3")`
  N64 joypads connected to LPT1, LPT2 and LPT3 respectively. See http://www.st-hans.de/N64.htm for information about the necessary hardware adapter. It supports up to four controllers on a single parallel port. There is no need to calibrate the analog stick, as this is done by the controller itself when powered up. This means that the stick has to be centred when the controller is initialised. One possible issue people may have with this driver is that it is physically impossible to move the analog stick fully diagonal, but I can't see this causing any major problems. This is because of the shape of the rim that the analog stick rests against. Like the Gravis Game Pad Pro, this driver briefly needs to disable hardware interrupts while polling. This causes a noticeable performance hit on my machine in both drivers, but there is no way around it.
`JOY_TYPE_DB9_LPT1 (0x44423931, "db9lpt1")`
`JOY_TYPE_DB9_LPT1 (0x44423932, "db9lpt2")`
`JOY_TYPE_DB9_LPT3 (0x44423933, "db9lpt3")`
  A pair of two-button joysticks connected to LPT1, LPT2 and LPT3 respectively. Port 1 is compatible with Linux joy-db9 driver (multisystem 2-button), and port 2 is compatible with Atari interface for DirectPad Pro. See the source file (src/dos/multijoy.c) for pinout information.
`JOY_TYPE_TURBOGRAFX_LPT1 (0x54475831, "tgxlpt1")`
`JOY_TYPE_TURBOGRAFX_LPT2 (0x54475832, "tgxlpt2")`
`JOY_TYPE_TURBOGRAFX_LPT3 (0x54475833, "tgxlpt3")`
  These drivers support up to 7 joysticks, each one with up to 5 buttons, connected to LPT1, LPT2, and LPT3 respectively. They use the TurboGraFX interface by Steffen Schwenke: see http://www.burg-halle.de/~schwenke/parport.html for details on how to build this.
`JOY_TYPE_WINGWARRIOR (0x57574152, "wingwar")`
  A Wingman Warrior joystick.
`JOY_TYPE_IFSEGA_ISA (0x53454749, "ifsegaisa")`
`JOY_TYPE_IFSEGA_PCI (0x53454750, "ifsegapci")`
`JOY_TYPE_IFSEGA_PCI_FAST (0x53475046, "ifsegapcifast")`
  Drivers for the IF-SEGA joystick interface cards by the IO-DATA company (these come in PCI, PCI2, and ISA variants).

### 8.3.2 DOS specific resources

`UseLeds`
  Boolean to enable/disable using the keyboard leds for status display.
`ShowStatusbar`
  Integer specifying the mode of the statusbar. (0: Off, 1: On, 2: Auto)
`VGAMode`
  Integer specifying the VGA mode. (0: 320x200x8, 1: 360x240x8, 2: 360x270x8, 3: 376x282x8, 4: 400x300x8, 5: 640x480x8, 6: 800x600x8, 7: 1024x768x8, 8: 320x200x16, 9: 400x300x16, 10: 640x480x16, 11: 800x600x16, 12: 1024x768x16, 13: 640x480x32, 14: 800x600x32, 15: 1024x768x32)
`HwJoyType`
  Integer specifying the hardware type of the joystick (all emulators except vsid). See `'DOS joystick hardware types'` for the types.
`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 1, 5: 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: Joystick 1, 5: 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: Joystick 1, 5: 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: Joystick 1, 5: Joystick 2)

The following resource is only available if the midas sound driver is not used during compile time.

`TripleBuffering`
  Boolean to enable/disable triple buffering if possible.

### 8.3.3 DOS specific command-line options

`-leds`
`+leds`
  Enable/disable usage of keyboard leds (`UseLeds=1`, `UseLeds=0`).
`-statusbar <Mode>`
  Set the statusbar mode (`ShowStatusbar`). (0: Off, 1: On, 2: Auto)
`-vgamode <Mode>`
  Set the VGA mode (`VGAMode`). (0: 320x200x8, 1: 360x240x8, 2: 360x270x8, 3: 376x282x8, 4: 400x300x8, 5: 640x480x8, 6: 800x600x8, 7: 1024x768x8, 8: 320x200x16, 9: 400x300x16, 10: 640x480x16, 11: 800x600x16, 12: 1024x768x16, 13: 640x480x32, 14: 800x600x32, 15: 1024x768x32)
`-joyhwtype <type>`
  Set the joystick hardware type (`HwJoyType`) (all emulators except vsid). See `DOS joystick hardware types` for the types.
`-joydev1 <0-5>`
  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 1, 5: Joystick 2)
`-joydev2 <0-5>`
  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 1, 5: Joystick 2)
`-extrajoydev1 <0-5>`
  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 1, 5: Joystick 2)
`-extrajoydev2 <0-5>`
  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 1, 5: Joystick 2)

The following command-line option is only available if the midas sound driver is not used during compile time.

`-triplebuf`
`+triplebuf`
  Enable/Disable triple buffering (`TripleBuffering=1`, `TripleBuffering=0`).

## 8.4 OS2-specific features

## 8.5 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.5.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.
`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.
`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.
`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)

The following resource is only present if compiling for native dingoo.

`OverClock`
  Boolean to enable/disable overclocking.

### 8.5.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' in the SDL menu (`MenuKeyUp`).
`-menukeydown <key>`
  Set the keycode of the 'down' in the SDL menu (`MenuKeyDown`).
`-menukeyleft <key>`
  Set the keycode of the 'left' in the SDL menu (`MenuKeyLeft`).
`-menukeyright <key>`
  Set the keycode of the 'right' in the SDL menu (`MenuKeyRight`).
`-menukeyselect <key>`
  Set the keycode of the 'select' in the SDL menu (`MenuKeySelect`).
`-menukeycancel <key>`
  Set the keycode of the 'cancel' in the SDL menu (`MenuKeyCancel`).
`-menukeyexit <key>`
  Set the keycode of the 'exit' in the SDL menu (`MenuKeyExit`).
`-menukeymap <key>`
  Set the keycode of the 'map' in the SDL menu (`MenuKeyMap`).
`-saveres`
`+saveres`
  Enable/disable automatic saving of settings on exit (`SaveResourcesOnExit=1`, `SaveResourcesOnExit=0`).
`-confirmexit`
  Confirm quitting VICE (`ConfirmOnExit=1`).
`+confirmexit`
  Never confirm quitting VICE (`ConfirmOnExit=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`).
`-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`).

## 8.6 Unix-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.6.1 Unix specific resources

`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.
`HTMLBrowserCommand`
  String specifying the command to run the help browser. The help browser can be any HTML browser, and every ``%s'` in the string is replaced with the name of the toplevel file of the VICE documentation. For example, the default value ``netscape %s'` runs Netscape Navigator.
`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)

The following resources are only available if RS232 device support or RS232 network support is available at compile time.

`RsDevice1Baud`
`RsDevice2Baud`
`RsDevice3Baud`
`RsDevice4Baud`
  Integers specifying the RS232 baudrate devices if the device file points to a special device (like ``/dev/ttyS0'`; see section 6.12 RS232 settings) (all emulators except vsid).

### 8.6.2 Unix specific command-line options

`-saveres`
`+saveres`
  Enable/disable automatic saving of settings on exit (`SaveResourcesOnExit=1`, `SaveResourcesOnExit=0`).
`-confirmexit`
  Confirm quitting VICE (`ConfirmOnExit=1`).
`+confirmexit`
  Never confirm quitting VICE (`ConfirmOnExit=0`).
`-htmlbrowser <Command>`
  Specify the command to run the HTML browser for the on-line help (`HTMLBrowserCommand`).
`-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)

The following command-line options are only available if RS232 device support or RS232 network support is available at compile time.

`-rsdev1baud <baudrate>`
`-rsdev2baud <baudrate>`
`-rsdev3baud <baudrate>`
`-rsdev4baud <baudrate>`
  Specify <baudrate> as baudrate for the RS232 devices if the device name specifies a special device (like ``/dev/ttyS0'` for example, see section 6.12 RS232 settings; `RsDevice1Baud`, `RsDevice2Baud` `RsDevice3Baud` and `RsDevice4Baud`) (all emulators except vsid).

### 8.6.3 XAW-specific features

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

#### 8.6.3.1 XAW GUI specific resources

`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)
`PrivateColormap`
  Boolean specifying whether VICE should install a private colormap at startup. This only makes sense for 8-bit displays that could run out of colors if other color-hungry applications are running at the same time (all emulators except vsid).
`UseXSync`
  Boolean specifying whether `XSync()` is called after updating the emulation window.
`MITSHM`
  Integer specifying whether VICE should try to use the shared memory extensions (MITSHM) when starting up. The shared memory extensions make things a lot faster but might not be available on your system. You will not be able to use these extensions if you are sitting at an X terminal while running the emulator on a remote machine across a network. Valid values are: 0 = do not use MITSHM, 1 = do use MITSHM, -1 = try to autodetect availability on startup (default). The last is a simple test if the emulator runs across a network and if so disables MITSHM (If you have problems with this test please report it). (-1: auto, 1: off, 2: on)
`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).

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

`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.
`FOURCC`
  String specifying the YUV FOURCC format to use.

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

`UseFullscreen`
  Boolean specifying whether fullscreen mode is currently in use (all emulators except vsid).
`CrtcXRANDRFullscreenMode`
  integer specifying XRANDR fullscreen mode (xcbm2 and xpet only).
`TEDXRANDRFullscreenMode`
  integer specifying XRANDR fullscreen mode (xplus4 only).
`VDCXRANDRFullscreenMode`
  integer specifying XRANDR fullscreen mode (x128 only).
`VICXRANDRFullscreenMode`
  integer specifying XRANDR fullscreen mode (xvic only).
`VICIIXRANDRFullscreenMode`
  integer specifying XRANDR fullscreen mode (all emulators except xcbm2, xpet, xplus4, xvic and vsid).

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

`UseFullscreen`
  Boolean specifying whether fullscreen mode is currently in use.
`CrtcVidmodeFullscreenMode`
  integer specifying VidMode fullscreen mode (xcbm2 and xpet only).
`TEDVidmodeFullscreenMode`
  integer specifying VidMode fullscreen mode (xplus4 only).
`VDCVidmodeFullscreenMode`
  integer specifying VidMode fullscreen mode (x128 only).
`VICVidmodeFullscreenMode`
  integer specifying VidMode fullscreen mode (xvic only).
`VICIIVidmodeFullscreenMode`
  integer specifying VidMode fullscreen mode (all emulators except xcbm2, xpet, xplus4, xvic and vsid).

#### 8.6.3.2 XAW GUI specific command-line options

`-displaydepth <value>`
  Specify the display depth (`DisplayDepth`) (all emulators except vsid). (0..32)
`-colormap`
`+colormap`
  Enable/disable installation of a private colormap (`PrivateColormap=1`, `PrivateColormap=0`) (all emulators except vsid).
`-xsync`
`+xsync`
  Enable/disable usage of `XSync()` when updating the emulation window (`UseXSync=1`, `UseXSync=0`).
`-mitshm`
`+mitshm`
  Enable/disable usage of the MITSHM extensions (`MITSHM=1`, `MITSHM=0`).

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

`-aspect <aspect ratio>`
  Set the aspect ratio (`AspectRatio`). (0.5-2.0)
`-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`).
`-fourcc <fourcc>`
  Set the YUV FOURCC format to use (`FOURCC`).

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

`-fullscreen`
`+fullscreen`
  Enable/disable fullscreen mode (`UseFullscreen=1`, (`UseFullscreen=0`) (all emulators except vsid).
`-CrtcXRANDRfullmode <mode>`
  Select fullscreen mode (`CrtcXRANDRFullscreenMode`). (xcbm2 and xpet only)
`-TEDXRANDRfullmode <mode>`
  Select fullscreen mode (`TEDXRANDRFullscreenMode`). (xplus4 only)
`-VDCXRANDRfullmode <mode>`
  Select fullscreen mode (`VDCXRANDRFullscreenMode`). (x128 only)
`-VICXRANDRfullmode <mode>`
  Select fullscreen mode (`VICXRANDRFullscreenMode`). (xvic only)
`-VICIIXRANDRfullmode <mode>`
  Select fullscreen mode (`VICIIXRANDRFullscreenMode`). (all emulators except xcbm2, xpet, xplus4, xvic and vsid)

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

`-fullscreen`
`+fullscreen`
  Enable/disable fullscreen mode (`UseFullscreen=1`, (`UseFullscreen=0`).
`-CrtcVidmodefullmode <mode>`
  Select fullscreen mode (`CrtcVidmodeFullscreenMode`). (xcbm2 and xpet only)
`-TEDVidmodefullmode <mode>`
  Select fullscreen mode (`TEDVidmodeFullscreenMode`). (xplus4 only)
`-VDCVidmodefullmode <mode>`
  Select fullscreen mode (`VDCVidmodeFullscreenMode`). (x128 only)
`-VICVidmodefullmode <mode>`
  Select fullscreen mode (`VICVidmodeFullscreenMode`). (xvic only)
`-VICIIVidmodefullmode <mode>`
  Select fullscreen mode (`VICIIVidmodeFullscreenMode`). (all emulators except xcbm2, xpet, xplus4, xvic and vsid)

### 8.6.4 GTK-specific features

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

#### 8.6.4.1 GTK GUI specific resources

`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.

#### 8.6.4.2 GTK GUI specific command-line options

`-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`).

## 8.7 Mac OS X-specific features

## 8.8 Windows-specific features

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

### 8.8.1 Windows GUI specific resources

`MouseSensitivity`
  Integer specifying the sensitivity of the mouse (all emulators except xcbm2, xcbm5x0, xpet, xplus4 and vsid). (0..40)
`MonitorDimensions`
  String that holds the dimensions and position in an encoded form.
`InitialDefaultDir`
  String specifying the initial default directory, which is used by the generic file browser dialog.
`InitialTapeDir`
  String specifying the initial tape directory, which is used by the tape image file browser dialog (all emulators except x64dtv, xscpu64 and vsid).
`InitialDiskDir`
  String specifying the initial tape directory, which is used by the disk image file browser dialog (all emulators except vsid).
`InitialAutostartDir`
  String specifying the initial autostart directory, which is used by the autostart image file browser dialog (all emulators except vsid).
`InitialCartDir`
  String specifying the initial cartridge directory, which is used by the cartridge image file browser dialog (all emulators except x64dtv and vsid).
`InitialSnapshotDir`
  String specifying the initial snapshots directory, which is used by the snapshots file browser dialog (all emulators except vsid).
`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.
`SingleCPU`
  Boolean specifying whether to use only the first CPU on an SMP system, or all CPUs.
`Window0Xpos`
`Window0Ypos`
  Integers specifying the position and size of the (first) emulator window (all emulators except vsid).
`Window1Xpos`
`Window1Ypos`
  Integers specifying the position and size of the (second) emulator window (x128 only).
`AlwaysOnTop`
  Boolean specifying if the emulator window should stay on top of other windows.
`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 1, 5: 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: Joystick 1, 5: 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: Joystick 1, 5: 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: Joystick 1, 5: joystick 2)
`JoyAutofire1Speed`
  Integer specifying the autofire speed for the emulation of joystick 1 (all emulators except xcbm2, xpet and vsid). (0..32)
`JoyAutofire2Speed`
  Integer specifying the autofire speed for the emulation of joystick 2 (all emulators except xcbm2, xpet, xvic and vsid). (0..32)
`JoyAutofire3Speed`
  Integer specifying the autofire speed for the emulation of extra joystick 1 (all emulators except xcbm5x0 and vsid). (0..32)
`JoyAutofire4Speed`
  Integer specifying the autofire speed for the emulation of extra joystick 2 (all emulators except xcbm5x0, xplus4 and vsid). (0..32)
`JoyAutofire1Button`
  Integer specifying the the code of the button to use for autofire for the emulation of joystick 1 (all emulators except xcbm2, xpet and vsid).
`JoyAutofire2Button`
  Integer specifying the the code of the button to use for autofire for the emulation of joystick 2 (all emulators except xcbm2, xpet, xvic and vsid).
`JoyAutofire3Button`
  Integer specifying the the code of the button to use for autofire for the emulation of extra joystick 1 (all emulators except xcbm5x0 and vsid).
`JoyAutofire4Button`
  Integer specifying the the code of the button to use for autofire for the emulation of extra joystick 2 (all emulators except xcbm5x0, xplus4 and vsid).
`JoyFire1Button`
  Integer specifying the the code of the button to use for fire for the emulation of joystick 1 (all emulators except xcbm2, xpet and vsid).
`JoyFire2Button`
  Integer specifying the the code of the button to use for fire for the emulation of joystick 2 (all emulators except xcbm2, xpet, xvic and vsid).
`JoyFire3Button`
  Integer specifying the the code of the button to use for fire for the emulation of extra joystick 1 (all emulators except xcbm5x0 and vsid).
`JoyFire4Button`
  Integer specifying the the code of the button to use for fire for the emulation of extra joystick 2 (all emulators except xcbm5x0, xplus4 and vsid).

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

`MIDIInDev`
  Integer specifying the MIDI input device (x64, x64sc, xscpu64, x128 and xvic only).
`MIDIOutDev`
  Integer specifying the MIDI output device (x64, x64sc, xscpu64, x128 and xvic only).

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

`DX9Disable`
  Boolean specifying whether to disable the DirectX 9 video driver and fall back on the GDI video driver (all emulators except vsid). (0: use GDI, 1: use DX9)
`DXPrimarySurfaceRendering`
  Boolean to enable/disable rendering to DirectX primary surface (all emulators except vsid).
`FullscreenEnabled`
  Boolean to enable/disable fullscreen mode (all emulators except vsid).
`FullscreenDevice`
  Integer specifying the fullscreen device (all emulators except vsid).
`FullscreenWidth`
  Integer specifying the width of the fullscreen display (all emulators except vsid).
`FullscreenHeight`
  Integer specifying the height of the fullscreen display (all emulators except vsid).
`FullscreenRefreshRate`
  Integer specifying the refresh rate of the fullscreen display (all emulators except vsid).
`VBLANKSync`
  Boolean to enable/disable vertical blank sync (all emulators except vsid).
`KeepAspectRatio`
  Boolean specifying whether the aspect ratio of the output window should be preserved (all emulators except vsid). (0: free scaling, 1: scale with fixed aspect ratio)
`TrueAspectRatio`
  Boolean specifying whether to use the true (non square pixels) aspect ratio (all emulators except vsid).
`AspectRatio`
  Integer specifying the aspect ratio (all emulators except vsid). (500..2000)

### 8.8.2 Windows GUI specific command-line options

`-mousesensitivity <sensitivity>`
  Set the sensitivity of the mouse (`MouseSensitivity`) (all emulators except xcbm2, xcbm5x0, xpet, xplus4 and vsid). (0..40)
`-initialdefaultdir <Name>`
  Select the initial default directory for the file browser dialog (`InitialDefaultDir`).
`-initialtapedir <Name>`
  Select the initial tape images directory for the file browser dialog (`InitialTapeDir`) (all emulators except x64dtv, xscpu64 and vsid).
`-initialdiskdir <Name>`
  Select the initial disk images directory for the file browser dialog (`InitialDiskDir`) (all emulators except vsid).
`-initialautostartdir <Name>`
  Select the initial autostart directory for the file browser dialog (`InitialAutostartDir`) (all emulators except vsid).
`-initialcartdir <Name>`
  Select the initial cartridge images directory for the file browser dialog (`InitialCartDir`) (all emulators except x64dtv and vsid).
`-initialsnapshotdir <Name>`
  Select the initial snapshot directory for the file browser dialog (`InitialSnapshotDir`) (all emulators except vsid).
`-saveres`
`+saveres`
  Enable/disable automatic saving of settings on exit (`SaveResourcesOnExit=1`, `SaveResourcesOnExit=0`).
`-confirmexit`
  Confirm quitting VICE (`ConfirmOnExit=1`).
`+confirmexit`
  Never confirm quitting VICE (`ConfirmOnExit=0`).
`-singlecpu`
  Only use the first CPU on SMP systems (`SingleCPU=1`).
`+singlecpu`
  Use all CPUs on SMP systems (`SingleCPU=0`).
`-alwaysontop`
`+alwaysontop`
  Enable/disable always on top feature (`AlwaysOnTop=1`, `AlwaysOnTop=0`).
`-joydev1 <0-5>`
  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 1, 5: joystick 2)
`-joydev2 <0-5>`
  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 1, 5: joystick 2)
`-extrajoydev1 <0-5>`
  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 1, 5: joystick 2)
`-extrajoydev2 <0-5>`
  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 1, 5: joystick 2)

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

`-midiin <number>`
  Specify MIDI-In device (`MIDIInDev`) (x64, x64sc, xscpu64, x128 and xvic only).
`-midiout <number>`
  Specify MIDI-Out device (`MIDIOutDev`) (x64, x64sc, xscpu64, x128 and xvic only).

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

`-dx9disable`
  Disable DirectX 9 video driver and fall back on the GDI video driver (`DX9Disable=1`) (all emulators except vsid).
`-dx9enable`
  Enable DirectX 9 video driver (`DX9Disable=1`) (all emulators except vsid).
`-dxpsrender`
`+dxpsrender`
  Enable/disable rendering to DirectX primary surface (`DXPrimarySurfaceRendering=1`, `DXPrimarySurfaceRendering=0`) (all emulators except vsid).
`-fullscreen`
`+fullscreen`
  Enable/Disable fullscreen mode (`FullscreenEnabled=1`, `FullscreenEnabled=0`) (all emulators except vsid).
`-fullscreendevice <number>`
  Specify fullscreen device (`FullscreenDevice`) (all emulators except vsid).
`-vblanksync`
`+vblanksync`
  Enable/disable vertical blank sync (`VBLANKSync=1`, `VBLANKSync=0`) (all emulators except vsid).
`-keepaspect`
  Enable keeping of the aspect ratio when scaling (`KeepAspectRatio=1`) (all emulators except vsid).
`+keepaspect`
  Disable keeping of the aspect ratio when scaling (freescaling) (`KeepAspectRatio=0`) (all emulators except vsid).
`-trueaspect`
`+trueaspect`
  Enable/disable whether to use the true (non square pixels) aspect ratio (`TrueAspectRatio=1`, (`TrueAspectRatio=0`) (all emulators except vsid).
`-aspect <aspect ratio>`
  Set the aspect ratio (`AspectRatio`) (all emulators except vsid). (500..2000)

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