<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qcamera.qdoc -->
<title>Qt 4.8: QCamera Demo</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li><a href="all-examples.html">Examples</a></li>
<li>QCamera Demo</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#required-capabilities">Required capabilities</a></li>
<li class="level1"><a href="#compatibility">Compatibility</a></li>
</ul>
</div>
<h1 class="title">QCamera Demo</h1>
<span class="subtitle"></span>
<!-- $$$demos/mobile/qcamera-description -->
<div class="descr"> <a name="details"></a>
<p>Files:</p>
<ul>
<li><a href="demos-mobile-qcamera-businesscardhandling-cpp.html">demos/mobile/qcamera/businesscardhandling.cpp</a></li>
<li><a href="demos-mobile-qcamera-businesscardhandling-h.html">demos/mobile/qcamera/businesscardhandling.h</a></li>
<li><a href="demos-mobile-qcamera-button-cpp.html">demos/mobile/qcamera/button.cpp</a></li>
<li><a href="demos-mobile-qcamera-button-h.html">demos/mobile/qcamera/button.h</a></li>
<li><a href="demos-mobile-qcamera-cameraexample-cpp.html">demos/mobile/qcamera/cameraexample.cpp</a></li>
<li><a href="demos-mobile-qcamera-cameraexample-h.html">demos/mobile/qcamera/cameraexample.h</a></li>
<li><a href="demos-mobile-qcamera-contactsdlg-cpp.html">demos/mobile/qcamera/contactsdlg.cpp</a></li>
<li><a href="demos-mobile-qcamera-contactsdlg-h.html">demos/mobile/qcamera/contactsdlg.h</a></li>
<li><a href="demos-mobile-qcamera-messagehandling-cpp.html">demos/mobile/qcamera/messagehandling.cpp</a></li>
<li><a href="demos-mobile-qcamera-messagehandling-h.html">demos/mobile/qcamera/messagehandling.h</a></li>
<li><a href="demos-mobile-qcamera-icons-cameramms-icon-svg.html">demos/mobile/qcamera/icons/cameramms_icon.svg</a></li>
<li><a href="demos-mobile-qcamera-main-cpp.html">demos/mobile/qcamera/main.cpp</a></li>
<li><a href="demos-mobile-qcamera-qcamera-pro.html">demos/mobile/qcamera/qcamera.pro</a></li>
<li><a href="demos-mobile-qcamera-resources-qrc.html">demos/mobile/qcamera/resources.qrc</a></li>
</ul>
<p>The QCamera demo shows how to use Multimedia, Messaging and Contacts modules from Qt Mobility.<p class="centerAlign"><img src="images/qcameraexample.png" alt="" /></p><p>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.</p>
<p>The application uses own MyVideoSurface video surface derived from <a href="qabstractvideosurface.html">QAbstractVideoSurface</a> for showing camera view finder pictures. A video surface presents a continuous stream of identically formatted frames.</p>
<pre class="cpp"> <span class="type">QMediaService</span><span class="operator">*</span> ms <span class="operator">=</span> m_camera<span class="operator">-</span><span class="operator">></span>service();
<span class="type">QVideoRendererControl</span><span class="operator">*</span> vrc <span class="operator">=</span> ms<span class="operator">-</span><span class="operator">></span>requestControl<span class="operator"><</span><span class="type">QVideoRendererControl</span><span class="operator">*</span><span class="operator">></span>();
m_myVideoSurface <span class="operator">=</span> <span class="keyword">new</span> MyVideoSurface(<span class="keyword">this</span><span class="operator">,</span><span class="keyword">this</span><span class="operator">,</span><span class="keyword">this</span>);
vrc<span class="operator">-</span><span class="operator">></span>setSurface(m_myVideoSurface);</pre>
<p>The application handles Graphics Out Of Memory (GOOM) events in it's <a href="qapplication.html#symbianEventFilter">QApplication::symbianEventFilter</a>() method.</p>
<pre class="cpp"> <span class="type">bool</span> symbianEventFilter( <span class="keyword">const</span> <span class="type"><a href="qsymbianevent.html">QSymbianEvent</a></span><span class="operator">*</span> symbianEvent )
{
<span class="keyword">const</span> TWsEvent <span class="operator">*</span>event <span class="operator">=</span> symbianEvent<span class="operator">-</span><span class="operator">></span>windowServerEvent();
<span class="keyword">if</span> ( <span class="operator">!</span>event ) {
<span class="keyword">return</span> <span class="keyword">false</span>;
}
<span class="keyword">switch</span> ( event<span class="operator">-</span><span class="operator">></span>Type() ) {
<span class="comment">// GOOM handling enabled</span>
<span class="comment">// http://wiki.forum.nokia.com/index.php/Graphics_memory_handling</span>
<span class="keyword">case</span> EEventUser: {
TApaSystemEvent<span class="operator">*</span> eventData <span class="operator">=</span> <span class="keyword">reinterpret_cast</span><span class="operator"><</span>TApaSystemEvent<span class="operator">*</span><span class="operator">></span>(event<span class="operator">-</span><span class="operator">></span>EventData());
<span class="keyword">if</span> ((<span class="operator">*</span>eventData) <span class="operator">=</span><span class="operator">=</span> EApaSystemEventShutdown) {
eventData<span class="operator">+</span><span class="operator">+</span>;
<span class="keyword">if</span> ((<span class="operator">*</span>eventData) <span class="operator">=</span><span class="operator">=</span> KGoomMemoryLowEvent) {
<span class="keyword">return</span> <span class="keyword">true</span>;
}
}
<span class="keyword">break</span>;
}
<span class="keyword">default</span>:
<span class="keyword">break</span>;
};
<span class="comment">// Always return false so we don't stop</span>
<span class="comment">// the event from being processed</span>
<span class="keyword">return</span> <span class="keyword">false</span>;
}</pre>
<a name="required-capabilities"></a>
<h2>Required capabilities</h2>
<p>Application can be self-signed.</p>
<p>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.</p>
<a name="compatibility"></a>
<h2>Compatibility</h2>
<p>Qt SDK 1.1</p>
<p>Qt 4.7.2 for Symbian</p>
<p>QtMobility 1.1.1</p>
<p>Tested on: Nokia N8, Nokia E7</p>
<p>Developed with: Qt SDK 1.1</p>
</div>
<!-- @@@demos/mobile/qcamera -->
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2015 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
The documentation provided herein is licensed under the terms of the
<a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
License version 1.3</a> as published by the Free Software Foundation.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Qt and respective logos are trademarks of The Qt Company Ltd
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
