Qt for Maemo: Animation Example 
-------------------------------

This Qt example application demonstrates how easily you can use the Qt 
Animation Framework to create animations and transitions for Qt applications.

The example has been tested to work on the Nokia N900 (Qt for Maemo TP2), 
Nokia N97, and Nokia X6 (Qt for Symbian 4.6).

--------------------------------------------------------------------------------

PREREQUISITES 

Qt basics 

--------------------------------------------------------------------------------

REQUIRED CAPABILITIES 

None

--------------------------------------------------------------------------------

KNOWN ISSUES 

- Previous [<<] and Next [>>] buttons on the Image view are not implemented.
- Images are currently bundled within the application binary. The 
  implementation can easily be improved by adding the possibility of browsing 
  the device file system and selecting the folder where images are retrieved.
- For animations with greater performance demands, use QGraphicsView
  [see the Qt documentation for more details].
- Image size in Image view is hard coded  no scaling functionality implemented.
   
-------------------------------------------------------------------------------- 

RUNNING THE EXAMPLE 

There are two views in the application:   

- File view - Presents the list of available images
- Image view - Presents the image selected from the File view

Select the image by tapping it once. You can return to the File view from the 
Image view by pressing the 'Back' button on the toolbar.

The toolbar can be shown/hidden by tapping anywhere on the Image view screen.
      
--------------------------------------------------------------------------------

BUILD & INSTALLATION INSTRUCTIONS FOR MAEMO 5 FREMANTLE 

You need Maemo 5 SDK, Scratchbox, and Qt for Maemo installed to build the 
example source.

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


Building the source
""""""""""""""""""" 
1. Launch Scratchbox. 
 
2. Extract the files from the QImageViewer ZIP archive. 
 
3. Go to the folder where QImageViewer.pro is located.

	qmake
	make

Select the target (ARMEL/X86) with 'sb-menu' before executing 'qmake/make' 
depending on whether you are building for emulator (Xephyr) or device.

Running in Scratchbox with Xephyr (running example in emulator) 
""""""""""""""""""""""""""""""""" 
1. Launch Xephyr and Scratchbox: 

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

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 QImageViewer.deb 

4. Start the application from the QtImageViewer icon in the 'More' folder in 
   the emulator.

Setting up Qt for Maemo on the Nokia N900 device 
"""""""""""""""""""""""""""""""""""""""""""""""" 
Enabling root access:
1. Activate Extras-devel
        Application manager > Application catalogs > New
        Catalog name: Maemo Extras-devel
        Web address: http://repository.maemo.org/extras-devel
        Distribution: fremantle
        Components: free non-free

Before clicking 'Save', ensure that the catalogue it's not disabled!
2. Browse > Application manager > Search > Type rootsh > Search > rootsh

Wait for the Application manager to install the application. Then use the 
terminal to install Qt libraries.

3. Menu > More > X Terminal

sudo gainroot
apt-get update
apt-get install libqt4-maemo5-gui
 
 
Installing and Running on a Maemo device 
"""""""""""""""""""""""""""""""""""""" 
Enabling root access:
1. Activate Extras-devel
        Application manager > Application catalogs > New
        Catalog name: Maemo Extras-devel
        Web address: http://repository.maemo.org/extras-devel
        Distribution: fremantle
        Components: free non-free
 
Before clicking 'Save', ensure that the catalogue is not disabled!
2. Browse > Application manager > Search > Type rootsh > Search > rootsh

Wait for the Application manager to install the application.

3. Transfer the 'QtImageViewer.deb' package to the Nokia N900 device.

4. Use the terminal to install the application: 

Menu > More > X Terminal

sudo gainroot
dpkg -i path/to/QtImageViewer.deb

5. Start the application from the QtImageViewer icon in the 'More' folder on 
   the Nokia N900 device.

For more instructions on how to set up the Maemo 5 SDK / Scratchbox / 
Qt for Maemo, please see:
http://www.forum.nokia.com/Technology_Topics/Device_Platforms/Maemo.xhtml
http://qt.nokia.com [Qt documentation]


BUILD & INSTALLATION INSTRUCTIONS FOR SYMBIAN

You need S60 SDK, Carbide C++, and Qt for Symbian installed to build the 
example source:

1. Extract the files from the QImageViewer ZIP archive. 
 
2. Go to the folder where QImageViewer.pro is located.

3. Open the command prompt (make sure your Qt for Symbian 'bin' folder is in 
   PATH):

	qmake
	make debug-winscw [for emulator]
	make release-gcce [for device]

4. To create a SIS package for the device (make sure your device has an active 
   connection to your PC with the Nokia PC Suite):

createpackage -i QtImageViewer_template.pkg release-gcce

5. Start the application from the QtImageViewer icon in the 'Applications' 
   folder on the device.

For more instructions on how to set up the S60 SDK / Qt for Symbian, please see:
http://www.forum.nokia.com/Tools_Docs_and_Code/Tools/Platforms/S60_Platform_SDKs/
http://qt.nokia.com [Qt documentation]	


BUILD & INSTALLATION INSTRUCTIONS FOR WINDOWS / LINUX / MAC OS

You need Qt SDK installed to build the example source:

1. Extract the files from the QImageViewer ZIP archive. 

2. Go to the folder where QImageViewer.pro is located.

	qmake
	make

For instructions on how to set up Qt for your platform, please see: 
http://qt.nokia.com [Qt documentation]

--------------------------------------------------------------------------------

COMPATIBILITY 

Qt 4.6 (for Maemo Technology Preview 2) [http://qt.nokia.com/downloads].

Tested on the Nokia N97 mini, Nokia X6, Nokia N900, Ubuntu, Windows 7, and 
MacOS.

Developed and tested using Qt for Maemo 4.6 Technology Preview 2, Qt Creator.