Sophie

Sophie

distrib > Mageia > 5 > i586 > media > core-release > by-pkgid > 50facae208d4a6f280e44a513b104320 > files > 634

qt-mobility-doc-1.2.0-13.mga5.noarch.rpm

<?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.cpp -->
  <title>Qt Mobility 1.2: QCamera 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>QCamera</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="#static-public-members">Static Public Members</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QCamera Class Reference</h1>
<!-- $$$QCamera-brief -->
<p>The QCamera class provides interface for system camera devices. <a href="#details">More...</a></p>
<!-- @@@QCamera -->
<pre class="cpp"> <span class="preprocessor">#include &lt;QCamera&gt;</span></pre><p><b>Inherits: </b><a href="qmediaobject.html">QMediaObject</a>.</p>
<p>This class was introduced in Qt Mobility 1.1.</p>
<ul>
<li><a href="qcamera-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="qcamera.html#CaptureMode-enum">CaptureMode</a></b> { CaptureStillImage, CaptureVideo }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#Error-enum">Error</a></b> { NoError, CameraError, InvalidRequestError, ServiceMissingError, NotSupportedFeatureError }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#LockChangeReason-enum">LockChangeReason</a></b> { UserRequest, LockAcquired, LockFailed, LockLost, LockTemporaryLost }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#LockStatus-enum">LockStatus</a></b> { Unlocked, Searching, Locked }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#LockType-enum">LockType</a></b> { NoLock, LockExposure, LockWhiteBalance, LockFocus }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> flags </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#LockType-enum">LockTypes</a></b></td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#State-enum">State</a></b> { UnloadedState, LoadedState, ActiveState }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#Status-enum">Status</a></b> { ActiveStatus, StartingStatus, StandbyStatus, LoadedStatus, ..., UnavailableStatus }</td></tr>
</table>
<a name="properties"></a>
<h2>Properties</h2>
<ul>
<li class="fn"><b><a href="qcamera.html#captureMode-prop">captureMode</a></b> : QCamera::CaptureMode</li>
<li class="fn"><b><a href="qcamera.html#lockStatus-prop">lockStatus</a></b> : const QCamera::LockStatus</li>
<li class="fn"><b><a href="qcamera.html#state-prop">state</a></b> : const QCamera::State</li>
<li class="fn"><b><a href="qcamera.html#status-prop">status</a></b> : const QCamera::Status</li>
</ul>
<ul>
<li class="fn">1 property inherited from <a href="qmediaobject.html#properties">QMediaObject</a></li>
<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="qcamera.html#QCamera">QCamera</a></b> ( QObject * <i>parent</i> = 0, QMediaServiceProvider * <i>provider</i> = QMediaServiceProvider::defaultServiceProvider() )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#QCamera-2">QCamera</a></b> ( const QByteArray &amp; <i>device</i>, QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#dtor.QCamera">~QCamera</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> CaptureMode </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#captureMode-prop">captureMode</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Error </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#error">error</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#errorString">errorString</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QCameraExposure * </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#exposure">exposure</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QCameraFocus * </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#focus">focus</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QCameraImageProcessing * </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#imageProcessing">imageProcessing</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#isCaptureModeSupported">isCaptureModeSupported</a></b> ( CaptureMode <i>mode</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QCamera::LockStatus </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#lockStatus-prop">lockStatus</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QCamera::LockStatus </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#lockStatus-prop">lockStatus</a></b> ( QCamera::LockType <i>lockType</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QCamera::LockTypes </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#requestedLocks">requestedLocks</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#setViewfinder">setViewfinder</a></b> ( QVideoWidget * <i>viewfinder</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#setViewfinder-2">setViewfinder</a></b> ( QGraphicsVideoItem * <i>viewfinder</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#setViewfinder-3">setViewfinder</a></b> ( QAbstractVideoSurface * <i>surface</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> State </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#state-prop">state</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Status </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#status-prop">status</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QCamera::LockTypes </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#supportedLocks">supportedLocks</a></b> () 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 QtMultimediaKit::AvailabilityError </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#availabilityError">availabilityError</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#isAvailable">isAvailable</a></b> () const</td></tr>
</table>
<ul>
<li class="fn">12 public functions inherited from <a href="qmediaobject.html#public-functions">QMediaObject</a></li>
<li class="fn">29 public functions inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-functions">QObject</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="qcamera.html#load">load</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#searchAndLock">searchAndLock</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#searchAndLock-2">searchAndLock</a></b> ( QCamera::LockTypes <i>locks</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#captureMode-prop">setCaptureMode</a></b> ( QCamera::CaptureMode <i>mode</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#start">start</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#stop">stop</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#unload">unload</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#unlock">unlock</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#unlock-2">unlock</a></b> ( QCamera::LockTypes <i>locks</i> )</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="qcamera.html#captureModeChanged">captureModeChanged</a></b> ( QCamera::CaptureMode <i>mode</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#error-2">error</a></b> ( QCamera::Error <i>value</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#lockFailed">lockFailed</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#lockStatusChanged">lockStatusChanged</a></b> ( QCamera::LockStatus <i>status</i>, QCamera::LockChangeReason <i>reason</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#lockStatusChanged-2">lockStatusChanged</a></b> ( QCamera::LockType <i>lock</i>, QCamera::LockStatus <i>status</i>, QCamera::LockChangeReason <i>reason</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#locked">locked</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#stateChanged">stateChanged</a></b> ( QCamera::State <i>state</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#statusChanged">statusChanged</a></b> ( QCamera::Status <i>status</i> )</td></tr>
</table>
<ul>
<li class="fn">4 signals inherited from <a href="qmediaobject.html#signals">QMediaObject</a></li>
<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="static-public-members"></a>
<h2>Static Public Members</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> QList&lt;QByteArray&gt; </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#availableDevices">availableDevices</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qcamera.html#deviceDescription">deviceDescription</a></b> ( const QByteArray &amp; <i>device</i> )</td></tr>
</table>
<ul>
<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>
</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">2 protected functions inherited from <a href="qmediaobject.html#protected-functions">QMediaObject</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">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>
<!-- $$$QCamera-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QCamera class provides interface for system camera devices.</p>
<p>QCamera can be used with <a href="qvideowidget.html">QVideoWidget</a> for viewfinder display, <a href="qmediarecorder.html">QMediaRecorder</a> for video recording and <a href="qcameraimagecapture.html">QCameraImageCapture</a> for image taking.</p>
<pre class="cpp"> <span class="type"><a href="qmediaplayercontrol.html">QMediaPlayerControl</a></span> <span class="operator">*</span>control <span class="operator">=</span> qobject_cast<span class="operator">&lt;</span><span class="type"><a href="qmediaplayercontrol.html">QMediaPlayerControl</a></span> <span class="operator">*</span><span class="operator">&gt;</span>(
         mediaService<span class="operator">-</span><span class="operator">&gt;</span>requestControl(<span class="string">&quot;com.nokia.Qt.QMediaPlayerControl/1.0&quot;</span>));</pre>
</div>
<!-- @@@QCamera -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$CaptureMode$$$CaptureStillImage$$$CaptureVideo -->
<h3 class="fn"><a name="CaptureMode-enum"></a>enum QCamera::<span class="name">CaptureMode</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>QCamera::CaptureStillImage</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">Camera is configured for still frames capture.</td></tr>
<tr><td class="topAlign"><tt>QCamera::CaptureVideo</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">Camera is configured for video capture.</td></tr>
</table>
<p>This enum was introduced or modified in Qt Mobility 1.1.</p>
<!-- @@@CaptureMode -->
<!-- $$$Error$$$NoError$$$CameraError$$$InvalidRequestError$$$ServiceMissingError$$$NotSupportedFeatureError -->
<h3 class="fn"><a name="Error-enum"></a>enum QCamera::<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>QCamera::NoError</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">No errors have occurred.</td></tr>
<tr><td class="topAlign"><tt>QCamera::CameraError</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">An error has occurred.</td></tr>
<tr><td class="topAlign"><tt>QCamera::InvalidRequestError</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">System resource doesn't support requested functionality.</td></tr>
<tr><td class="topAlign"><tt>QCamera::ServiceMissingError</tt></td><td class="topAlign"><tt>3</tt></td><td class="topAlign">No camera service available.</td></tr>
<tr><td class="topAlign"><tt>QCamera::NotSupportedFeatureError</tt></td><td class="topAlign"><tt>4</tt></td><td class="topAlign">The feature is not supported.</td></tr>
</table>
<!-- @@@Error -->
<!-- $$$LockChangeReason$$$UserRequest$$$LockAcquired$$$LockFailed$$$LockLost$$$LockTemporaryLost -->
<h3 class="fn"><a name="LockChangeReason-enum"></a>enum QCamera::<span class="name">LockChangeReason</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>QCamera::UserRequest</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">The lock status changed in result of user request, usually to unlock camera settings.</td></tr>
<tr><td class="topAlign"><tt>QCamera::LockAcquired</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">The lock status successfuly changed to <a href="qcamera.html#LockStatus-enum">QCamera::Locked</a>.</td></tr>
<tr><td class="topAlign"><tt>QCamera::LockFailed</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">The camera failed to acquire the requested lock in result of autofocus failure, exposure out of supported range, etc.</td></tr>
<tr><td class="topAlign"><tt>QCamera::LockLost</tt></td><td class="topAlign"><tt>3</tt></td><td class="topAlign">The camera is not able to maintain the requested lock any more. Lock status is changed to <a href="qcamera.html#LockStatus-enum">QCamera::Unlocked</a>.</td></tr>
<tr><td class="topAlign"><tt>QCamera::LockTemporaryLost</tt></td><td class="topAlign"><tt>4</tt></td><td class="topAlign">The lock is lost, but the camera is working hard to reacquire it. This value may be used in continuous focusing mode, when the camera loses the focus, the focus lock state is changed to Qcamera::Searching with LockTemporaryLost reason.</td></tr>
</table>
<!-- @@@LockChangeReason -->
<!-- $$$LockStatus$$$Unlocked$$$Searching$$$Locked -->
<h3 class="fn"><a name="LockStatus-enum"></a>enum QCamera::<span class="name">LockStatus</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>QCamera::Unlocked</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">The application is not interested in camera settings value. The camera may keep this parameter without changes, this is common with camera focus, or adjust exposure and white balance constantly to keep the viewfinder image nice.</td></tr>
<tr><td class="topAlign"><tt>QCamera::Searching</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">The application has requested the camera focus, exposure or white balance lock with <a href="qcamera.html#searchAndLock">QCamera::searchAndLock</a>(). This state indicates the camera is focusing or calculating exposure and white balance.</td></tr>
<tr><td class="topAlign"><tt>QCamera::Locked</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">The camera focus, exposure or white balance is locked. The camera is ready to capture, application may check the exposure parameters.</td></tr>
</table>
<p>The locked state usually means the requested parameter stays the same, except of the cases when the parameter is requested to be constantly updated. For example in continuous focusing mode, the focus is considered locked as long and the object is in focus, even while the actual focusing distance may be constantly changing.</p>
<!-- @@@LockStatus -->
<!-- $$$LockType$$$NoLock$$$LockExposure$$$LockWhiteBalance$$$LockFocus -->
<h3 class="flags"><a name="LockType-enum"></a>enum QCamera::<span class="name">LockType</span><br/>flags QCamera::<span class="name">LockTypes</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>QCamera::NoLock</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">&nbsp;</td></tr>
<tr><td class="topAlign"><tt>QCamera::LockExposure</tt></td><td class="topAlign"><tt>0x01</tt></td><td class="topAlign">Lock camera exposure.</td></tr>
<tr><td class="topAlign"><tt>QCamera::LockWhiteBalance</tt></td><td class="topAlign"><tt>0x02</tt></td><td class="topAlign">Lock the white balance.</td></tr>
<tr><td class="topAlign"><tt>QCamera::LockFocus</tt></td><td class="topAlign"><tt>0x04</tt></td><td class="topAlign">Lock camera focus.</td></tr>
</table>
<p>The LockTypes type is a typedef for <a href="qflags.html">QFlags</a>&lt;LockType&gt;. It stores an OR combination of LockType values.</p>
<!-- @@@LockType -->
<!-- $$$State$$$UnloadedState$$$LoadedState$$$ActiveState -->
<h3 class="fn"><a name="State-enum"></a>enum QCamera::<span class="name">State</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>QCamera::UnloadedState</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">The initial camera state, with camera not loaded, the camera capabilities except of supported capture modes are unknown.</td></tr>
</table>
<p>While the supported settings are unknown in this state, it's allowed to set the camera capture settings like codec, resolution, or frame rate.</p>
<table class="valuelist"><tr valign="top" class="even"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QCamera::LoadedState</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">The camera is loaded and ready to be configured.</td></tr>
</table>
<p>In the Idle state it's allowed to query camera capabilities, set capture resolution, codecs, etc.</p>
<p>The viewfinder is not active in the loaded state.</p>
<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>QCamera::ActiveState</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">In the active state as soon as camera is started the viewfinder displays video frames and the camera is ready for capture.</td></tr>
</table>
<!-- @@@State -->
<!-- $$$Status$$$UnavailableStatus$$$UnloadedStatus$$$LoadingStatus$$$LoadedStatus$$$StandbyStatus$$$StartingStatus$$$ActiveStatus -->
<h3 class="fn"><a name="Status-enum"></a>enum QCamera::<span class="name">Status</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>QCamera::ActiveStatus</tt></td><td class="topAlign"><tt>6</tt></td><td class="topAlign">The camera has been started and can produce data. The viewfinder displays video frames in active state.</td></tr>
</table>
<p>Depending on backend, changing some camera settings like capture mode, codecs or resolution in <a href="qcamera.html#State-enum">ActiveState</a> may lead to changing the camera status to LoadedStatus and StartingStatus while the settings are applied and back to ActiveStatus when the camera is ready.</p>
<table class="valuelist"><tr valign="top" class="even"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QCamera::StartingStatus</tt></td><td class="topAlign"><tt>5</tt></td><td class="topAlign">The camera is starting in result of state transition to <a href="qcamera.html#State-enum">QCamera::ActiveState</a>. The camera service is not ready to capture yet.</td></tr>
<tr><td class="topAlign"><tt>QCamera::StandbyStatus</tt></td><td class="topAlign"><tt>4</tt></td><td class="topAlign">The camera is in the power saving standby mode. The camera may come to the standby mode after some time of inactivity in the <a href="qcamera.html#State-enum">QCamera::LoadedState</a> state.</td></tr>
<tr><td class="topAlign"><tt>QCamera::LoadedStatus</tt></td><td class="topAlign"><tt>3</tt></td><td class="topAlign">The camera is loaded and ready to be configured. This status indicates the camera device is opened and it's possible to query for supported image and video capture settings, like resolution, framerate and codecs.</td></tr>
<tr><td class="topAlign"><tt>QCamera::LoadingStatus</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">The camera device loading in result of state transition from <a href="qcamera.html#State-enum">QCamera::UnloadedState</a> to <a href="qcamera.html#State-enum">QCamera::LoadedState</a> or <a href="qcamera.html#State-enum">QCamera::ActiveState</a>.</td></tr>
<tr><td class="topAlign"><tt>QCamera::UnloadedStatus</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">The initial camera status, with camera not loaded. The camera capabilities including supported capture settings may be unknown.</td></tr>
<tr><td class="topAlign"><tt>QCamera::UnavailableStatus</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">The camera or camera backend is not available.</td></tr>
</table>
<!-- @@@Status -->
</div>
<div class="prop">
<h2>Property Documentation</h2>
<!-- $$$captureMode-prop$$$captureMode$$$setCaptureModeQCamera::CaptureMode$$$captureModeChangedQCamera::CaptureMode -->
<h3 class="fn"><a name="captureMode-prop"></a><span class="name">captureMode</span> : <span class="type"><a href="qcamera.html#CaptureMode-enum">QCamera::CaptureMode</a></span></h3>
<p>The type of media (video or still images), the camera is configured to capture.</p>
<p>It's allowed to change capture mode in any camera state, but if the camera is currently active, chaging capture mode is likely to lead to camera status chaged to <a href="qcamera.html#Status-enum">QCamera::LoadedStatus</a>, <a href="qcamera.html#Status-enum">QCamera::LoadingStatus</a>, and when the camera is ready to <a href="qcamera.html#Status-enum">QCamera::ActiveStatus</a>.</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"> CaptureMode </td><td class="memItemRight bottomAlign"><span class="name"><b>captureMode</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setCaptureMode</b></span> ( QCamera::CaptureMode <i>mode</i> )</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="qcamera.html#captureModeChanged">captureModeChanged</a></b></span> ( QCamera::CaptureMode <i>mode</i> )</td></tr>
</table>
<!-- @@@captureMode -->
<!-- $$$lockStatus-prop$$$lockStatus$$$lockStatusQCamera::LockType$$$lockStatusChangedQCamera::LockStatusQCamera::LockChangeReason$$$lockStatusChangedQCamera::LockTypeQCamera::LockStatusQCamera::LockChangeReason -->
<h3 class="fn"><a name="lockStatus-prop"></a><span class="name">lockStatus</span> : const <span class="type"><a href="qcamera.html#LockStatus-enum">QCamera::LockStatus</a></span></h3>
<p>This property holds the overall status for all the requested camera locks.</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"> QCamera::LockStatus </td><td class="memItemRight bottomAlign"><span class="name"><b>lockStatus</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> QCamera::LockStatus </td><td class="memItemRight bottomAlign"><span class="name"><b>lockStatus</b></span> ( QCamera::LockType <i>lockType</i> ) 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="qcamera.html#lockStatusChanged">lockStatusChanged</a></b></span> ( QCamera::LockStatus <i>status</i>, QCamera::LockChangeReason <i>reason</i> )</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b><a href="qcamera.html#lockStatusChanged-2">lockStatusChanged</a></b></span> ( QCamera::LockType <i>lock</i>, QCamera::LockStatus <i>status</i>, QCamera::LockChangeReason <i>reason</i> )</td></tr>
</table>
<!-- @@@lockStatus -->
<!-- $$$state-prop$$$state$$$stateChangedQCamera::State -->
<h3 class="fn"><a name="state-prop"></a><span class="name">state</span> : const <span class="type"><a href="qcamera.html#State-enum">QCamera::State</a></span></h3>
<p>This property holds the current state of the camera object.</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"> State </td><td class="memItemRight bottomAlign"><span class="name"><b>state</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="qcamera.html#stateChanged">stateChanged</a></b></span> ( QCamera::State <i>state</i> )</td></tr>
</table>
<!-- @@@state -->
<!-- $$$status-prop$$$status$$$statusChangedQCamera::Status -->
<h3 class="fn"><a name="status-prop"></a><span class="name">status</span> : const <span class="type"><a href="qcamera.html#Status-enum">QCamera::Status</a></span></h3>
<p>This property holds the current status of the camera object.</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"> Status </td><td class="memItemRight bottomAlign"><span class="name"><b>status</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="qcamera.html#statusChanged">statusChanged</a></b></span> ( QCamera::Status <i>status</i> )</td></tr>
</table>
<!-- @@@status -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QCamera[overload1]$$$QCameraQObject*QMediaServiceProvider* -->
<h3 class="fn"><a name="QCamera"></a>QCamera::<span class="name">QCamera</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> * <i>parent</i> = 0, <span class="type"><a href="qmediaserviceprovider.html">QMediaServiceProvider</a></span> * <i>provider</i> = QMediaServiceProvider::defaultServiceProvider() )</h3>
<p>Construct a <a href="qcamera.html">QCamera</a> from service <i>provider</i> and <i>parent</i>.</p>
<!-- @@@QCamera -->
<!-- $$$QCamera$$$QCameraconstQByteArray&QObject* -->
<h3 class="fn"><a name="QCamera-2"></a>QCamera::<span class="name">QCamera</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qbytearray.html">QByteArray</a></span> &amp; <i>device</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> * <i>parent</i> = 0 )</h3>
<p>Construct a <a href="qcamera.html">QCamera</a> from device name <i>device</i> and <i>parent</i>.</p>
<!-- @@@QCamera -->
<!-- $$$~QCamera[overload1]$$$~QCamera -->
<h3 class="fn"><a name="dtor.QCamera"></a>QCamera::<span class="name">~QCamera</span> ()</h3>
<p>Destroys the camera object.</p>
<!-- @@@~QCamera -->
<!-- $$$availabilityError[overload1]$$$availabilityError -->
<h3 class="fn"><a name="availabilityError"></a><span class="type"><a href="qtmultimediakit.html#AvailabilityError-enum">QtMultimediaKit::AvailabilityError</a></span> QCamera::<span class="name">availabilityError</span> () const<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="qmediaobject.html#availabilityError">QMediaObject::availabilityError</a>().</p>
<p>Returns the error state of the camera service.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@availabilityError -->
<!-- $$$availableDevices[overload1]$$$availableDevices -->
<h3 class="fn"><a name="availableDevices"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="http://qt.nokia.com/doc/4.7/qbytearray.html">QByteArray</a></span>&gt; QCamera::<span class="name">availableDevices</span> ()<tt> [static]</tt></h3>
<p>Returns a list of camera device's available from the default service provider.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@availableDevices -->
<!-- $$$captureModeChanged[overload1]$$$captureModeChangedQCamera::CaptureMode -->
<h3 class="fn"><a name="captureModeChanged"></a><span class="type">void</span> QCamera::<span class="name">captureModeChanged</span> ( <span class="type"><a href="qcamera.html#CaptureMode-enum">QCamera::CaptureMode</a></span> <i>mode</i> )<tt> [signal]</tt></h3>
<p>Signals the capture <i>mode</i> has changed.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@captureModeChanged -->
<!-- $$$deviceDescription[overload1]$$$deviceDescriptionconstQByteArray& -->
<h3 class="fn"><a name="deviceDescription"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> QCamera::<span class="name">deviceDescription</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qbytearray.html">QByteArray</a></span> &amp; <i>device</i> )<tt> [static]</tt></h3>
<p>Returns the description of the <i>device</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@deviceDescription -->
<!-- $$$error[overload1]$$$error -->
<h3 class="fn"><a name="error"></a><span class="type"><a href="qcamera.html#Error-enum">Error</a></span> QCamera::<span class="name">error</span> () const</h3>
<p>Returns the error state of the object.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@error -->
<!-- $$$error$$$errorQCamera::Error -->
<h3 class="fn"><a name="error-2"></a><span class="type">void</span> QCamera::<span class="name">error</span> ( <span class="type"><a href="qcamera.html#Error-enum">QCamera::Error</a></span> <i>value</i> )<tt> [signal]</tt></h3>
<p>Signal emitted when error state changes to <i>value</i>.</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> QCamera::<span class="name">errorString</span> () const</h3>
<p>Returns a string describing a camera's error state.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@errorString -->
<!-- $$$exposure[overload1]$$$exposure -->
<h3 class="fn"><a name="exposure"></a><span class="type"><a href="qcameraexposure.html">QCameraExposure</a></span> * QCamera::<span class="name">exposure</span> () const</h3>
<p>Returns the camera exposure control object.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@exposure -->
<!-- $$$focus[overload1]$$$focus -->
<h3 class="fn"><a name="focus"></a><span class="type"><a href="qcamerafocus.html">QCameraFocus</a></span> * QCamera::<span class="name">focus</span> () const</h3>
<p>Returns the camera focus control object.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@focus -->
<!-- $$$imageProcessing[overload1]$$$imageProcessing -->
<h3 class="fn"><a name="imageProcessing"></a><span class="type"><a href="qcameraimageprocessing.html">QCameraImageProcessing</a></span> * QCamera::<span class="name">imageProcessing</span> () const</h3>
<p>Returns the camera image processing control object.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@imageProcessing -->
<!-- $$$isAvailable[overload1]$$$isAvailable -->
<h3 class="fn"><a name="isAvailable"></a><span class="type">bool</span> QCamera::<span class="name">isAvailable</span> () const<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="qmediaobject.html#isAvailable">QMediaObject::isAvailable</a>().</p>
<p>Return true if the camera service is ready to use.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@isAvailable -->
<!-- $$$isCaptureModeSupported[overload1]$$$isCaptureModeSupportedCaptureMode -->
<h3 class="fn"><a name="isCaptureModeSupported"></a><span class="type">bool</span> QCamera::<span class="name">isCaptureModeSupported</span> ( <span class="type"><a href="qcamera.html#CaptureMode-enum">CaptureMode</a></span> <i>mode</i> ) const</h3>
<p>Returns true if the capture <i>mode</i> is suported.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@isCaptureModeSupported -->
<!-- $$$load[overload1]$$$load -->
<h3 class="fn"><a name="load"></a><span class="type">void</span> QCamera::<span class="name">load</span> ()<tt> [slot]</tt></h3>
<p>Open the camera device. The camera state is changed to <a href="qcamera.html#Status-enum">QCamera::LoadedStatus</a>.</p>
<p>It's not necessary to explcitly load the camera, unless unless the application have to read the supported camera settings and change the default depending on the camera capabilities.</p>
<p>In all the other cases it's possible to start the camera directly from unloaded state.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@load -->
<!-- $$$lockFailed[overload1]$$$lockFailed -->
<h3 class="fn"><a name="lockFailed"></a><span class="type">void</span> QCamera::<span class="name">lockFailed</span> ()<tt> [signal]</tt></h3>
<p>Signals locking of at least one requested camera settings failed.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@lockFailed -->
<!-- $$$lockStatusChanged[overload1]$$$lockStatusChangedQCamera::LockStatusQCamera::LockChangeReason -->
<h3 class="fn"><a name="lockStatusChanged"></a><span class="type">void</span> QCamera::<span class="name">lockStatusChanged</span> ( <span class="type"><a href="qcamera.html#LockStatus-enum">QCamera::LockStatus</a></span> <i>status</i>, <span class="type"><a href="qcamera.html#LockChangeReason-enum">QCamera::LockChangeReason</a></span> <i>reason</i> )<tt> [signal]</tt></h3>
<p>Signals the overall <i>status</i> for all the requested camera locks was changed with specified <i>reason</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@lockStatusChanged -->
<!-- $$$lockStatusChanged$$$lockStatusChangedQCamera::LockTypeQCamera::LockStatusQCamera::LockChangeReason -->
<h3 class="fn"><a name="lockStatusChanged-2"></a><span class="type">void</span> QCamera::<span class="name">lockStatusChanged</span> ( <span class="type"><a href="qcamera.html#LockType-enum">QCamera::LockType</a></span> <i>lock</i>, <span class="type"><a href="qcamera.html#LockStatus-enum">QCamera::LockStatus</a></span> <i>status</i>, <span class="type"><a href="qcamera.html#LockChangeReason-enum">QCamera::LockChangeReason</a></span> <i>reason</i> )<tt> [signal]</tt></h3>
<p>Signals the <i>lock</i> <i>status</i> was changed with specified <i>reason</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@lockStatusChanged -->
<!-- $$$locked[overload1]$$$locked -->
<h3 class="fn"><a name="locked"></a><span class="type">void</span> QCamera::<span class="name">locked</span> ()<tt> [signal]</tt></h3>
<p>Signals all the requested camera settings are locked.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@locked -->
<!-- $$$requestedLocks[overload1]$$$requestedLocks -->
<h3 class="fn"><a name="requestedLocks"></a><span class="type"><a href="qcamera.html#LockType-enum">QCamera::LockTypes</a></span> QCamera::<span class="name">requestedLocks</span> () const</h3>
<p>Returns the requested lock types.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@requestedLocks -->
<!-- $$$searchAndLock[overload1]$$$searchAndLock -->
<h3 class="fn"><a name="searchAndLock"></a><span class="type">void</span> QCamera::<span class="name">searchAndLock</span> ()<tt> [slot]</tt></h3>
<p>Lock all the supported camera settings.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@searchAndLock -->
<!-- $$$searchAndLock$$$searchAndLockQCamera::LockTypes -->
<h3 class="fn"><a name="searchAndLock-2"></a><span class="type">void</span> QCamera::<span class="name">searchAndLock</span> ( <span class="type"><a href="qcamera.html#LockType-enum">QCamera::LockTypes</a></span> <i>locks</i> )<tt> [slot]</tt></h3>
<p>Locks the camera settings with the requested <i>locks</i>, including focusing in the single autofocus mode, exposure and white balance if the exposure and white balance modes are not manual.</p>
<p>The camera settings are usually locked before taking one or multiple still images, in responce to the shutter button being half pressed.</p>
<p>The <a href="qcamera.html#locked">QCamera::locked</a>() signal is emitted when camera settings are successfully locked, otherwise <a href="qcamera.html#lockFailed">QCamera::lockFailed</a>() is emitted.</p>
<p><a href="qcamera.html">QCamera</a> also emits lockStatusChanged(<a href="qcamera.html#LockType-enum">QCamera::LockType</a>, <a href="qcamera.html#LockStatus-enum">QCamera::LockStatus</a>) on individual lock status changes and lockStatusChanged(<a href="qcamera.html#LockStatus-enum">QCamera::LockStatus</a>) signal on composite status changes.</p>
<p>Locking serves two roles: it initializes calculation of automatic parameter (focusing, calculating the correct exposure and white balance) and allows to keep some or all of those parameters during number of shots.</p>
<p>If the camera doesn't support keeping one of parameters between shots, the related lock state changes to <a href="qcamera.html#LockStatus-enum">QCamera::Unlocked</a>.</p>
<p>It's also acceptable to relock already locked settings, depending on the lock parameter this initiates new focusing, exposure or white balance calculation.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@searchAndLock -->
<!-- $$$setViewfinder[overload1]$$$setViewfinderQVideoWidget* -->
<h3 class="fn"><a name="setViewfinder"></a><span class="type">void</span> QCamera::<span class="name">setViewfinder</span> ( <span class="type"><a href="qvideowidget.html">QVideoWidget</a></span> * <i>viewfinder</i> )</h3>
<p>Sets the <a href="qvideowidget.html">QVideoWidget</a> based camera <i>viewfinder</i>. The previously set viewfinder is detached.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@setViewfinder -->
<!-- $$$setViewfinder$$$setViewfinderQGraphicsVideoItem* -->
<h3 class="fn"><a name="setViewfinder-2"></a><span class="type">void</span> QCamera::<span class="name">setViewfinder</span> ( <span class="type"><a href="qgraphicsvideoitem.html">QGraphicsVideoItem</a></span> * <i>viewfinder</i> )</h3>
<p>Sets the <a href="qgraphicsvideoitem.html">QGraphicsVideoItem</a> based camera <i>viewfinder</i>. The previously set viewfinder is detached.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@setViewfinder -->
<!-- $$$setViewfinder$$$setViewfinderQAbstractVideoSurface* -->
<h3 class="fn"><a name="setViewfinder-3"></a><span class="type">void</span> QCamera::<span class="name">setViewfinder</span> ( <span class="type"><a href="qabstractvideosurface.html">QAbstractVideoSurface</a></span> * <i>surface</i> )</h3>
<p>Sets a video <i>surface</i> as the viewfinder of a camera.</p>
<p>If a viewfinder has already been set on the camera the new surface will replace it.</p>
<p>This function was introduced in Qt Mobility 1.2.</p>
<!-- @@@setViewfinder -->
<!-- $$$start[overload1]$$$start -->
<h3 class="fn"><a name="start"></a><span class="type">void</span> QCamera::<span class="name">start</span> ()<tt> [slot]</tt></h3>
<p>Starts the camera.</p>
<p>State is changed to <a href="qcamera.html#State-enum">QCamera::ActiveState</a> if camera is started successfully, otherwise <a href="qcamera.html#error">error</a>() signal is emitted.</p>
<p>While the camera state is changed to <a href="qcamera.html#State-enum">QCamera::ActiveState</a>, starting the camera service can be asynchronous with the actual status reported with <a href="qcamera.html#status-prop">QCamera::status</a> property.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@start -->
<!-- $$$stateChanged[overload1]$$$stateChangedQCamera::State -->
<h3 class="fn"><a name="stateChanged"></a><span class="type">void</span> QCamera::<span class="name">stateChanged</span> ( <span class="type"><a href="qcamera.html#State-enum">QCamera::State</a></span> <i>state</i> )<tt> [signal]</tt></h3>
<p>Signals the camera <i>state</i> has changed.</p>
<p>Usually the state changes is caused by calling <a href="qcamera.html#load">load</a>(), <a href="qcamera.html#unload">unload</a>(), <a href="qcamera.html#start">start</a>() and <a href="qcamera.html#stop">stop</a>(), but the state can also be changed change as a result of camera error.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@stateChanged -->
<!-- $$$statusChanged[overload1]$$$statusChangedQCamera::Status -->
<h3 class="fn"><a name="statusChanged"></a><span class="type">void</span> QCamera::<span class="name">statusChanged</span> ( <span class="type"><a href="qcamera.html#Status-enum">QCamera::Status</a></span> <i>status</i> )<tt> [signal]</tt></h3>
<p>Signals the camera <i>status</i> has changed.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@statusChanged -->
<!-- $$$stop[overload1]$$$stop -->
<h3 class="fn"><a name="stop"></a><span class="type">void</span> QCamera::<span class="name">stop</span> ()<tt> [slot]</tt></h3>
<p>Stops the camera. The camera state is changed from <a href="qcamera.html#State-enum">QCamera::ActiveState</a> to <a href="qcamera.html#State-enum">QCamera::LoadedState</a>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@stop -->
<!-- $$$supportedLocks[overload1]$$$supportedLocks -->
<h3 class="fn"><a name="supportedLocks"></a><span class="type"><a href="qcamera.html#LockType-enum">QCamera::LockTypes</a></span> QCamera::<span class="name">supportedLocks</span> () const</h3>
<p>Returns the lock types, camera supports.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@supportedLocks -->
<!-- $$$unload[overload1]$$$unload -->
<h3 class="fn"><a name="unload"></a><span class="type">void</span> QCamera::<span class="name">unload</span> ()<tt> [slot]</tt></h3>
<p>Close the camera device and deallocate the related resources. The camera state is changed to <a href="qcamera.html#Status-enum">QCamera::UnloadedStatus</a>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@unload -->
<!-- $$$unlock[overload1]$$$unlock -->
<h3 class="fn"><a name="unlock"></a><span class="type">void</span> QCamera::<span class="name">unlock</span> ()<tt> [slot]</tt></h3>
<p>Unlock all the requested camera locks.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@unlock -->
<!-- $$$unlock$$$unlockQCamera::LockTypes -->
<h3 class="fn"><a name="unlock-2"></a><span class="type">void</span> QCamera::<span class="name">unlock</span> ( <span class="type"><a href="qcamera.html#LockType-enum">QCamera::LockTypes</a></span> <i>locks</i> )<tt> [slot]</tt></h3>
<p>Unlocks the camera settings specified with <i>locks</i> or cancel the current locking if one is active.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@unlock -->
</div>
  <div class="ft">
    <span></span>
  </div>
</div> 
<div class="footer">
  <p>
     <acronym title="Copyright">&copy;</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>

Perl :: Catalyst :: PostgreSQL :: RPM Valid HTML 4.01 Transitional