Difference between revisions of "User Manual/Appendix: Controls"

From ScummVM :: Wiki
Jump to navigation Jump to search
Line 34: Line 34:
== Nintendo DS ==
== Nintendo DS ==
{{NintendoDSControls}}
{{NintendoDSControls}}
== Nintendo Switch ==
{{SwitchControls}}


== OpenPandora ==
== OpenPandora ==

Revision as of 15:50, 23 May 2019

WORK IN PROGRESS, HELP NEEDED
If you want to contribute, send us a sample of text you'd write for the new manual, and we will consider adding you an account. You can work on the manual in the Wiki, but if you prefer, supplying us with HTML or TeX sources is fine, too (we will then translate them for the Wiki).

You can have a look at our TODO page for a list of tasks that need to be done.

This page contains control mapping for various platforms.

Caanoo

 Touchscreen:
Buttons Action Notes
Touchscreen Move Pointer and process 'Tap Mode' on touch.
Help II Toggle Touchscreen 'Tap Mode' Adjusts the 'on tap' response, it cycles from 'Left Click' (Default), 'Right Click' and 'Hover'.
Left Trigger + Y Toggle Touchscreen 'Tap Mode' Adjusts the 'on tap' response, it cycles from 'Left Click' (Default), 'Right Click' and 'Hover'.
Left Trigger + Touchscreen 'Tap' Force the touchscreen 'Tap' to simulate a 'Right Click' regardless of the 'Tap Mode'. Ideal for quickly simulating a 'Right Click' in games without changing the configured 'Tap Mode'.
 Mouse Emulation:
Buttons Action Notes
Analogue Joystick Move Pointer
B Left Click
X Right Click
 Keyboard Emulation:
Buttons Action Notes
Help I Display in-game menu where supported Save, Load, Quit etc.
Home Escape
Hold (On Power Button) Exit ScummVM gracefully Please exit ScummVM doing this or via the menu, do not just turn off your Caanoo or you can loose save games
Y Space Bar
Right Trigger Return
 Button Combinations:
Buttons Action Notes
Left Trigger + Right Trigger Display the ScummVM Virtual Keyboard Ideal for entering 'Save Game' names or 'Copy Protection' information.
Left Trigger + Help I Display the Global ScummVM Main Menu Return to launcher and setup system options
Left Trigger + Home Exit ScummVM gracefully Please exit ScummVM doing this or via the menu, do not just turn off your Caanoo or you can loose save games
Left Trigger + A Open "Predictive Text" entry dialog Used in AGI games as long as a suitable dictionary is available


Dreamcast

 Game Controller Mapping:
Button Action Notes
Joystick Move Pointer
Directional pad Move Pointer (slowly) Also controls the on-screen keyboard
A Left Click
B Right Click
Y Space Pause
Start F5 Load and save
Left trigger Bring up/remove the on-screen keyboard
X 5 For boxing in Indy 3
D-Pad + X 1, 2, 3, 4, 6, 7, 8, 9 Likewise


GameCube

TODO

GP2X

 Touchscreen: (on F200)
Buttons Action Notes
Touchscreen Move Pointer and process 'Tap Mode' on touch.
Left Trigger + Y Toggle Touchscreen 'Tap Mode' Adjusts the 'on tap' response, it cycles from 'Left Click' (Default), 'Right Click' and 'Hover'.
Left Trigger + Touchscreen 'Tap' Force the touchscreen 'Tap' to simulate a 'Right Click' regardless of the 'Tap Mode'. Ideal for quickly simulating a 'Right Click' in games without changing the configured 'Tap Mode'.
 Mouse Emulation:
Buttons Action Notes
dPad/Joystick Move Pointer
Joystick Click Left Click
B Left Click
X Right Click
 Keyboard Emulation:
Buttons Action Notes
Start (Home on F200) Display in-game menu if supported Save, Load, Quit etc.
Select Escape
Y Space Bar
Right Trigger Return
Volume -/+ Set Volume
 Button Combinations:
Buttons Action Notes
Left Trigger + Volume Set Subtitle Speed In SCUMM games
Left Trigger + Right Trigger Display the ScummVM Virtual Keyboard Ideal for entering 'Save Game' names or 'Copy Protection' information.
Left Trigger + Start (or Home on the F200) Display the Global ScummVM Main Menu Return to launcher and setup system options
Left Trigger + Select Exit ScummVM gracefully Please exit ScummVM doing this or via the menu, do not just turn off your Caanoo or you can loose save games
Left Trigger + A Open "Predictive Text" entry dialog Used in AGI games as long as a suitable dictionary is available
Left Trigger + B Toggle 'Zoom' Cycles the zoom modes - Ideal for high resolution games like Broken Sword/COMI
Joystick Click + X Open "Save" dialog Used in Future_Wars


GP2XWiz

 Touchscreen:
Buttons Action Notes
Touchscreen Move Pointer and process 'Tap Mode' on touch.
Left Trigger + Y Toggle Touchscreen 'Tap Mode' Adjusts the 'on tap' response, it cycles from 'Left Click' (Default), 'Right Click' and 'Hover'.
Left Trigger + Touchscreen 'Tap' Force the touchscreen 'Tap' to simulate a 'Right Click' regardless of the 'Tap Mode'. Ideal for quickly simulating a 'Right Click' in games without changing the configured 'Tap Mode'.
 Mouse Emulation:
Buttons Action Notes
dPad Joystick Move Pointer
B Left Click
X Right Click
 Keyboard Emulation:
Buttons Action Notes
Menu Display in-game menu if supported Save, Load, Quit etc.
Select Escape
Y Space Bar
Right Trigger Return
Volume -/+ Set Volume
 Button Combinations:
Buttons Action Notes
Left Trigger + Right Trigger Display the ScummVM Virtual Keyboard Ideal for entering 'Save Game' names or 'Copy Protection' information.
Left Trigger + Menu Display the Global ScummVM Main Menu Return to launcher and setup system options
Left Trigger + Select Exit ScummVM gracefully Please exit ScummVM doing this or via the menu, do not just turn off your Caanoo or you can loose save games
Left Trigger + A Open "Predictive Text" entry dialog Used in AGI games as long as a suitable dictionary is available


iPhone / iPod Touch

 Game Controller Mapping:
Action Touch screen control
Left click Single tap
Right click Hold one finger on screen where you want to click, single tap another
Arrow keys Only with ScummVM 2.1.0 or above, use a three fingers swipe in the direction of the arrow key you want. You can also use the arrow buttons in the bar above the keyboard (on iPhone you may need to scroll the bar to see those).
ESC Hold one finger on screen, double tap another. Since ScummVM 2.1.0 you can also use the Esc key in the bar above the keyboard.
Tab Since ScummVM 2.1.0 use the Tab button in the bar above the keyboard.
Return Since ScummVM 2.1.0 use the Return button in the bar above the keyboard.
Global Main Menu Swipe two fingers down from top to bottom. Note: In all versions before 1.5.0, this only send "F5" and thus in some games different menus were brought up. Since ScummVM 2.1.0 you can also use the left-most button in the bar above the keyboard.
Enable/disable keyboard Rotate phone to Portrait orientation, rather than landscape to enable the keyboard. Since ScummVM 2.1.0 you can also use the pinch gesture to enable or disable the keyboard (pinch in to enable the keyboard and pinch out to disable it). If no external keyboard is connected, this shows and hides the On Screen keyboard. When an external keyboard is connected, instead of showing/hiding the On Screen keyboard this enables/disables inputs from the external keyboard.
F 0-9 keys Press the keyboard button directly under the appropriate number. Since ScummVM 2.1.0 use the bar above the keyboard instead.
Pause Keyboard spacebar
Toggle Click+Drag mode Swipe two fingers up from bottom to top. In this mode, a mouse click is sent immediately when you touch the screen, drags to wherever you slide your finger, and releases where you lift your finger. If you press down a second finger in this mode, you effectively release the left mouse button, and press down the right one (which is then released when you lift your finger again). Useful for Monkey Island 3: The Curse of Monkey Island and Full Throttle.
Toggle Touchpad mode Swipe two fingers from left to right. In this mode, the cursor doesn't stay underneath your finger, but is rather moved around from its current position depending on the direction of your finger movement, just like a touchpad on a laptop. From version 0.12.0-pre3 and upwards only.
Suspend Press the tactile "home" button.
Quit Press and hold the tactile "home" button for 5-6 seconds.


LinuxMoto

 Game Controller Mapping - pkg (A1200, E6, A1600) (motoezx):
Buttons Action
Call key Menu
Hangup key Skip Scene
Camera key Virtual Keyboard
joy(fire) or volume '-' Left Click
volume '+' Right Click
mod+camera key (mod - key beetwin vol'+' & vol'-') Quit
 Game Controller Mapping - mgx, mpkg, pep (E8, EM30, U9, ZN5, Z6, V8, VE66, EM35) (motomagx):
Buttons Action
Left softkey Menu
Hangup key Skip Scene
Right softkey Virtual Keyboard
joy(fire) or volume '-' Left Click
volume '+' Right Click
Clr key Quit


Maemo

 N810 Mapping:
Button Action
Menu Global Main menu
Fullscreen Toggle Fullscreen
Zoom+ Right Click
Zoom- Switch (left) clicking mode
CTRL + Zoom- Virtual Keyboard
Home Remap Keys
 N800 Mapping:
Button Action
Menu Global Main menu
Fullscreen Virtual Keyboard
Zoom+ Right Click
Zoom- Switch (left) clicking mode
Home Remap Keys
 N900 Mapping:
Button Action
CTRL + SHIFT + m Global Main menu
Zoom+ Right Click
Zoom- Switch (left) clicking mode
CTRL + Zoom- Virtual Keyboard


Nintendo 64

 Game Controller Mapping:
Button Action
Left Trigger ESC
Right Trigger Virtual Keyboard
Analog Mouse Movement
D-Pad Slow Mouse Movement
Start F5 / Main menu in some games
Z Mouse Left Button
B Mouse Right Button
A . / Skip dialogues in some games
C buttons Numeric keypad keys


In addition to the gamepad you can use the Nintendo 64 mouse like a normal PC mouse.

Nintendo DS

 Game Controller Mapping - right-handed mode (default):
Button Action
Pad Left Left mouse button mode
Pad Right Right mouse button mode
Pad Right Hover mouse mode
Pad Down Skip dialogue line (for some LucasArts games), Show inventory (for Beneath a Steel Sky), Show active objects (for Simon the Sorcerer)
Start Pause/game menu (works in some games)
Select DS Options
B Skip cutscenes
A Swap main screen and zoomed screen
Y Show/Hide debug console
X Show/Hide on-screen keyboard
L + D-pad or L + Pen Scroll touch screen view
L + B Zoom in
L + A Zoom out
 Game Controller Mapping - left-handed mode:
Button Action
Y Left mouse button mode
A Right mouse button mode
X Hover mouse mode
B Skip dialogue line (for some LucasArts games), Show inventory (for Beneath a Steel Sky), Show active objects (for Simon the Sorcerer)
Start Pause/game menu (works in some games)
Select DS Options
D-pad down Skip cutscenes
D-pad up Swap main screen and zoomed screen
D-pad left Show/Hide debug console
D-pad right Show/Hide on-screen keyboard
LR+ D-pad or R + Pen Scroll touch screen view
R + D-pad down Zoom in
R + D-pad right Zoom out

You can switch between the right-handed and left-handed mode using the DS Options (Select button).

An icon on the top screen will show you which mouse mode you're in.

NDSControlsMBLeft.png
NDSControlsMBRight.png
NDSControlsMBHover.png
Left mouse button mode Right mouse button mode Mouse hover mode

In hover mode, there are some additional controls. While holding the pen on the screen, tapping D-pad left or D-pad right (or A/Y in left handed mode) will click the left or right mouse button.

There is an alternative method of control which doesn't require you to change modes with the D-pad. Press 'Select' to bring up the DS options, and choose 'Tap for left click, double tap for right click'. In this mode, you can quickly tap the screen to left click the mouse, and tap twice to right click the mouse.

Some games also have specific controls that are listed in the table below.

 Game Controller Mapping - Game-specific controls:
Button Action
Sam and Max Hit the Road
D-pad right Cycle through cursor modes
Indiana Jones games' Fighting mode (activated in DS Option)
D-pad left Move left
D-pad right Move right
D-pad up Guard up
D-pad down Guard down
Y Guard middle
X Punch high
A Punch middle
B Punch low
Left shoulder Fight towards the left
Right shoulder Fight towards the right
Beneath a Steel Sky
D-pad down Show inventory
Simon the Sorcerer 1/2
D-pad down Show active objects
AGI games
Start Show the menu bar
Bargon Attack
Start Hit F1 when you need to start the game (use the on-screen keyboard for other function keys)


Nintendo Switch

 Game Controller Mapping:
Button Action
Left stick Mouse
R + Left stick Slow Mouse
B Left mouse button
A Right mouse button
DPad Keypad "Cursor" Keys (useful for character motion in Sierra games)
R + DPad Diagonal Keypad "Cursor" Keys
L Trigger Game menu (F5)
R Trigger Shift (used to enable Mass Add in menu)
Y Period '.' (used to skip dialog lines)
R + Y Space ' '
X Escape (used to skip cutscenes)
R + X Return
Plus ScummVM's global in-game menu
Minus Toggle virtual keyboard
R + Minus AGI predictive input dialog
 Touch Controls (Touchpad Mouse Mode Off, Default):
Touch Action
short single finger tap Move pointer to finger position and left mouse button click
short second finger tap while holding one finger Move pointer to first finger position and right mouse button click
single finger drag Move pointer directly with finger
dual finger drag (long second finger tap while holding one finger) Move pointer while left mouse button is held down (drag'n'drop). The pointer directly follows the first finger. The drag is ended when the last finger is removed.
triple finger drag (long second and third finger tap while holding one finger) Move pointer while right mouse button is held down (drag'n'drop). The pointer directly follows the first finger. The drag is ended when the last finger is removed.
 Touch Controls (Touchpad Mouse Mode On):
Touch Action
short single finger tap Left mouse button click
short second finger tap while holding one finger Right mouse button click
single finger drag Move pointer indirectly with finger, pointer speed can be adjusted in control settings
dual finger drag (long second finger tap while holding one finger) Move pointer while left mouse button is held down (drag'n'drop). The pointer motion is affected by the first finger. The drag is ended when the last finger is removed.
triple finger drag (long second and third finger tap while holding one finger) Move pointer while right mouse button is held down (drag'n'drop). The pointer motion is affected by the first finger. The drag is ended when the last finger is removed.

Notes:

  • Physical USB mice and keyboards work on the Switch and are supported by ScummVM. All keyboards work. Not all mice work. A mouse compatibility list is available here
  • For multi-touch gestures, the fingers have to be far enough apart from each other, so that the Switch will not erroneously recognize them as a single finger. Otherwise the pointer will jump around.
  • The touch control scheme can be switched in the main menu via "options->controls->touchpad mouse mode"
  • When touchpad mouse mode is off (default), the touch controls are direct. The pointer always jumps to the finger.
  • When touchpad mouse mode is on, the touch controls are indirect. The finger can be far away from the pointer and still move it, like on a laptop touchpad. The pointer speed setting in "options->controls" affects how far the pointer moves in response to a finger movement.
  • The two finger drag is useful for Full Throttle to bring up the action menu, and in the menu to use the scroll bar in the game list. It works in the following way: holding down two fingers for a while initiates a drag'n'drop where the left mouse button is being held down. The first finger affects mouse motion during the drag, the second finger can be removed without affecting the drag. When the last finger is removed, the left mouse button is released and the drag is over. Note the second finger can be anywhere, it doesn't have to be close to the first finger, and it doesn't have to be put down simultaneously with the first finger, either.
  • Typical usage of dual finger drag and drop in Full Throttle: Hold down one finger over an object. Then hold down a second finger somewhere on the screen for a little bit to initiate a dual finger drag. This brings up the action menu. Now let go of the second finger. The dual-finger drag continues since one finger is still down. Select an action with the first finger, and let go of the first finger to end the drag.
  • There is also a three finger drag that causes the right-mouse button to be held down, instead of the left one. It might be useful for some games.


OpenPandora

 Touchscreen:
Buttons Action Notes
Touchscreen Move Pointer and process 'Tap Mode' on touch.
Y Toggle Touchscreen 'Tap Mode'. Adjusts the 'on tap' response, it cycles 'Left Click' (Default), 'Right Click', 'Hover' and 'Hover - DPad Click'. 'Hover - DPad Click' is just what is suggests. You can use a press on the DPad to create a left click wherever the stylus is pressing on the screen and hover at all other times.
Left Trigger + Touchscreen 'Tap'. Force the touchscreen 'Tap' to simulate a 'Right Click' regardless of the 'Tap Mode'. Ideal for quickly simulating a 'Right Click' in games without changing the configured 'Tap Mode'.
A + Touchscreen 'Tap'. Left Click. Ideal for Left Handed users of the touchscreen when combined with the hover 'Tap Mode'.
B + Touchscreen 'Tap'. Right Click. Ideal for Left Handed users of the touchscreen when combined with the hover 'Tap Mode'.
 Mouse Emulation: (Default Nub Settings)
Buttons Action Notes
Left Nub Move Pointer.
Right Nub moved Left Left Click.
Right Nub moved Right Right Click.
 Keyboard/Buttons:

Wherever possible the keyboard layout has been kept the same as the desktop versions of ScummVM.
Only OpenPandora specific button layouts are shown below. Normal keys should behave as you expect.

Buttons Action Notes
dPad Cursor Keys. Ideal for AGI games.
X Display the Global ScummVM Main Menu in supported engines. Return to launcher, setup system options and save/load.
 Button Combinations:
Buttons Action Notes
Start/Ctrl + Q Exit ScummVM gracefully Please exit ScummVM doing this or via the menu, do not just turn off your OpenPandora you can loose save games.


PlayStation 2

TODO

PlayStation 3

 Touchscreen:
Buttons/Control Action Notes
Left stick Move Pointer
Cross Left Mouse Button
Circle Right Mouse Button
Triangle Game Menu (F5)
Square Escape
Start ScummVM's Global Main Menu (Crtl+F5)
Select Toggle Vitual Keyboard
L1 AGI Predictive Input Dialog


PSP

 Game Controller Mapping:
Button Action
Right trigger Modifier key (see below for uses)
Left trigger ESC (Usually skips cutscenes. Depends on game)
Analog Mouse movement
Right trigger + Analog Fine mouse movement
D-Pad Arrow keys (useful mostly in SCI and AGI games)
D-Pad + Right Trigger Diagonal arrow keys (it's hard to input diagonals on some PSPs)
Triangle Enter (useful for some dialogs)
Cross Left Mouse Button (usually the main button)
Circle Right Mouse Button (secondary button in some games)
Square '.' (skip dialogue in some games e.g. Scumm)
Right trigger + Square Spacebar (useful in Gobli*ns and SCI games)
Right trigger + Start F5 (Main Menu in some games)
Select Show/Hide Virtual Keyboard. Hold down to move keyboard onscreen (with D-Pad).
Right trigger + Select Show Image Viewer (see below)
Start Global Menu. Allows you to 'Return To Launcher' to play another game
 Virtual Keyboard Mode:
Start Enter key. Also exits virtual keyboard mode
Select Exit the virtual keyboard mode
Right trigger Input letters: lowercase/uppercase (press to toggle)
Left trigger Input numbers/symbols (press to toggle)
D-Pad Select square of characters (up, down, left or right)
Buttons/Triggers Choose a specific character in the square. The four center characters are chosen by the button in the corresponding position. The 2 top characters are chosen by the triggers.
Analog Moves in a direction (left/right/up/down) (Useful to keep moving while typing in AGI games among other things)
 Image Viewer:
Left/Right previous/next image (e.g. go from psp_image1.png to psp_image2.png)
Up/down zoom in/out
Analog move around the image
Triggers, Start exit image viewer
 1st Person Game Mode (Can be ignored by most users):
Right Trigger + Left Trigger + Square Enable 1st Person Mode
Square Is the modifier key instead of Right Trigger.
Left/Right Trigger Strafe left/right
D-Pad Left/Right Turn left/right
Square + D-Pad F1/F2/F3/F4
Square + Select Image Viewer
Square + Start Esc (shows game menu)


Vita

 Game Controller Mapping:
Button Action
Left stick Mouse
R + Left stick Slow Mouse
Cross Left mouse button
Circle Right mouse button
DPad Keypad "Cursor" Keys (useful for character motion in Sierra games)
R + DPad Diagonal Keypad "Cursor" Keys
L Trigger Game menu (F5)
R Trigger Shift (used to enable Mass Add in menu)
Square Period '.' (used to skip dialog lines)
R + Square Space ' '
Triangle Escape (used to skip cutscenes)
R + Triangle Return
Start ScummVM's global in-game menu
Select Toggle virtual keyboard
R + Select AGI predictive input dialog
 Front Panel Touch Controls, always enabled (from version 2.1.0):
Touch Action
short single finger tap Move pointer to finger position and left mouse button click
short second finger tap while holding one finger Move pointer to first finger position and right mouse button click
single finger drag Move pointer directly with finger
dual finger drag (long second finger tap while holding one finger) Move pointer while left mouse button is held down (drag'n'drop). The pointer directly follows the first finger. The drag is ended when the last finger is removed.
triple finger drag (long second and third finger tap while holding one finger) Move pointer while right mouse button is held down (drag'n'drop). The pointer directly follows the first finger. The drag is ended when the last finger is removed.
 Back Panel Touch Controls, enabled via Touchpad Mouse Mode option (from version 2.1.0):
Touch Action
short single finger tap Left mouse button click
short second finger tap while holding one finger Right mouse button click
single finger drag Move pointer indirectly with finger, pointer speed can be adjusted in control settings
dual finger drag (long second finger tap while holding one finger) Move pointer while left mouse button is held down (drag'n'drop). The pointer motion is affected by the first finger. The drag is ended when the last finger is removed.
triple finger drag (long second and third finger tap while holding one finger) Move pointer while right mouse button is held down (drag'n'drop). The pointer motion is affected by the first finger. The drag is ended when the last finger is removed.

Notes:

  • For multi-touch gestures, the fingers have to be far enough apart from each other, so that the Vita will not erroneously recognize them as a single finger. Otherwise the pointer will jump around.
  • Real bluetooth mice and keyboards work on the Vita and are supported by ScummVM. This was tested working with Jelly Bean BT keyboard and mouse combo ASIN:B06Y56BBYP and with the standalone Jelly Comb Bluetooth Wireless Mouse ASIN:B075HBDWCF. Not all bluetooth keyboards or mice pair successfully with the Vita. Use settings->devices on the Vita home screen to try and pair your devices.
  • Touch control mode can be changed via the option "touchpad mouse mode" in options->controls.
  • The front touch always uses a direct mode, where the mousepointer jumps to the finger position (like on a mobile phone screen).
  • When "touchpad mouse mode" is off, the rear touch is disabled.
  • When "touchpad mouse mode" is on, the rear touch is enabled in addition to front touch. The rear touch uses an indirect mode, where the finger can be far away from the pointer and still move it, (like on a laptop touchpad). The pointer speed setting in options->controls affects how far the pointer moves in response to a finger movement on the rear panel.
  • The advanced option "frontpanel_touchpad_mode=false" in scummvm.ini can be changed with a texteditor to "frontpanel_touchpad_mode=true" . This forces the front panel into an indirect mode similar to the rear panel. If this option is set, the pointer does not jump to the finger anymore.
  • The two finger drag is useful for Full Throttle to bring up the action menu, and in the menu to use the scroll bar in the game list. It works in the following way: holding down two fingers for a while initiates a drag'n'drop where the left mouse button is being held down. The first finger affects mouse motion during the drag, the second finger can be removed without affecting the drag. When the last finger is removed, the left mouse button is released and the drag is over. Note the second finger can be anywhere, it doesn't have to be close to the first finger, and it doesn't have to be put down simultaneously with the first finger, either.
  • Typical usage of dual finger drag and drop in Full Throttle: Hold down one finger over an object. Then hold down a second finger somewhere on the screen for a little bit to initiate a dual finger drag. This brings up the action menu. Now let go of the second finger. The dual-finger drag continues since one finger is still down. Select an action with the first finger, and let go of the first finger to end the drag.
  • There is also a three finger drag that causes the right-mouse button to be held down, instead of the left one. It might be useful for some games.


Symbian

TODO

Wii

TODO

Windows CE

See Windows CE controls

TODO: move the content to this page