QtBubbleLevel v.1.1
==========================================

This application demonstrates the integration of model made with Qt to UI 
which is made with Qt Quick. Application is compatible only with Maemo 5 with 
Qt 4.7.0 (or higher) and QtMobility 1.0.2 (or higher).


FILES
-------------------------------------------------------------------------------

src/main.cpp

- The main file of the application. In practise, creates QtMobility sensor and 
  QDeclarativeView and connects set of signals to appropriate slots. The 
  integration of QML and Qt code is done in the main function. 
  
src/taskswitcher.cpp

- Provides a minimize feature via DBus to minimize application.

src/bubblelevel.qml

- Main QML file, implements the main layout for the graphics. Contains the
  location of task switcher and exit button, also the location of glass tube
  is set here. Also contains the function which is used as slot connected in 
  main.cpp.

src/button.qml

- Implements the functionality of button with a minor press animation.

src/tube.qml

- Contains the graphics for bubble, scale, and reflection. These are drawn in
  different layers to provide effect that the bubble is inside the glass tube.
  The conversion of device inclination to bubble position is made here.

src/debian/

- The directory which contains files related to Debian (Maemo) packaging.

install/

- The compiled installation package is located here.


KNOWN ISSUES
-------------------------------------------------------------------------------

- The inclination retrieving may have a slight difference to real x-axis level
  which should be handled with calibration and error factor calculation. The
  application would need calibration feature, where the user could provide the
  right level position.


DESIGN CONSIDERATIONS
-------------------------------------------------------------------------------

  
INSTALLATION INSTRUCTIONS
-------------------------------------------------------------------------------

Mobile device (Maemo)
~~~~~~~~~~~~~~~~~~~~~
0. The Qt 4.7.0 libraries must be installed, see COMPATIBILITY
   chapter for more information about the install.

1. Copy the install/qtbubblelevel_1.1.0_armel.deb file into a
   specific folder of the device (for example "MyDocs").

2. Start the XTerm. Type "sudo gainroot" to get root access.

3. "cd" into the directory to which you copied the package (e.g. "cd MyDocs").

4. As root, install the package:
   "dpkg -i qtbubblelevel_1.1.0_armel.deb".

5. Launch the Applications menu.

6. Locate the QtBubbleLevel icon and select it to launch the application.


RUNNING THE APPLICATION
-------------------------------------------------------------------------------
Launch QtBubbleLevel on your device. The bubble in the glass tube will show the
level of the phones x-axis relative to the gravity. When the phone is tilted 20
degrees or more the bubble will be on the corresponding edge of the tube.

The application can be minimized on the upper left mark or closed on the upper
right X-mark.

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

- Maemo with Qt version 4.7.0 which is included in PR1.3. 

  1. Use Nokia Ovi Suite for updating the devices firmware to PR1.3

Tested on:

- Nokia N900


RELATED RESOURCES
-------------------------------------------------------------------------------

