Qt for Symbian: MirrorHouse v0.1
===================================

This Qt C++ application demonstrates how to use QCamera from Qt Mobility Multimedia module
and make a circus style of mirror effect with it. Application shows how to manipulate 
camera frames in realtime. Touch the mirror to get use of another camera and 
try to pinch in/out mirror for zooming it.

The application handles Graphics Out Of Memory (GOOM) events in it's 
QApplication::symbianEventFilter() method. Read more about GOOM (Graphics memory handling)
from  http://wiki.forum.nokia.com/index.php/Graphics_memory_handling

Example has been tested to work on a Qt 4.7.2. and QtMobility 1.1.0 on Symbian^3.

QCamera is broken in QtMobility 1.1.1 in Qt SDK 1.1 Beta. Have to use 
older 1.1.0 version. Read more from: http://bugreports.qt.nokia.com/browse/QTMOBILITY-1315


PREREQUISITES
-------------------------------------------------------------------------------

- Qt basics.


IMPORTANT FILES/CLASSES
-------------------------------------------------------------------------------

- mirroritem.h : Custom Qt Quick QML item that shows camera picture 
- cmirrorhouse.h : Effect class
- main.qml : Main application QML file
- info.qml : Info page
- mirror.qml and flipablemirror.qml : Mirror QML item that uses mirroritem.h custom QML item

Important QtMobility classes: QCamera, QAbstractVideoSurface, QVideoSurfaceFormat 


REQUIRED CAPABILITIES
--------------------------------------------------------------------------------

Application can be self-signed.


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

QCamera is broken in QtMobility 1.1.1 in Qt SDK 1.1 Beta. Have to use 
older 1.1.0 version. 

http://bugreports.qt.nokia.com/browse/QTMOBILITY-1315


BUILD & INSTALLATION INSTRUCTIONS
-------------------------------------------------------------------------------

Preparations
~~~~~~~~~~~~
Check that you have at least the latest Qt/Qt SDK installed in the 
development environment and on the device.

Build & installation instructions using Qt SDK
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. Open mirrorhouse.pro
   File > Open File or Project, select mirrorhouse.pro.

2. Select target(s), for example 'Qt for Symbian^3 (Qt SDK)', and 
   press the Finish button.

3. Press the Run button to build the project and create the mirrorhouse.sis 
   Symbian install package. Application is installed to the device.



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

- Qt SDK 1.1. Beta
- QtMobility 1.1.0
- Qt 4.7.2

Tested on: 
- Nokia N8
- Nokia E7

Developed with:
- Qt SDK 1.1. Beta



CHANGE HISTORY
--------------------------------------------------------------------------------

0.1 First version


RELATED DOCUMENTATION
-------------------------------------------------------------------------------

GOOM (Graphics memory handling) 
http://wiki.forum.nokia.com/index.php/Graphics_memory_handling

New Qt APIs - Qt Mobility
http://qt.nokia.com/products/qt-addons/mobility

Qt for Symbian
http://qt.nokia.com/downloads

