<?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" />
<!-- qcameraimagecapture.cpp -->
<title>Qt Mobility 1.2: QCameraImageCapture Class Reference</title>
<link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
<div class="content">
<a href="index.html" class="qtref"><span>QtMobility Reference Documentation</span></a>
</div>
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li><a href="modules.html">Modules</a></li>
<li><a href="qtmultimediakit.html">QtMultimediaKit</a></li>
<li>QCameraImageCapture</li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#public-types">Public Types</a></li>
<li class="level1"><a href="#properties">Properties</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#public-slots">Public Slots</a></li>
<li class="level1"><a href="#signals">Signals</a></li>
<li class="level1"><a href="#protected-functions">Protected Functions</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QCameraImageCapture Class Reference</h1>
<!-- $$$QCameraImageCapture-brief -->
<p>The QCameraImageCapture class is used for the recording of media content. <a href="#details">More...</a></p>
<!-- @@@QCameraImageCapture -->
<pre class="cpp"> <span class="preprocessor">#include <QCameraImageCapture></span></pre><p><b>Inherits: </b><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a> and <a href="qmediabindableinterface.html">QMediaBindableInterface</a>.</p>
<p>This class was introduced in Qt Mobility 1.1.</p>
<ul>
<li><a href="qcameraimagecapture-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-types"></a>
<h2>Public Types</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#CaptureDestination-enum">CaptureDestination</a></b> { CaptureToFile, CaptureToBuffer }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> flags </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#CaptureDestination-enum">CaptureDestinations</a></b></td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#DriveMode-enum">DriveMode</a></b> { SingleImageCapture }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#Error-enum">Error</a></b> { NoError, NotReadyError, ResourceError, NotSupportedFeatureError, FormatError, OutOfSpaceError }</td></tr>
</table>
<a name="properties"></a>
<h2>Properties</h2>
<ul>
<li class="fn"><b><a href="qcameraimagecapture.html#readyForCapture-prop">readyForCapture</a></b> : const bool</li>
</ul>
<ul>
<li class="fn">1 property inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#properties">QObject</a></li>
</ul>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#QCameraImageCapture">QCameraImageCapture</a></b> ( QMediaObject * <i>mediaObject</i>, QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#dtor.QCameraImageCapture">~QCameraImageCapture</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QtMultimediaKit::AvailabilityError </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#availabilityError">availabilityError</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QVideoFrame::PixelFormat </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#bufferFormat">bufferFormat</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> CaptureDestinations </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#captureDestination">captureDestination</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QImageEncoderSettings </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#encodingSettings">encodingSettings</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Error </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#error">error</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#errorString">errorString</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#imageCodecDescription">imageCodecDescription</a></b> ( const QString & <i>codec</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#isAvailable">isAvailable</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#isCaptureDestinationSupported">isCaptureDestinationSupported</a></b> ( CaptureDestinations <i>destination</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#readyForCapture-prop">isReadyForCapture</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#setBufferFormat">setBufferFormat</a></b> ( QVideoFrame::PixelFormat <i>format</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#setCaptureDestination">setCaptureDestination</a></b> ( CaptureDestinations <i>destination</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#setEncodingSettings">setEncodingSettings</a></b> ( const QImageEncoderSettings & <i>settings</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QVideoFrame::PixelFormat> </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#supportedBufferFormats">supportedBufferFormats</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#supportedImageCodecs">supportedImageCodecs</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QSize> </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#supportedResolutions">supportedResolutions</a></b> ( const QImageEncoderSettings & <i>settings</i> = QImageEncoderSettings(), bool * <i>continuous</i> = 0 ) const</td></tr>
</table>
<a name="reimplemented-public-functions"></a>
<h2>Reimplemented Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual QMediaObject * </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#mediaObject">mediaObject</a></b> () const</td></tr>
</table>
<ul>
<li class="fn">29 public functions inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-functions">QObject</a></li>
<li class="fn">1 public function inherited from <a href="qmediabindableinterface.html#public-functions">QMediaBindableInterface</a></li>
</ul>
<a name="public-slots"></a>
<h2>Public Slots</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#cancelCapture">cancelCapture</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#capture">capture</a></b> ( const QString & <i>file</i> = QString() )</td></tr>
</table>
<ul>
<li class="fn">1 public slot inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-slots">QObject</a></li>
</ul>
<a name="signals"></a>
<h2>Signals</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#bufferFormatChanged">bufferFormatChanged</a></b> ( QVideoFrame::PixelFormat <i>format</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#captureDestinationChanged">captureDestinationChanged</a></b> ( QCameraImageCapture::CaptureDestinations <i>destination</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#error-2">error</a></b> ( int <i>id</i>, QCameraImageCapture::Error <i>error</i>, const QString & <i>errorString</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#imageAvailable">imageAvailable</a></b> ( int <i>id</i>, const QVideoFrame & <i>buffer</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#imageCaptured">imageCaptured</a></b> ( int <i>id</i>, const QImage & <i>preview</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#imageExposed">imageExposed</a></b> ( int <i>id</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#imageMetadataAvailable">imageMetadataAvailable</a></b> ( int <i>id</i>, QtMultimediaKit::MetaData <i>key</i>, const QVariant & <i>value</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#imageMetadataAvailable-2">imageMetadataAvailable</a></b> ( int <i>id</i>, const QString & <i>key</i>, const QVariant & <i>value</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#imageSaved">imageSaved</a></b> ( int <i>id</i>, const QString & <i>fileName</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#readyForCaptureChanged">readyForCaptureChanged</a></b> ( bool <i>ready</i> )</td></tr>
</table>
<ul>
<li class="fn">1 signal inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#signals">QObject</a></li>
</ul>
<a name="reimplemented-protected-functions"></a>
<h2>Reimplemented Protected Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qcameraimagecapture.html#setMediaObject">setMediaObject</a></b> ( QMediaObject * <i>mediaObject</i> )</td></tr>
</table>
<ul>
<li class="fn">7 protected functions inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#protected-functions">QObject</a></li>
<li class="fn">1 protected function inherited from <a href="qmediabindableinterface.html#protected-functions">QMediaBindableInterface</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">1 public variable inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-variables">QObject</a></li>
<li class="fn">4 static public members inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#static-public-members">QObject</a></li>
<li class="fn">7 protected functions inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#protected-functions">QObject</a></li>
<li class="fn">1 protected function inherited from <a href="qmediabindableinterface.html#protected-functions">QMediaBindableInterface</a></li>
<li class="fn">2 protected variables inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#protected-variables">QObject</a></li>
</ul>
<a name="details"></a>
<!-- $$$QCameraImageCapture-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QCameraImageCapture class is used for the recording of media content.</p>
<p>The QCameraImageCapture class is a high level images recording class. It's not intended to be used alone but for accessing the media recording functions of other media objects, like <a href="qcamera.html">QCamera</a>.</p>
<pre class="cpp"> camera <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qcamera.html">QCamera</a></span>;
viewfinder <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qcameraviewfinder.html">QCameraViewfinder</a></span>();
viewfinder<span class="operator">-</span><span class="operator">></span>show();
camera<span class="operator">-</span><span class="operator">></span>setViewfinder(viewfinder);
recorder <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qmediarecorder.html">QMediaRecorder</a></span>(camera);
imageCapture <span class="operator">=</span> <span class="keyword">new</span> <span class="type">QCameraImageCapture</span>(camera);
camera<span class="operator">-</span><span class="operator">></span>setCaptureMode(<span class="type"><a href="qcamera.html">QCamera</a></span><span class="operator">::</span>CaptureStillImage);
camera<span class="operator">-</span><span class="operator">></span>start();
<span class="comment">//on half pressed shutter button</span>
camera<span class="operator">-</span><span class="operator">></span>searchAndLock();
<span class="comment">//on shutter button pressed</span>
imageCapture<span class="operator">-</span><span class="operator">></span>capture();
<span class="comment">//on shutter button released</span>
camera<span class="operator">-</span><span class="operator">></span>unlock();</pre>
</div>
<p><b>See also </b><a href="qcamera.html">QCamera</a>.</p>
<!-- @@@QCameraImageCapture -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$CaptureDestination$$$CaptureToFile$$$CaptureToBuffer -->
<h3 class="flags"><a name="CaptureDestination-enum"></a>enum QCameraImageCapture::<span class="name">CaptureDestination</span><br/>flags QCameraImageCapture::<span class="name">CaptureDestinations</span></h3>
<p>The CaptureDestinations type is a typedef for <a href="qflags.html">QFlags</a><CaptureDestination>. It stores an OR combination of CaptureDestination values.</p>
<!-- @@@CaptureDestination -->
<!-- $$$DriveMode$$$SingleImageCapture -->
<h3 class="fn"><a name="DriveMode-enum"></a>enum QCameraImageCapture::<span class="name">DriveMode</span></h3>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QCameraImageCapture::SingleImageCapture</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">Drive mode is capturing a single picture.</td></tr>
</table>
<!-- @@@DriveMode -->
<!-- $$$Error$$$NoError$$$NotReadyError$$$ResourceError$$$OutOfSpaceError$$$NotSupportedFeatureError$$$FormatError -->
<h3 class="fn"><a name="Error-enum"></a>enum QCameraImageCapture::<span class="name">Error</span></h3>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QCameraImageCapture::NoError</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">No Errors.</td></tr>
<tr><td class="topAlign"><tt>QCameraImageCapture::NotReadyError</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">The service is not ready for capture yet.</td></tr>
<tr><td class="topAlign"><tt>QCameraImageCapture::ResourceError</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">Device is not ready or not available.</td></tr>
<tr><td class="topAlign"><tt>QCameraImageCapture::NotSupportedFeatureError</tt></td><td class="topAlign"><tt>4</tt></td><td class="topAlign">Device does not support stillimages capture.</td></tr>
<tr><td class="topAlign"><tt>QCameraImageCapture::FormatError</tt></td><td class="topAlign"><tt>5</tt></td><td class="topAlign">Current format is not supported.</td></tr>
<tr><td class="topAlign"><tt>QCameraImageCapture::OutOfSpaceError</tt></td><td class="topAlign"><tt>3</tt></td><td class="topAlign">No space left on device.</td></tr>
</table>
<!-- @@@Error -->
</div>
<div class="prop">
<h2>Property Documentation</h2>
<!-- $$$readyForCapture-prop$$$isReadyForCapture$$$readyForCaptureChangedbool -->
<h3 class="fn"><a name="readyForCapture-prop"></a><span class="name">readyForCapture</span> : const <span class="type">bool</span></h3>
<p>Indicates the service is ready to capture a an image immediately.</p>
<p>This property was introduced in Qt Mobility 1.1.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>isReadyForCapture</b></span> () const</td></tr>
</table>
<p><b>Notifier signal:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b><a href="qcameraimagecapture.html#readyForCaptureChanged">readyForCaptureChanged</a></b></span> ( bool <i>ready</i> )</td></tr>
</table>
<!-- @@@readyForCapture -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QCameraImageCapture[overload1]$$$QCameraImageCaptureQMediaObject*QObject* -->
<h3 class="fn"><a name="QCameraImageCapture"></a>QCameraImageCapture::<span class="name">QCameraImageCapture</span> ( <span class="type"><a href="qmediaobject.html">QMediaObject</a></span> * <i>mediaObject</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> * <i>parent</i> = 0 )</h3>
<p>Constructs a media recorder which records the media produced by <i>mediaObject</i>.</p>
<p>The <i>parent</i> is passed to <a href="qmediaobject.html">QMediaObject</a>.</p>
<!-- @@@QCameraImageCapture -->
<!-- $$$~QCameraImageCapture[overload1]$$$~QCameraImageCapture -->
<h3 class="fn"><a name="dtor.QCameraImageCapture"></a>QCameraImageCapture::<span class="name">~QCameraImageCapture</span> ()</h3>
<p>Destroys images capture object.</p>
<!-- @@@~QCameraImageCapture -->
<!-- $$$availabilityError[overload1]$$$availabilityError -->
<h3 class="fn"><a name="availabilityError"></a><span class="type"><a href="qtmultimediakit.html#AvailabilityError-enum">QtMultimediaKit::AvailabilityError</a></span> QCameraImageCapture::<span class="name">availabilityError</span> () const</h3>
<p>Returns the availability error code.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@availabilityError -->
<!-- $$$bufferFormat[overload1]$$$bufferFormat -->
<h3 class="fn"><a name="bufferFormat"></a><span class="type"><a href="qvideoframe.html#PixelFormat-enum">QVideoFrame::PixelFormat</a></span> QCameraImageCapture::<span class="name">bufferFormat</span> () const</h3>
<p>Returns the buffer image capture format being used.</p>
<p>This function was introduced in Qt Mobility 1.2.</p>
<p><b>See also </b><a href="qcameraimagecapture.html#setBufferFormat">setBufferFormat</a>(), supportedBufferCaptureFormats(), and setBufferCaptureFormat().</p>
<!-- @@@bufferFormat -->
<!-- $$$bufferFormatChanged[overload1]$$$bufferFormatChangedQVideoFrame::PixelFormat -->
<h3 class="fn"><a name="bufferFormatChanged"></a><span class="type">void</span> QCameraImageCapture::<span class="name">bufferFormatChanged</span> ( <span class="type"><a href="qvideoframe.html#PixelFormat-enum">QVideoFrame::PixelFormat</a></span> <i>format</i> )<tt> [signal]</tt></h3>
<p>Signal emitted when the buffer <i>format</i> for the buffer image capture has changed.</p>
<p>This function was introduced in Qt Mobility 1.2.</p>
<!-- @@@bufferFormatChanged -->
<!-- $$$cancelCapture[overload1]$$$cancelCapture -->
<h3 class="fn"><a name="cancelCapture"></a><span class="type">void</span> QCameraImageCapture::<span class="name">cancelCapture</span> ()<tt> [slot]</tt></h3>
<p>Cancel incomplete capture requests. Already captured and queused for proicessing images may be discarded.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@cancelCapture -->
<!-- $$$capture[overload1]$$$captureconstQString& -->
<h3 class="fn"><a name="capture"></a><span class="type">int</span> QCameraImageCapture::<span class="name">capture</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>file</i> = QString() )<tt> [slot]</tt></h3>
<p>Capture the image and save it to <i>file</i>. This operation is asynchronous in majority of cases, followed by signals <a href="qcameraimagecapture.html#imageCaptured">QCameraImageCapture::imageCaptured</a>(), <a href="qcameraimagecapture.html#imageSaved">QCameraImageCapture::imageSaved</a>() or <a href="qcameraimagecapture.html#error">QCameraImageCapture::error</a>().</p>
<p>If an empty <i>file</i> is passed, the camera backend choses the default location and naming scheme for photos on the system, if only file name without full path is specified, the image will be saved to the default directory, with a full path reported with <a href="qcameraimagecapture.html#imageCaptured">imageCaptured</a>() and <a href="qcameraimagecapture.html#imageSaved">imageSaved</a>() signals.</p>
<p>QCameraImageCapture::capture returns the capture Id parameter, used with <a href="qcameraimagecapture.html#imageExposed">imageExposed</a>(), <a href="qcameraimagecapture.html#imageCaptured">imageCaptured</a>() and <a href="qcameraimagecapture.html#imageSaved">imageSaved</a>() signals.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@capture -->
<!-- $$$captureDestination[overload1]$$$captureDestination -->
<h3 class="fn"><a name="captureDestination"></a><span class="type"><a href="qcameraimagecapture.html#CaptureDestination-enum">CaptureDestinations</a></span> QCameraImageCapture::<span class="name">captureDestination</span> () const</h3>
<p>Returns the image capture destination being used.</p>
<p>This function was introduced in Qt Mobility 1.2.</p>
<p><b>See also </b><a href="qcameraimagecapture.html#isCaptureDestinationSupported">isCaptureDestinationSupported</a>() and <a href="qcameraimagecapture.html#setCaptureDestination">setCaptureDestination</a>().</p>
<!-- @@@captureDestination -->
<!-- $$$captureDestinationChanged[overload1]$$$captureDestinationChangedQCameraImageCapture::CaptureDestinations -->
<h3 class="fn"><a name="captureDestinationChanged"></a><span class="type">void</span> QCameraImageCapture::<span class="name">captureDestinationChanged</span> ( <span class="type"><a href="qcameraimagecapture.html#CaptureDestination-enum">QCameraImageCapture::CaptureDestinations</a></span> <i>destination</i> )<tt> [signal]</tt></h3>
<p>Signal emitted when the capture <i>destination</i> has changed.</p>
<p>This function was introduced in Qt Mobility 1.2.</p>
<!-- @@@captureDestinationChanged -->
<!-- $$$encodingSettings[overload1]$$$encodingSettings -->
<h3 class="fn"><a name="encodingSettings"></a><span class="type"><a href="qimageencodersettings.html">QImageEncoderSettings</a></span> QCameraImageCapture::<span class="name">encodingSettings</span> () const</h3>
<p>Returns the image encoder settings being used.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qcameraimagecapture.html#setEncodingSettings">setEncodingSettings</a>().</p>
<!-- @@@encodingSettings -->
<!-- $$$error[overload1]$$$error -->
<h3 class="fn"><a name="error"></a><span class="type"><a href="qcameraimagecapture.html#Error-enum">Error</a></span> QCameraImageCapture::<span class="name">error</span> () const</h3>
<p>Returns the current error state.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qcameraimagecapture.html#errorString">errorString</a>().</p>
<!-- @@@error -->
<!-- $$$error$$$errorintQCameraImageCapture::ErrorconstQString& -->
<h3 class="fn"><a name="error-2"></a><span class="type">void</span> QCameraImageCapture::<span class="name">error</span> ( <span class="type">int</span> <i>id</i>, <span class="type"><a href="qcameraimagecapture.html#Error-enum">QCameraImageCapture::Error</a></span> <i>error</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>errorString</i> )<tt> [signal]</tt></h3>
<p>Signals that the capture request <i>id</i> has failed with an <i>error</i> and <i>errorString</i> description.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@error -->
<!-- $$$errorString[overload1]$$$errorString -->
<h3 class="fn"><a name="errorString"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> QCameraImageCapture::<span class="name">errorString</span> () const</h3>
<p>Returns a string describing the current error state.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qcameraimagecapture.html#error">error</a>().</p>
<!-- @@@errorString -->
<!-- $$$imageAvailable[overload1]$$$imageAvailableintconstQVideoFrame& -->
<h3 class="fn"><a name="imageAvailable"></a><span class="type">void</span> QCameraImageCapture::<span class="name">imageAvailable</span> ( <span class="type">int</span> <i>id</i>, const <span class="type"><a href="qvideoframe.html">QVideoFrame</a></span> & <i>buffer</i> )<tt> [signal]</tt></h3>
<p>Signal emitted when the frame with request <i>id</i> is available as <i>buffer</i>.</p>
<p>This function was introduced in Qt Mobility 1.2.</p>
<!-- @@@imageAvailable -->
<!-- $$$imageCaptured[overload1]$$$imageCapturedintconstQImage& -->
<h3 class="fn"><a name="imageCaptured"></a><span class="type">void</span> QCameraImageCapture::<span class="name">imageCaptured</span> ( <span class="type">int</span> <i>id</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qimage.html">QImage</a></span> & <i>preview</i> )<tt> [signal]</tt></h3>
<p>Signal emitted when the frame with request <i>id</i> was captured, but not processed and saved yet. Frame <i>preview</i> can be displayed to user.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@imageCaptured -->
<!-- $$$imageCodecDescription[overload1]$$$imageCodecDescriptionconstQString& -->
<h3 class="fn"><a name="imageCodecDescription"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> QCameraImageCapture::<span class="name">imageCodecDescription</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>codec</i> ) const</h3>
<p>Returns a description of an image <i>codec</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@imageCodecDescription -->
<!-- $$$imageExposed[overload1]$$$imageExposedint -->
<h3 class="fn"><a name="imageExposed"></a><span class="type">void</span> QCameraImageCapture::<span class="name">imageExposed</span> ( <span class="type">int</span> <i>id</i> )<tt> [signal]</tt></h3>
<p>Signal emitted when the frame with request <i>id</i> was exposed.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@imageExposed -->
<!-- $$$imageMetadataAvailable[overload1]$$$imageMetadataAvailableintQtMultimediaKit::MetaDataconstQVariant& -->
<h3 class="fn"><a name="imageMetadataAvailable"></a><span class="type">void</span> QCameraImageCapture::<span class="name">imageMetadataAvailable</span> ( <span class="type">int</span> <i>id</i>, <span class="type"><a href="qtmultimediakit.html#MetaData-enum">QtMultimediaKit::MetaData</a></span> <i>key</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qvariant.html">QVariant</a></span> & <i>value</i> )<tt> [signal]</tt></h3>
<p>Signals that a metadata for an image with request <i>id</i> is available. This signal is emitted for metadata <i>value</i> with a <i>key</i> listed in <a href="qtmultimediakit.html#MetaData-enum">QtMultimediaKit::MetaData</a> enum.</p>
<p>This signal is emitted between imageExposed and imageSaved signals.</p>
<p>This function was introduced in Qt Mobility 1.2.</p>
<!-- @@@imageMetadataAvailable -->
<!-- $$$imageMetadataAvailable$$$imageMetadataAvailableintconstQString&constQVariant& -->
<h3 class="fn"><a name="imageMetadataAvailable-2"></a><span class="type">void</span> QCameraImageCapture::<span class="name">imageMetadataAvailable</span> ( <span class="type">int</span> <i>id</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>key</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qvariant.html">QVariant</a></span> & <i>value</i> )<tt> [signal]</tt></h3>
<p>Signals that a metadata for an image with request <i>id</i> is available. This signal is emitted for extended metadata <i>value</i> with a <i>key</i> not listed in <a href="qtmultimediakit.html#MetaData-enum">QtMultimediaKit::MetaData</a> enum.</p>
<p>This signal is emitted between imageExposed and imageSaved signals.</p>
<p>This function was introduced in Qt Mobility 1.2.</p>
<!-- @@@imageMetadataAvailable -->
<!-- $$$imageSaved[overload1]$$$imageSavedintconstQString& -->
<h3 class="fn"><a name="imageSaved"></a><span class="type">void</span> QCameraImageCapture::<span class="name">imageSaved</span> ( <span class="type">int</span> <i>id</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>fileName</i> )<tt> [signal]</tt></h3>
<p>Signal emitted when the frame with request <i>id</i> was saved to <i>fileName</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@imageSaved -->
<!-- $$$isAvailable[overload1]$$$isAvailable -->
<h3 class="fn"><a name="isAvailable"></a><span class="type">bool</span> QCameraImageCapture::<span class="name">isAvailable</span> () const</h3>
<p>Returns true if the images capture service ready to use.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@isAvailable -->
<!-- $$$isCaptureDestinationSupported[overload1]$$$isCaptureDestinationSupportedCaptureDestinations -->
<h3 class="fn"><a name="isCaptureDestinationSupported"></a><span class="type">bool</span> QCameraImageCapture::<span class="name">isCaptureDestinationSupported</span> ( <span class="type"><a href="qcameraimagecapture.html#CaptureDestination-enum">CaptureDestinations</a></span> <i>destination</i> ) const</h3>
<p>Returns true if the image capture <i>destination</i> is supported; otherwise returns false.</p>
<p>This function was introduced in Qt Mobility 1.2.</p>
<p><b>See also </b><a href="qcameraimagecapture.html#captureDestination">captureDestination</a>() and <a href="qcameraimagecapture.html#setCaptureDestination">setCaptureDestination</a>().</p>
<!-- @@@isCaptureDestinationSupported -->
<!-- $$$mediaObject[overload1]$$$mediaObject -->
<h3 class="fn"><a name="mediaObject"></a><span class="type"><a href="qmediaobject.html">QMediaObject</a></span> * QCameraImageCapture::<span class="name">mediaObject</span> () const<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="qmediabindableinterface.html#mediaObject">QMediaBindableInterface::mediaObject</a>().</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qcameraimagecapture.html#setMediaObject">setMediaObject</a>().</p>
<!-- @@@mediaObject -->
<!-- $$$readyForCaptureChanged[overload1]$$$readyForCaptureChangedbool -->
<h3 class="fn"><a name="readyForCaptureChanged"></a><span class="type">void</span> QCameraImageCapture::<span class="name">readyForCaptureChanged</span> ( <span class="type">bool</span> <i>ready</i> )<tt> [signal]</tt></h3>
<p>Signals that a camera's <i>ready</i> for capture state has changed.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@readyForCaptureChanged -->
<!-- $$$setBufferFormat[overload1]$$$setBufferFormatQVideoFrame::PixelFormat -->
<h3 class="fn"><a name="setBufferFormat"></a><span class="type">void</span> QCameraImageCapture::<span class="name">setBufferFormat</span> ( <span class="type"><a href="qvideoframe.html#PixelFormat-enum">QVideoFrame::PixelFormat</a></span> <i>format</i> )</h3>
<p><b>See also </b><a href="qcameraimagecapture.html#bufferFormat">bufferFormat</a>().</p>
<!-- @@@setBufferFormat -->
<!-- $$$setCaptureDestination[overload1]$$$setCaptureDestinationCaptureDestinations -->
<h3 class="fn"><a name="setCaptureDestination"></a><span class="type">void</span> QCameraImageCapture::<span class="name">setCaptureDestination</span> ( <span class="type"><a href="qcameraimagecapture.html#CaptureDestination-enum">CaptureDestinations</a></span> <i>destination</i> )</h3>
<p>Sets the capture <i>destination</i> to be used.</p>
<p>This function was introduced in Qt Mobility 1.2.</p>
<p><b>See also </b><a href="qcameraimagecapture.html#isCaptureDestinationSupported">isCaptureDestinationSupported</a>() and <a href="qcameraimagecapture.html#captureDestination">captureDestination</a>().</p>
<!-- @@@setCaptureDestination -->
<!-- $$$setEncodingSettings[overload1]$$$setEncodingSettingsconstQImageEncoderSettings& -->
<h3 class="fn"><a name="setEncodingSettings"></a><span class="type">void</span> QCameraImageCapture::<span class="name">setEncodingSettings</span> ( const <span class="type"><a href="qimageencodersettings.html">QImageEncoderSettings</a></span> & <i>settings</i> )</h3>
<p>Sets the image encoding <i>settings</i>.</p>
<p>If some parameters are not specified, or null settings are passed, the encoder choose the default encoding parameters.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qcameraimagecapture.html#encodingSettings">encodingSettings</a>().</p>
<!-- @@@setEncodingSettings -->
<!-- $$$setMediaObject[overload1]$$$setMediaObjectQMediaObject* -->
<h3 class="fn"><a name="setMediaObject"></a><span class="type">bool</span> QCameraImageCapture::<span class="name">setMediaObject</span> ( <span class="type"><a href="qmediaobject.html">QMediaObject</a></span> * <i>mediaObject</i> )<tt> [virtual protected]</tt></h3>
<p>Reimplemented from <a href="qmediabindableinterface.html#setMediaObject">QMediaBindableInterface::setMediaObject</a>().</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qcameraimagecapture.html#mediaObject">mediaObject</a>().</p>
<!-- @@@setMediaObject -->
<!-- $$$supportedBufferFormats[overload1]$$$supportedBufferFormats -->
<h3 class="fn"><a name="supportedBufferFormats"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qvideoframe.html#PixelFormat-enum">QVideoFrame::PixelFormat</a></span>> QCameraImageCapture::<span class="name">supportedBufferFormats</span> () const</h3>
<p>Returns the list of supported buffer image capture formats.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qcameraimagecapture.html#bufferFormat">bufferFormat</a>() and <a href="qcameraimagecapture.html#setBufferFormat">setBufferFormat</a>().</p>
<!-- @@@supportedBufferFormats -->
<!-- $$$supportedImageCodecs[overload1]$$$supportedImageCodecs -->
<h3 class="fn"><a name="supportedImageCodecs"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstringlist.html">QStringList</a></span> QCameraImageCapture::<span class="name">supportedImageCodecs</span> () const</h3>
<p>Returns a list of supported image codecs.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@supportedImageCodecs -->
<!-- $$$supportedResolutions[overload1]$$$supportedResolutionsconstQImageEncoderSettings&bool* -->
<h3 class="fn"><a name="supportedResolutions"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="http://qt.nokia.com/doc/4.7/qsize.html">QSize</a></span>> QCameraImageCapture::<span class="name">supportedResolutions</span> ( const <span class="type"><a href="qimageencodersettings.html">QImageEncoderSettings</a></span> & <i>settings</i> = QImageEncoderSettings(), <span class="type">bool</span> * <i>continuous</i> = 0 ) const</h3>
<p>Returns a list of resolutions images can be encoded at.</p>
<p>If non null image <i>settings</i> parameter is passed, the returned list is reduced to resolution supported with partial settings like image codec or quality applied.</p>
<p>If the encoder supports arbitrary resolutions within the supported range, *<i>continuous</i> is set to true, otherwise *<i>continuous</i> is set to false.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qimageencodersettings.html#resolution">QImageEncoderSettings::resolution</a>().</p>
<!-- @@@supportedResolutions -->
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2008-2011 Nokia Corporation and/or its
subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation
in Finland and/or other countries worldwide.</p>
<p>
All other trademarks are property of their respective owners. <a title="Privacy Policy"
href="http://qt.nokia.com/about/privacy-policy">Privacy Policy</a></p>
<br />
<p>
Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia.</p>
<p>
Alternatively, this document may be used 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>
</div>
</body>
</html>
distrib
>
Mageia
>
5
>
i586
>
media
>
core-release
>
by-pkgid
>
50facae208d4a6f280e44a513b104320
>
files
>
652
