Controls used in ScummVM for Symbian devices

Subforum for discussion and help with ScummVM's Symbian (mobile phones, etc) ports

Moderator: ScummVM Team

Anotherguest
ScummVM Porter
Posts: 1423
Joined: Sun Oct 30, 2005 2:27 pm
Location: Malmoe, Sweden

Controls used in ScummVM for Symbian devices

Post by Anotherguest »

UIQ3 devices: To the top right (holding the phone portrait) you four icons, from the top they are

* Toggle control mode, in control mode you can change textinput , screen orientation and screen scaling
* Mouse button, toggles between left, right and no button when tapping the screen. If no button is selected, 7 & Space works as left mouse button and 9 & Enter works as the right mouse button.
* Esc, tap this to simulate ESC key beeing pressed. Same funtiontionaly on devices with 'C' key.
* Virtual keyboard toggle, toggles the virtual keyboard, if not enabled when selecting '1'/'7' in control mode.
* When Virtual keyboard is enabled you have more onscreen keys available
* Enter key
* Backspace
* Arrow Up/Down to scroll the keys available
* Virtual keyboard, tap letters to simulate keypresses.

S60 and UIQ3 devices: (Control Key = Green Phone key, to activate/deactivate control mode in SDL)

* 1 = change Input Mode: Joystick | Keyboard | Cursor
* 2,'p' = change Video Mode: Landscape | Portrait
* 3,'f' = change Orientation Mode for Landscape: 90° Left | 90° Right
* 4,'s' = Toggle between stretched and non-stretched modes
* 5 = Toggle between interpolating stretch or not
* 7,'t' = Text/Multitap input
* 8,'c' = Cursor input
* 9,'j' = Joystick input
* 0,'m' = Mouse input
* Up/Down = Alter global volume when not in 1-1 VGA mode. Pan around in VGA 1-1 Mode

S80 devices:

* Side key 1 = Fire Joystick 1 button (JoyMode)
* Side key 2 = Fire Joystick 2 button (JoyMode) or change Video Mode: Upscaled | Normal (CursorMode)
* Side key 3 = change Input Mode: Joystick | Cursor

S90 devices: (Control Key = OK, pressed simultaneously with other keys to activate the mode changes in SDL)

* OK+1 = change Input Mode: Joystick | Cursor
* OK+2 = change Video Mode: Upscaled | Normal

What are these Joystick, Keyboard and Cursor modes anyway?

Joystick mode sends SDL joystick events to ScummVM which acts as a mouse control in ScummVM. Cursor mode sends keyboard arrows instead, so for example it can be used to navigate through directorylist (one hand use perhaps!?) or save games etc. Keyboard mode is only available for S60 and enables multi-tap to enter text characters in save dialogs. These modes are implemented at the underlying SDL level, so this determines the types of events that ScummVM receives from SDL.
What are these Shrinked, Zoomed and Upscaled modes anyway?

Shrink displays the game on your screen but in a shrinked way, either in Portrait or Landscape mode, so not all the pixels can be seen. Zoom mode uses the maximum resolution of your phone displaying a smaller part of the game zoomed at 1:1 pixels. For scrolling in S60 Zoom mode: 0+Cursor keys to scroll around, 0+Ok button to center view. Upscale tries to fill the larger screens on S80/S90 devices in a better way for low resolution games. Currently it uses a pixel interpolation upscaling routine.

You can also use a bluetooth mouse with S60v3 devices to control your game. You need the bluetooth hid library from Hinkka http://koti.mbnet.fi/hinkka/Download.html to get it to work properly.
Last edited by Anotherguest on Wed Jan 27, 2010 7:46 am, edited 1 time in total.
VincentJ
Posts: 5
Joined: Mon Dec 29, 2008 10:23 pm

Post by VincentJ »

Here's a more user-friendly guide for Nokia phones (based on N96 but should apply to most phones)

Left Soft Key - Left Click
Right Soft Key - Right Click
Navigation buttons - Move pointer on screen
"C" or "Delete Key" - Space Bar (i.e. skip dialogue/cutscene)
* - Bring up Menu (to Save, Load and change the game's options e.g.

enable subtitles, speech etc. Varies from game to game)

Call Button - Enter/Exit Configuration Mode

Configuration Mode, when activated, shows the word "CTRL" in green in

the upper right corner of the screen. It allows to quickly switch

between various functions of ScummVM. The following buttons on your

keypad are activated when "CTRL" is displayed-

1 - Change Input.
This is the option you'll probably use the most. There are three

settings; A,C and J.

A - This is the "Text Input" mode. It allows you to type directly into

ScummVM as if you were using a keyboard. Type the same way you would

when sending a text message off of your phone. Please note that the

pointer is disabled when in this mode. Don't forget to exit

Configuration Mode before typing!
C - This is the "Cursor" mode. This emulates the arrow keys of the

keyboard. Some games require using this instead of the mouse (e.g. the

destruction derby section towards the end of Full Throttle).
J - This is the "Joystick/Mouse" mode. Simply put, it allows you to

use the navigation buttons to move the pointer around the screen. The

left and right mouse buttons are used by the left and right Soft keys.

The "C" button emulates the space bar, i.e. skip line of dialogue,

skip cutscene or pause game (depending on the game, some games simply

use the left mouse button to skip dialogue in which case it will pause

the game instead)

2 - Toggle Landscape and Portrait
Switches the screen ouput between having the phone held normally

(Portrait) or on its side (Landscape). You'll probably never take it

off Landscape mode as it offers the better display area.

3 - Change Landscape Orientation
Only applies to Landscape mode, simply swaps the screen output between

having the phone tilted on its left side or on its right side.

4 - Toggle Zoom On and Off
Zooms in on a portion of the screen. Handy for when you are looking

through a screen for items or having trouble reading subtitles. Use

the navigation buttons for panning around the play area. Don't forget

you'll have to exit out of Configuration Mode before you can move the

pointer again. Exiting Configuration Mode does not reset the zoom

level.

5 & 6 - Unused

7 - "Text Input" mode. Shortcut for entering "Text Input" mode

directly instead of cycling through the other input types using the

"1" key.

8 - "Cursor" mode. Shortcut for entering "Cursor" mode directly

instead of cycling through the other input types using the "1" key.

9 - "Joystick/Mouse" mode. Shortcut for entering "Joystick/Mouse" mode

directly instead of cycling through the other input types using the

"1" key.

0 & * - Unused (The "*" Menu is disabled in Configuration Mode")

Up Navigation Button - Increase ScummVM sound volume. Note that the

game itself may have its own independent sound settings (usually found

under the * menu)

Down Navigation Button - Decrease ScummVM sound volume. Note that the

game itself may have its own independent sound settings (usually found

under the * menu)
murgo
Posts: 12
Joined: Sun Jun 24, 2007 4:06 pm
Location: Jyväskylä, Finland

Post by murgo »

ScummVM keys on Nokia e71 (most likely on any other qwerty-device, too), tested on version 0.14.0svn (feb 18 2009 05:56:07). Number keys are inserted by first pressing fn-key (leftmost key at bottom row on E71) and then pressing correct key (e.g. 5 is fn+g). You don't have to press both keys simultaneously.

Basic keys:
  • Joystick -- Move cursor (in joystick mode) / arrow keys (in keyboard / cursor mode)
  • Joystick button -- Skip text
  • Left soft key -- Left mouse button
  • Right soft key -- Right mouse button (context sensitive actions in LucasArts' games, something else in others)
  • Backspace -- Esc / Skips demos / Removes selected action
  • * (fn+u) -- Menu
  • Space -- Pause
  • Enter -- Enter (usually same as left soft key)
In main menu:
Shift -- Shift (can be used to mass-add games)
You can press the first letter of the game name to jump there in the games list.


CTRL-keys:
To use these, first click on green answer key once, so that text CTRL shows up in the northwest corner of the screen, then click the key.
  • p / 2 -- Screen orientation
  • s / 5 -- Screen size
  • k / 7 -- Input mode: keyboard
  • c / 8 -- Input mode: cursor
  • j / 9 -- Input mode: joystick
  • joystick up -- Volume up
  • joystick down -- Volume down
  • 1 -- Toggle input mode
Game specific:
Most games have some specific keys (the same as in desktop model of ScummVM?). For instance in Day of the Tentacle:
  • w -- Walk to
  • l -- Look at
  • p -- Pick up
  • c -- Close
  • o -- Open
  • g -- Give
  • t -- Talk to
  • s -- Push
  • y -- Pull
and in Full Throttle (from the top of my head):
  • k -- kick (foot)
  • t -- talk (mouth)
  • l -- look (eyes)
  • p -- punch (hand)
AGI games (King's Quest, Police Quest etc.):
The games work beautifully on the E71, but there's some stupid bugs (in input). I recall finding some debug keys and "last sentence" / "inventory" -keys in earlier version, but I can't find them any more. Also you can't turn on sirens in Police Quest, which kinda makes it unplayable.

There's good side and bad side to each input mode:
Keyboard (I use this primarily)
  • * goes to menu
  • + you can erase text
  • + moving is relatively easy
  • - you can't type in UPPER CASE
  • - you can't type numbers
  • - worthless 'current key' -display on left top corner
Joystick / Cursor:
  • + you can access menus
  • + you can type numbers (just make sure f-letter in left top corner is red before clicking "numbers". It works kinda funnily, but you'll get hang of it.)
  • - you move mouse cursor which makes walking harder (joystick mode)
  • - you can't erase text
There might be some mistakes and some keys missing from the list, feel free to pm me corrections / suggestions.
tejo.hr
Posts: 2
Joined: Sun Nov 08, 2009 4:45 pm

Post by tejo.hr »

I just started using the emulator on my Full Throttle game. Emulator works like a charm on my N79 and everything runs perfectly except... well I cant access the inventory in this game. I do remember once I got the bike keys I was able to open the inventory somehow, but after that no matter what I did I couldn't manage to open it again. I got the picklock in the game now and I cant advance any further without picking it from inventory and use it on a lock.

The action in the game to open the inventory is right mouse button. I think before it was right soft key as default, but it's not working now. I also went into options and assigned the right soft key as right mouse button and it also didn't work. After that I though I messed something up in key menu so I deinstalled the emulator, but cant get to the inventory again.

EDIT:I binded it to key 6 and it works now, but it's still silly that right softkey aint working.
walkermore
Posts: 1
Joined: Sat Mar 27, 2010 7:57 am

Post by walkermore »

sounds good to me
carlo.cavaliere
Posts: 1
Joined: Tue Apr 13, 2010 1:22 am

Nokia e72 keys?

Post by carlo.cavaliere »

Ehi, are Nokia e72 keys quite different from e71's?

May anyone map them? Tnx!
maff.brush
Posts: 19
Joined: Fri Jun 25, 2010 1:01 pm

Post by maff.brush »

May I suggest a few things?
Could you get the right click by holding the finger on the spot?
if this is not possible, could the mouse button toggle only between right and left (without no-button mode)? it would be much faster (why is there a no-button mode, anyway?)

Could you add the menu button "*" to the narrow column of buttons?

And...
Mataku wrote:Well, seeing as ALL phones (i think) have some sort of physical volume buttons on them, can't you assign these buttons to set the volume on scummvm as well?
...this would be great too :D
Anotherguest
ScummVM Porter
Posts: 1423
Joined: Sun Oct 30, 2005 2:27 pm
Location: Malmoe, Sweden

Post by Anotherguest »

Flipping tap should be easy as 1.2.3 to implement. jus make */- -/* -/- and </> mode
Anotherguest
ScummVM Porter
Posts: 1423
Joined: Sun Oct 30, 2005 2:27 pm
Location: Malmoe, Sweden

Post by Anotherguest »

ok.. left right left right should be implemented soon. And please try the latest test.. CTRL and then * in touch mode.
maff.brush
Posts: 19
Joined: Fri Jun 25, 2010 1:01 pm

Post by maff.brush »

Anotherguest wrote:And please try the latest test.. CTRL and then * in touch mode.
cool 8)
bosone
Posts: 2
Joined: Wed Sep 08, 2010 10:32 am

Post by bosone »

I have a Nokia E55 and i cannot use SCUMMVM.

i tried the hint for Nokia E71 but they did not work.
any suggestion??

thanks!
asar19
Posts: 2
Joined: Mon Oct 18, 2010 1:05 am

5530xm control issue

Post by asar19 »

i'm using scummvm-100923-SymbianS60v3_all.sis on my nokia 5530xm. whenever i put the control mode on "--", when i tap the RGT key, it presses itself one more time when i tap the screen all the time. so i have to use the big CUR virtual pad (which works ok) on some games which immediately halves the screen on landscape. Also, it seems that when i use CTL, virtual joystick is no longer available, the vk just flickers when i tap NUM/CUR while in CTRL mode, always showing just the numpad (no direction keys) whether it's on NUM or CUR mode.
Anotherguest
ScummVM Porter
Posts: 1423
Joined: Sun Oct 30, 2005 2:27 pm
Location: Malmoe, Sweden

Post by Anotherguest »

CTL mode is only for adjust SDL properties, i.e Screen orientation(2,3), Scaling (4 for upscale, 5 for nice or fast, 6 for aspect), and input modes. Once selected you should tap CTL again to disable and return to normal control mode.
asar19
Posts: 2
Joined: Mon Oct 18, 2010 1:05 am

re: 5530xm control issue

Post by asar19 »

yeah, but ctl command for master volume control is on the CUR pad (namely CTL -> UP) and is not accessible in this version with out access to the CUR pad.

i guess i just have to run virtualkey to emulate the joystick. have problems setting commands though, emulating RSK on virtualkeys is 'space' instead of 'right click' on scummvm and and LSK is 'enter'. but i guess that's because virtualkey is s60v3 not fully compatible with v5. any tips on mapping keys easier?
User avatar
Mataku
Posts: 196
Joined: Tue Apr 21, 2009 3:28 pm

Post by Mataku »

yea, Anotherguest, how am i supposed to set the volume in the new version? pressing ctrl changes the arrows to numbers so i can't set it.
Post Reply