Illume
From Openmoko
m |
|||
| (84 intermediate revisions by 32 users not shown) | |||
| Line 1: | Line 1: | ||
{{Om 2008.8}} | {{Om 2008.8}} | ||
| − | il·lume (ĭ-lōōm') tr.v. To illuminate. | + | il·lume (ĭ-lōōm') tr.v. To illuminate. |
Bringing light to the darkness of the mobile world. | Bringing light to the darkness of the mobile world. | ||
=Introduction= | =Introduction= | ||
| − | Illume is a module for | + | [http://illume.projects.openmoko.org/ Illume] is a module for [http://www.enlightenment.org Enlightenment] that modifies the user interface of enlightenment to work cleanly and nicely on a mobile device - such as an Openmoko phone. It is currently geared more for a 480x640 (VGA) portrait mode screen but can be trivially modified to work on QVGA or any other resolution. The Final goal is to have it work on a wide range of resolutions seamlessly. |
| − | + | [[Image:Illume-Keyboard-Screenshot.png]] | |
| − | + | It combines an application launcher interface along with an application manager and switcher, virtual keyboard support, as well as forcing certain simple layout policies on applications (such as making their main windows borderless and fullscreen except for Illume's control bar), as well as support for the X11 port of qtopia. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
=Getting Started= | =Getting Started= | ||
| − | |||
| − | + | Here is how to get started and install Illume on your desktop and try it out. This would also allow development on it, adding features you need and testing them. For this you will want code. First you will want Enlightenment's latest and greatest. How much do you want? You can get the whole repository, or just the bits you need. If you want the whole thing in one checkout, please see http://svn.enlightenment.org for information. If you want to just get a quick script that does it for you try http://www.rasterman.com/files/get_e.sh - this script will check out only the bits of SVN you need. It also assumes you have sudo root access and if on [http://www.ubuntu.com/ Ubuntu] or [[Debian]] it will try and install packages known to be needed for building, or useful. Read the script if you are not sure. If it doesn't know what distribution you use, you will need to try and have a working compiler, autotools etc. etc. yourself. Once you have run this and built and installed everything you will need illume, so fetch it with: | |
| − | + | ||
| − | + | <pre> | |
| + | svn checkout http://svn.enlightenment.org/svn/e/trunk/e/src/modules/illume/ | ||
| + | </pre> | ||
| + | |||
| + | Now you just need to build it like everything else. (it is assumed you know about CFLAGS, LDFLAGS, PKG_CONFIG_PATH, PATH etc. in installing software and compiling it). Illume compiles like everything else in E land - standard autotools, so (in Illume's source directory): | ||
| + | |||
| + | <pre> | ||
| + | ./autogen.sh | ||
| + | make | ||
| + | sudo make install | ||
| + | </pre> | ||
| + | |||
| + | This will compile and install Illume. As Illume is a module, not a program in its own right, you need to run it with Enlightenment, so use the provided run-script: | ||
| + | |||
| + | <pre> | ||
| + | ./x-ui.sh | ||
| + | </pre> | ||
| + | |||
| + | and if you have [[Getting Openmoko working on host with Xephyr|Xephyr]] installed and everything went ok, a 480x640 window will pop up - with Enlightenment in it on your DISPLAY=:1 X display with all your system's app icons there. | ||
| + | |||
| + | =Slipshelf= | ||
| + | |||
| + | The bar at the top | ||
| + | |||
| + | =Gadgets= | ||
| + | |||
| + | The gadgets in the Slipshelf | ||
| + | |||
| + | =Launcher= | ||
| + | |||
| + | The icons you see on the desktop | ||
| + | |||
| + | =Virtual Touchscreen Illume Keyboard= | ||
| + | {{Main|Illume keyboard}} | ||
| + | |||
| + | =Configuration= | ||
| + | |||
| + | How to configure illume via its own config dialog | ||
| + | |||
| + | =Dbus= | ||
| + | |||
| + | What is this [[dbus]] goop? | ||
| + | |||
| + | = See also = | ||
| + | |||
| + | Raster explains mostly everything in [http://lists.openmoko.org/pipermail/community/2009-January/038836.html this] and [http://lists.openmoko.org/pipermail/community/2009-January/039125.html that] thread. We still need a good synthesis though. | ||
| − | + | = Issues = | |
| + | * no support for freedesktop systray specifications [http://trac.enlightenment.org/e/ticket/455 bug# 455] | ||
| + | * no support for EWMH (it seems only _NET_ACTIVE_WINDOW is working) [http://trac.enlightenment.org/e/ticket/456 bug# 456] | ||
| + | * X11-16 broken and suggested as being unusable [http://trac.enlightenment.org/e/ticket/454 bug# 454] | ||
| + | * keyboard doesn't work in landscape mode (disabling/enabling keyboard (in one go) in settings works around it) [http://trac.enlightenment.org/e/ticket/358 bug# 358] | ||
| + | * no support for subfolders [http://trac.enlightenment.org/e/ticket/457 bug# 457] | ||
| + | * if no keyboard is selected, no application can work in full screen [http://trac.enlightenment.org/e/ticket/398 bug# 398] | ||
| − | + | ''please correct the above if wrong a/o add workarounds'' | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | |||
[[Category:Om 2008.8]] | [[Category:Om 2008.8]] | ||
| + | [[Category:Middleware]] | ||
Latest revision as of 09:42, 14 September 2011
Om 2008
il·lume (ĭ-lōōm') tr.v. To illuminate.
Bringing light to the darkness of the mobile world.
Contents |
[edit] Introduction
Illume is a module for Enlightenment that modifies the user interface of enlightenment to work cleanly and nicely on a mobile device - such as an Openmoko phone. It is currently geared more for a 480x640 (VGA) portrait mode screen but can be trivially modified to work on QVGA or any other resolution. The Final goal is to have it work on a wide range of resolutions seamlessly.
It combines an application launcher interface along with an application manager and switcher, virtual keyboard support, as well as forcing certain simple layout policies on applications (such as making their main windows borderless and fullscreen except for Illume's control bar), as well as support for the X11 port of qtopia.
[edit] Getting Started
Here is how to get started and install Illume on your desktop and try it out. This would also allow development on it, adding features you need and testing them. For this you will want code. First you will want Enlightenment's latest and greatest. How much do you want? You can get the whole repository, or just the bits you need. If you want the whole thing in one checkout, please see http://svn.enlightenment.org for information. If you want to just get a quick script that does it for you try http://www.rasterman.com/files/get_e.sh - this script will check out only the bits of SVN you need. It also assumes you have sudo root access and if on Ubuntu or Debian it will try and install packages known to be needed for building, or useful. Read the script if you are not sure. If it doesn't know what distribution you use, you will need to try and have a working compiler, autotools etc. etc. yourself. Once you have run this and built and installed everything you will need illume, so fetch it with:
svn checkout http://svn.enlightenment.org/svn/e/trunk/e/src/modules/illume/
Now you just need to build it like everything else. (it is assumed you know about CFLAGS, LDFLAGS, PKG_CONFIG_PATH, PATH etc. in installing software and compiling it). Illume compiles like everything else in E land - standard autotools, so (in Illume's source directory):
./autogen.sh make sudo make install
This will compile and install Illume. As Illume is a module, not a program in its own right, you need to run it with Enlightenment, so use the provided run-script:
./x-ui.sh
and if you have Xephyr installed and everything went ok, a 480x640 window will pop up - with Enlightenment in it on your DISPLAY=:1 X display with all your system's app icons there.
[edit] Slipshelf
The bar at the top
[edit] Gadgets
The gadgets in the Slipshelf
[edit] Launcher
The icons you see on the desktop
[edit] Virtual Touchscreen Illume Keyboard
- Main article: Illume keyboard
[edit] Configuration
How to configure illume via its own config dialog
[edit] Dbus
What is this dbus goop?
[edit] See also
Raster explains mostly everything in this and that thread. We still need a good synthesis though.
[edit] Issues
- no support for freedesktop systray specifications bug# 455
- no support for EWMH (it seems only _NET_ACTIVE_WINDOW is working) bug# 456
- X11-16 broken and suggested as being unusable bug# 454
- keyboard doesn't work in landscape mode (disabling/enabling keyboard (in one go) in settings works around it) bug# 358
- no support for subfolders bug# 457
- if no keyboard is selected, no application can work in full screen bug# 398
please correct the above if wrong a/o add workarounds
