Update copyright headers
[qt:qt.git] / doc / src / demos / qcamera.qdoc
1 /****************************************************************************
2 **
3 ** Copyright (C) 2015 The Qt Company Ltd.
4 ** Contact: http://www.qt.io/licensing/
5 **
6 ** This file is part of the documentation of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:FDL$
9 ** Commercial License Usage
10 ** Licensees holding valid commercial Qt licenses may use this file in
11 ** accordance with the commercial license agreement provided with the
12 ** Software or, alternatively, in accordance with the terms contained in
13 ** a written agreement between you and The Qt Company. For licensing terms
14 ** and conditions see http://www.qt.io/terms-conditions. For further
15 ** information use the contact form at http://www.qt.io/contact-us.
16 **
17 ** GNU Free Documentation License Usage
18 ** Alternatively, this file may be used under the terms of the GNU Free
19 ** Documentation License version 1.3 as published by the Free Software
20 ** Foundation and appearing in the file included in the packaging of
21 ** this file.  Please review the following information to ensure
22 ** the GNU Free Documentation License version 1.3 requirements
23 ** will be met: http://www.gnu.org/copyleft/fdl.html.
24 ** $QT_END_LICENSE$
25 **
26 ****************************************************************************/
27
28 /*!
29     \page qcamera_example.html
30     \title QCamera Demo
31     \example demos/mobile/qcamera
32
33     \brief The QCamera demo shows how to use Multimedia, Messaging and Contacts modules from Qt Mobility.
34
35     \image qcameraexample.png
36
37     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.
38
39     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.
40
41     \snippet demos/mobile/qcamera/cameraexample.cpp 0
42
43     The application handles Graphics Out Of Memory (GOOM) events in it's QApplication::symbianEventFilter() method.
44
45     \snippet demos/mobile/qcamera/main.cpp 0
46
47     \section1 Required capabilities
48
49     Application can be self-signed.
50
51     After enabling Qt Mobility Messaging module (MESSAGING_ENABLED flag in .pro file)
52     from the project file is ReadDeviceData WriteDeviceData capabilities also needed and
53     application have to be Developer Signed. Enabling Messaging adds MMS sending feature for the application.
54
55     \section1 Compatibility
56
57     Qt SDK 1.1
58
59     Qt 4.7.2 for Symbian
60
61     QtMobility 1.1.1
62
63     Tested on: Nokia N8, Nokia E7
64
65     Developed with:     Qt SDK 1.1
66
67
68 */