Features/Touch/Development

This page is about the development of the touch feature for the Sugar interface. Each item has a detailed implementation plan. The design decisions are based on these related pages:

Sugar Shell Touch Input

Sugar Shell Touch Input Talk

On Screen Keyboard

Activity Touch Input

Todo (essential)

On screen keybord (OSK)

Canvas auto panning based on input focus

• GTK+ branch from Carlos

Show Frame or OSK, never both

When the OSK is up and the frame is revealed the OSK should go away, same when the Frame is up and the OSK is revealed (manually or automatically) the Frame should hide.

• Maliit-glib API "maliit_input_method_hide".

Hide OSK key on OSK

There should be a key on the OSK to manually hide the keyboard. Currently you can already hide the Maliit keyboard by a vertical stroke but that is not as discoverable and does not work as reliable (as of today).

Show OSK button on device Frame edge

There should be a key on the Frame in the device section to manually reveal the OSK.

• Maliit-glib API "maliit_input_method_show".

Sugar theme

The OSK should have a Sugar theme.

Internationalisation

• e.g. layout covers our accent needs

Multilingual

• there should be the ability to switch between at least two languages, at the moment this can be done by swiping horizontally, this is not as discoverable and hard to do, would be nice to have a button for that (see iOS)
• add languages, could be done in a control panel section

Landscape/portrait

Currently not working anymore, upstream Maliit bug.

Reveal on text input focus, auto **dismiss** on loss of focus

• Reveal the OSK when clicking e.g. on a GTK entry (working quite well already)
• Dismiss the OSK when defocus: e.g. in Browse the OSK comes up when clicking in the url entry, clicking on the canvas defocus the entry and hide the OSK (is already working fine), in other places e.g. in the Neighborhood View when the search field is focused we have to see how we can do better, we can experiment with a) not putting the default focus in the search widget; b) on physical keyboard typing auto focus into the search widget. For b) we would need to check there is not some other text input widget in focus, e.g. in Journal view you might be trying to retitle an entry and would not want the search to grab input at that time.

Don't auto reveal in laptop mode, only ebook mode

For devices which have a hardware keyboard and a touchscreen the OSK should not be auto revealed in the "laptop mode". You will be able to manually reveal it with the button in the Frame.

Text selection

• Selection handles
• Cut(?)/Copy/Paste/Speak selection palette
• design discussions
• GTK+ branch from Carlos

Drag scrolling support

For example scrolling in the Journal or the activity list view.

Hide/show mouse cursor based on input method

When in Ebook mode, or when using the touch screen, the cursor should be hidden. When using the trackpad the cursor should be revealed. Idealy fade the cursor in and out of visibility using alpha if possible.

Palette behaviours

• Tapping/clicking icons with no primary action should instantly open full palette
  • right frame edge buddy icons
  • central home buddy icon, testing patch
  • access point device icons
• Home View activity icons: leave behavior as is or always show palette, ideally we have the intermediate screen
• Journal: auto-resume is the primary action when clicking on an activity entry, current behavior is correct here

Frame

Hide/Show Frame

• Expose/hide gesture: reveal/hide the Frame by a swipe in/out gesture, revealing would be a gesture over the frame area into the center and the other way around to hide, will collide when you sketch at the edge of the Paint activity if the gesture is not carefully tuned (a swip, not slow drag, of short length perpendicular to frame edge, diagonal at corners).
  • Button for top left (fallback)
  • Use the square game button on the XO as a Frame button, testing patch
  • do not hide frame on mouse out, do hide frame when going to a hot corner (and frame is visible) testing patch
  • hide frame when an activity is selected (todo: hide as well when resume in the palette is clicked), hide frame when a zoom level is selected testing patch

Home view

• Disable Activity icon dragging in fixed layouts
  • e.g. allows easier access to long hold of Activity icon to access palette

Neighbourhood view

• Remove primary action from AP icons (raise palette), testing patch
• Remove primary action from ad-hoc/mesh icons (raise palette), testing patch
• Remove primary action from shared activity icons (raise palette), testing patch
• Remove primary action from buddy icons (raise palette), testing patch

Journal

• Touch & hold on an entry should invoke full palette
• Dragging an entry needs to work but not prevent the touch and hold palette (if finger moves a little)
  • e.g. to copy it to another volume
  • see how it is handled in the home screen in iOS for touch & hold and the swipe gesture
• add copy option for the DOCUMENTS folder in the entry Palette and Details View Copy toolbar button
• Detail View: Erase and Duplicate tools should both raise confirmation alerts

Combobox

• Single touch of a combo should lock open it's palette and allow drag scrolling
• Should not show blank space when previous selection was near the bottom of the list
• Up/down menu/combo overflow widgets need to be larger
• test in GTK+ 3.5.10

Touch & hold '==' right click equivalent

The right click is the equivalent to touch and hold, e.g. bringing up the Palette immediately.

Visual feedback for button presses

• Generic solution - use a mouse HW cursor with alpha white 'glow' marking all primary touch events?
• Existing GTK button down highlights work well in toolbars
• Shell canvas area views
  • Use grey round rect outline for presses
    • AP icons
    • Activity icons
    • Buddy icons
    • Ad-hoc icons
  • Only really needed where there is no palette and/or primary action is too slow

Visual feedback for touch and hold

• Animated circle timer? Carlos did some work on that in GTK+, see in this video, at ~30 seconds.
• Blinking grey round rect outline

Todo (ideal)

• Palette behaviours
  • Single touch should never trigger hover content
  • Touch and hold should raise hover content
  • Touching the icon of an open palette should close the palette
    • e.g. Journal list sort palette
• Toolbar overflow widget should be same size as Sugar toolbar button icons
• Zoom to content behaviour
  • e.g. Browse
• Frame
  • Activity Zoom icon (and physical key) should act like Alt-Tab
• Home view
  • Improve layouts
    • e.g. larger Activity icon usage where possible
    • e.g. Increase separation between icons where possible
• Details view
  • Alert dialogue needed for Erase toolbar button
  • Alert dialogue needed for Duplicate toolbar button
• Accelerometer auto rotate based on rotation when laptop is in ebook mode
• Drag scrolling
  • Smooth!!
• Priorities UI redraw over other processes
  • e.g. don't stall the UI thread

Todo (polish)

• Smooth transitions/animations
• Text selection
  • Feature extensible selection palette
    • e.g. Activity specific formatting
• Home view
  • New grid layout option
• Make sure Activities and shell works well in portrait
  • e.g. toolbar button overflow in some Activities
• Pre-light hover effects (remove for touch screen input)
• hspan/vspan separators, make sure they are large enough for finger interaction
• OSK
  • Subtle key click feedback
  • Custom context
  • Custom key strips/extras based on Activity
  • Predictive text
    • Context sensitive
    • Locale sensitive
• Activity start/resume screen
  • Remove start/resume palette
  • Palette options presented in fullscreen UI, before activity pulse loader

Test

Apply patches to Sugar

• yum install gettext GConf2-devel gtk2-devel intltool perl-XML-Parser pkgconfig python pygtk2-devel
• git clone git://git.sugarlabs.org/sugar/mainline.git shell
• cd shell
• ./autogen-sh --prefix=/usr
• wget http://dev.laptop.org/~erikos/touch/0001-Make-the-palette-come-up-on-left-click-for-the-buddy.patch
• git am 0001-Make-the-palette-come-up-on-left-click-for-the-buddy.patch
• make
• sudo make install

Patches

The patches are in my public home folder. They are as well linked for the individual item they fix above. Most of them should be independent from each other, to be sure to not run into any dep issues you need to apply them in order.

Restart Sugar

If you want to be able to restart Sugar with the ctrl+alt+bksp command on the XO you can set the Option "DontZap" to "false" in the "ServerFlags" section in the xorg config file (/etc/X11/xorg.conf.d/xo1.75.conf).