/****************************************************************************
**
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
** Contact: http://www.qt-project.org/legal
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Digia.  For licensing terms and
** conditions see http://qt.digia.com/licensing.  For further information
** use the contact form at http://qt.digia.com/contact-us.
**
** GNU Free Documentation License Usage
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file.  Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: http://www.gnu.org/copyleft/fdl.html.
** $QT_END_LICENSE$
**
****************************************************************************/

/*!
    \page qcamera_example.html
    \title QCamera Demo
    \example demos/mobile/qcamera

    \brief The QCamera demo shows how to use Multimedia, Messaging and Contacts modules from Qt Mobility.

    \image qcameraexample.png

    The application shows the viewfinder picture from the device camera and allows the user to capture images. Captured images are stored into the gallery and can be sent as an MMS message to a friend. Application listens for incoming MMS messages in the Inbox folder. If the MMS message contains a picture, the application asks the user whether he or she wants to add the picture as an avatar of the sender. The person's general contact information has to exist in the device phonebook in order to store the avatar in it.

    The application uses own MyVideoSurface video surface derived from QAbstractVideoSurface for showing camera view finder pictures. A video surface presents a continuous stream of identically formatted frames.

    \snippet demos/mobile/qcamera/cameraexample.cpp 0

    The application handles Graphics Out Of Memory (GOOM) events in it's QApplication::symbianEventFilter() method.

    \snippet demos/mobile/qcamera/main.cpp 0

    \section1 Required capabilities

    Application can be self-signed.

    After enabling Qt Mobility Messaging module (MESSAGING_ENABLED flag in .pro file)
    from the project file is ReadDeviceData WriteDeviceData capabilities also needed and
    application have to be Developer Signed. Enabling Messaging adds MMS sending feature for the application.

    \section1 Compatibility

    Qt SDK 1.1

    Qt 4.7.2 for Symbian

    QtMobility 1.1.1

    Tested on: Nokia N8, Nokia E7

    Developed with:	Qt SDK 1.1


*/