KolibriLook
========================

KolibriLook - is a simple application for viewing and editing images.
Preinstalled picture managers in mobile devices are not so functional,
and in many cases can be used only for viewing pictures,
KolibriLook helps you to manage your pictures more comfortably.
There are two modes: viewing and editing.
Viewing mode contains only zoom function.
Editing mode includes next functions as:

      - resizing
      - rotating
      - cropping
      - black and white
      - drawing
      - history


Application is aimed to mobile devices with installed Qt platform, but also can be used for PC.

Developers: Aleksey Gagarin, Zaiceva Diana,
Petrozavodsk State University.


Build and install
-------------------------------------------------------------------------------

Preparations
~~~~~~~~~~~~
Check that Qt has been installed in the development environment and on the 
device.


Build & installation instructions for Maemo 5 Fremantle
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Setup Maemo 5 SDK development enviroment (Scratchbox)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
That is needed if you want to build the example source. Note that ready-built Debian installation qmobilepaint_1.0.0_armel.deb packages are available in 
the example package.
 
Maemo 5 SDK can be found from:
http://www.forum.nokia.com/info/sw.nokia.com/id/c05693a1-265c-4c7f-a389-fc227db4c465/Maemo_5_SDK.html
 
Installation instructions can be found from:
http://wiki.maemo.org/Documentation/Maemo5_Final_Installation

Creating a deb package
""""""""""""""""""""""
1. Launch Scratchbox.

2. Extract the files from the KolibriLook ZIP archive.

3. Go to the folder where KolibroLook.pro is located.

4. Create the .deb package:

    dpkg-buildpackage -rfakeroot -b

5. KolibriLook_xxx.deb is created.

Manual build
""""""""""""
1. Go to the folder where KolibriLook.pro is located.

2. To manually build the source, you can run the following command:

    qmake && make

3. Check that the KolibriLook binary was created.

Running in Scratchbox with Xephyr
"""""""""""""""""""""""""""""""""
1. Launch Xephyr and Scratchbox:

    Xephyr :2 -host-cursor -screen 800x480x16 -dpi 96  -kb &
    scratchbox

2. Under Scratchbox, run the following commands to use Xephyr and 
   initialise the Hildon environment:

    export DISPLAY=":2"
    af-sb-init.sh start

3. Install the .deb package:

    dpkg -i KolibriLook_xxx.deb

4. Run the application.

Setting up Qt for Maemo in the Nokia N900 device
""""""""""""""""""""""""""""""""""""""
Enabling root access:
1. Menu -> App manager -> Application manager -> Application catalogues -> Maemo Extras Devel -> Untick Disabled -> Save
2. Browse -> Application manager -> Search -> Type rootsh -> Search -> rootsh

apt-get update
apt-get install libqt4-core libqt4-gui libqt4-svg


Installing and Running on a Maemo device
""""""""""""""""""""""""""""""""""""""
Enabling root access:
1. Menu -> App manager -> Application manager -> Application catalogues -> Maemo Extras Devel -> Untick Disabled -> Save
2. Browse -> Application manager -> Search -> Type rootsh -> Search -> rootsh

Wait for the Application manager to install the application:
3. Menu -> More -> X Terminal
sudo gainroot
dpkg -i path/to/KolibriLook_xxx.deb

4. Start the application from the KolibriLook icon in the More folder in the Nokia N900 device.


COMPATIBILITY
-------------------------------------------------------------------------------

Maemo 5 with Qt 4.5.3

Tested on: Nokia N900

Developed with: Maemo 5 SDK and Qt 4.5.3





