View source for Illume keyboard
From Openmoko
You do not have permission to edit this page, for the following reasons:
You can view and copy the source of this page:
Template used on this page:
Return to Illume keyboard.
You do not have permission to edit this page, for the following reasons:
You can view and copy the source of this page:
Template used on this page:
Return to Illume keyboard.
Illume keyboard (aka Raster's Keyboard, as it has been made by user:Rasterman) is a non-predictive, optionally corrective virtual touchscreen keyboard.
The Illume keyboard is the default touchscreen keyboard in Om 2009 and SHR.
The Illume keyboard has been thought to guess the word you want to type and suggest it to you before you end typing, but to take into account the fact that since the keyboard space is little, you might have pressed a wrong key while typing.
It is intended to work with a dictionary for your language, any dictionary taken from the /usr/share/dict directory of your linux distro is ok. After you have the dictionary, the keyboard learns new words as you type them. (090809: Hopefully not my passwords and other sensitive phrases?)
The dictionary language can be changed with the top left button camouflaged/marked with upward arrow-like feature - default:
The illume keyboard layout (and corrective/guessing mode) can be changed with the top right button, camouflaged/marked with "ab"-like feature - typically:
Number and Terminal are quite self-explaining, the only interesting thing is that if you feel like changing their layout to something more comfortable to you, then read #Localization.
Default mode works like this:
Now tips and usage tricks:
You do not need to erase that much, keep in mind that the keyboard is done to correct your errors, so if you realize you pushed the wrong letter, go on typing instead of erasing.
Raster explained this in a long and detailed post, here
How to use gestures:
lists all possible words in order to choose the right one
NOTE: This install section might not be up to date for Om 2009 |
Make sure you have installed illume-config (qwerty button) and illume-config-illume
opkg install illume-config illume-config-illume
Turn off built-in qtopia keyboard:
Edit /etc/X11/Xsession.d/89qtopia and set
export QTOPIA_NO_VIRTUAL_KEYBOARD=1
Add it if it is not there.
Purge E's cache
rm -rf ~/.e/e/config/illume
Restart X
/etc/init.d/xserver-nodm restart
Then switch keyboard from "None" to "Default" in Illume's preferences.
If this does not work for your installation: See Keyboard Toggle or change /etc/enlightenment/default_profile to point to the illume profile instead of asu.
To install another layout from the list in the next section. Copy the package link and insert it instead of <layoutpackage> or via the SHR's repositories (illume-keyboard-LANG) and hopefully will be available in other repositories soon (where? Which prefix http-link?):
opkg install <layoutpackage>
E.g.:
opkg install http://www.aitel.hist.no/~helgehaf/openmoko/illume-keyboards-norwegian-no_0.1_all.ipk
icon | type (mode) | package | comments |
---|---|---|---|
![]() |
alphanumeric | Arabic QWERTY layout | optimized for arabic alphanumeric layout. |
![]() |
terminal | English QWERTY layout | Installed by default. |
![]() |
terminal | Dutch QWERTY layout | Based upon QWERTY terminal layout, optimised for Dutch, usable for most north-western European languages. |
![]() |
terminal | French AZERTY layout | Based upon QWERTY terminal layout. TODO: Icon needs AZERTY overlay. |
![]() |
terminal | Norwegian QWERTY layout | Based upon QWERTY terminal layout. |
![]() |
terminal | Russian ЙЦУКЕН layout | Based upon QWERTY terminal layout. |
![]() |
terminal | Dvorak layout | Based upon QWERTY terminal layout. |
![]() |
alphanumeric | English QWERTY layout | Installed by default. |
![]() |
alphanumeric | English finger friendly QWERTY layout | Based upon QWERTY alphanumeric layout. |
![]() |
alphanumeric | Hebrew פםןךטא layout | In case there are squares instead of Hebrew letters, change illume's font. |
![]() |
alphanumeric | Danish QWERTY layout | Based upon QWERTY alphanumeric layout. |
![]() |
alphanumeric | German QWERTZ layout | Based upon QWERTY alphanumeric layout. |
![]() |
alphanumeric | Basic Neo 2.0 layout | Based upon German QWERTZ layout. Only first layer (letters). |
![]() |
alphanumeric | Perisan QWERTZ layout | Based upon QWERTY alphanumeric layout. TODO: Create new icon for the Persian alphabet of پﺏﺍ like the transparent ABC. |
![]() |
numeric | Numeric layout | Installed by default. |
![]() |
numeric | Alternative finger friendly numeric layout | Major improvement on numeric layout. |
![]() |
numeric | Finger friendly browse layout | Derived from numeric layout. |
NOTE: They are all available from SHR's repositories (illume-keyboard-LANG) and hopefully will be available in other repos soon.
Icons are created by hand in a 25x25 PNG with the GIMP according to color picker values of flags in Wikipedia. The reason for this is, that no rescaling or ant-alias artifacts will emerge in this small raster. Subsequently, import this in Inkscape and type the characters. Note that for keyboard layout that are not connected to a single particular country, like Persian, no flag backgrouns is needed. Each character is typed twice in Arial Black or bold Arial. For alphanumeric, use the ABC of that language, for 'QWERTY' use the 6 first characters on the top row, note that for languages that read from richt to left is to use 'first'/last 6 characters on the right side. One characters is white with a black border of 0.5 and one is black without border but with a blur of 15 (see CTRL+SHIFT+F slider at the bottom). Reposition the whole lot and put everything in the correct layer. Export a 25x25 PNG with the background bitmap, which is also the selected export area, and you are done. Here is a video of this procedure.
TODO: Rasterman, can you verify this and improve this procedure where needed? Especially improve details on which font to use and which Gaussian blur to use.
NOTE: This install section might not be up to date for Om 2009 |
/usr/lib/enlightenment/modules/illume/keyboards
killall -HUP enlightenment
/etc/init.d/xserver-nodm restart
##KBDCONF-1.0 kbd 450 150 # keyboard type e.g. TERMINAL, ALPHA (this one shows up when writing an sms), NUMERIC, SYMBOL type TERMINAL # an icon for the keyboard so you know which one you have icon qwerty.png #key x-coordinate y-coordinate width-of-key height-of-key #columns: #state symbol(shown on the key) keysym(output of the key) key 0 0 30 30 normal ` grave shift ~ asciitilde capslock ` grave
a list of keysyms can be found here
Note: the keyboard layout must start with "##KBDCONF-1.0". Do not add comments before this line.
/usr/share/myspell/dictsJust copy it over to
/usr/lib/enlightenment/modules/illume/dicts/on your phone. Now you should be able to select it via the dictionary selector on the illume keyboard. The drawback is that they don't come with predefined frequency values though, so predictions won't be very good at first until illume has learned by usage. Still a "dumb" dictionary in your own language should work much better than a smart English one for non-english texts.
The Terminal layout has an empty dictionary. The words you type are entered automatically in the dictionary.
To add another language you have to do the following steps:
On Debian/Ubuntu systems, it is located in /usr/share/dict Here is a Portuguese dictionary for OpenMoko’s Illume keyboard.
To add a dictionary you can find them by typing :
apt-cache search wordlist|grep ^w|sort
and install it on your computer with :
apt-get install wfrench # (replace french with your language)
for example do :
scp /usr/share/dict/french root@192.168.0.202:/usr/lib/enlightenment/modules/illume/dicts/French.dic