Sophie

Sophie

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

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" />
<!-- qdeclarativecamera.cpp -->
  <title>Qt Mobility 1.2: QML Camera Element</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="http://qt.nokia.com/doc/4.7/qdeclarativeelements.html">QML Elements</a></li>
<li>QML Camera Element</li>
    </ul>
  </div>
</div>
<div class="content mainContent">
<p class="naviNextPrevious headerNavi">
</p><p/>
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#properties">Properties</a></li>
<li class="level1"><a href="#signal-handlers">Signal Handlers</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QML Camera Element</h1>
<span class="subtitle"></span>
<!-- $$$Camera-brief -->
<p>The Camera element allows you to add camera viewfinder to a scene. <a href="#details">More...</a></p>
<!-- @@@Camera -->
<p>Inherits <a href="http://qt.nokia.com/doc/4.7/qml-item.html">Item</a></p>
<p>Camera instantiates the C++ class <a href="qdeclarativecamera.html">QDeclarativeCamera</a></p>
<p>This element was introduced in  Mobility 1.1.</p>
<ul>
<li><a href="qml-camera-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="properties"></a>
<h2>Properties</h2>
<ul>
<li class="fn"><b><b><a href="qml-camera.html#aperture-prop">aperture</a></b></b> : real</li>
<li class="fn"><b><b><a href="qml-camera.html#cameraState-prop">cameraState</a></b></b> : enumeration</li>
<li class="fn"><b><b><a href="qml-camera.html#captureResolution-prop">captureResolution</a></b></b> : size</li>
<li class="fn"><b><b><a href="qml-camera.html#capturedImagePath-prop">capturedImagePath</a></b></b> : string</li>
<li class="fn"><b><b><a href="qml-camera.html#digitalZoom-prop">digitalZoom</a></b></b> : real</li>
<li class="fn"><b><b><a href="qml-camera.html#errorString-prop">errorString</a></b></b> : string</li>
<li class="fn"><b><b><a href="qml-camera.html#exposureCompensation-prop">exposureCompensation</a></b></b> : real</li>
<li class="fn"><b><b><a href="qml-camera.html#exposureMode-prop">exposureMode</a></b></b> : enumeration</li>
<li class="fn"><b><b><a href="qml-camera.html#flashMode-prop">flashMode</a></b></b> : enumeration</li>
<li class="fn"><b><b><a href="qml-camera.html#isoSensitivity-prop">isoSensitivity</a></b></b> : real</li>
<li class="fn"><b><b><a href="qml-camera.html#lockStatus-prop">lockStatus</a></b></b> : enumeration</li>
<li class="fn"><b><b><a href="qml-camera.html#manualWhiteBalance-prop">manualWhiteBalance</a></b></b> : int</li>
<li class="fn"><b><b><a href="qml-camera.html#maximumDigitalZoom-prop">maximumDigitalZoom</a></b></b> : real</li>
<li class="fn"><b><b><a href="qml-camera.html#maximumOpticalZoom-prop">maximumOpticalZoom</a></b></b> : real</li>
<li class="fn"><b><b><a href="qml-camera.html#opticalZoom-prop">opticalZoom</a></b></b> : real</li>
<li class="fn"><b><b><a href="qml-camera.html#shutterSpeed-prop">shutterSpeed</a></b></b> : real</li>
<li class="fn"><b><b><a href="qml-camera.html#whiteBalanceMode-prop">whiteBalanceMode</a></b></b> : enumeration</li>
</ul>
<a name="signal-handlers"></a>
<h2>Signal Handlers</h2>
<ul>
<li class="fn"><b><b><a href="qml-camera.html#apertureChanged-signal">apertureChanged</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#cameraStateChanged-signal">cameraStateChanged</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#captureResolutionChanged-signal">captureResolutionChanged</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#digitalZoomChanged-signal">digitalZoomChanged</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#errorChanged-signal">errorChanged</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#exposureCompensationChanged-signal">exposureCompensationChanged</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#exposureModeChanged-signal">exposureModeChanged</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#flashModeChanged-signal">flashModeChanged</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#imageCaptured-signal">imageCaptured</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#imageSaved-signal">imageSaved</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#isoSensitivityChanged-signal">isoSensitivityChanged</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#lockStatusChanged-signal">lockStatusChanged</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#manualWhiteBalanceChanged-signal">manualWhiteBalanceChanged</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#maximumDigitalZoomChanged-signal">maximumDigitalZoomChanged</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#maximumOpticalZoomChanged-signal">maximumOpticalZoomChanged</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#onCaptureFailed-signal">onCaptureFailed</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#onError-signal">onError</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#onImageCaptured-signal">onImageCaptured</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#onImageSaved-signal">onImageSaved</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#opticalZoomChanged-signal">opticalZoomChanged</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#shutterSpeedChanged-signal">shutterSpeedChanged</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#stateChanged-signal">stateChanged</a></b></b></li>
<li class="fn"><b><b><a href="qml-camera.html#whiteBalanceModeChanged-signal">whiteBalanceModeChanged</a></b></b></li>
</ul>
<!-- $$$Camera-description -->
<a name="details"></a>
<h2>Detailed Description</h2>
<p>This element is part of the <b><a href="qtmultimediakit.html">QtMultimediaKit</a> 1.1</b> module.</p>
<pre class="qml"> import Qt 4.7
 import QtMultimediaKit 1.1

 <span class="type">Camera</span> {
     <span class="name">focus</span> : <span class="name">visible</span> <span class="comment">// to receive focus and capture key events when visible</span>

     <span class="name">flashMode</span>: <span class="name">Camera</span>.<span class="name">FlashRedEyeReduction</span>
     <span class="name">whiteBalanceMode</span>: <span class="name">Camera</span>.<span class="name">WhiteBalanceFlash</span>
     <span class="name">exposureCompensation</span>: -<span class="number">1.0</span>

     <span class="name">onImageCaptured</span> : {
         <span class="name">photoPreview</span>.<span class="name">source</span> <span class="operator">=</span> <span class="name">preview</span>  <span class="comment">// Show the preview in an Image element</span>
     }

 }</pre>
<p>You can use the <tt>Camera</tt> element to capture images from a camera, and manipulate the capture and processing settings that get applied to the image.</p>
<p><b>Note:</b> On Symbian, your process requires the <tt>UserEnvironment</tt> capability to use this element.</p>
<!-- @@@Camera -->
<h2>Property Documentation</h2>
<!-- $$$aperture -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="aperture-prop"></a><span class="qmlreadonly">read-only</span><span class="name">aperture</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-real.html">real</a></span></p></td></tr></table></div><div class="qmldoc"><p>The lens aperture as an F number (the ratio of the focal length to effective aperture diameter).</p>
<p>This property group was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@aperture -->
<br/>
<!-- $$$cameraState -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="cameraState-prop"></a><span class="name">cameraState</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-enumeration.html">enumeration</a></span></p></td></tr></table></div><div class="qmldoc"><p>The current state of the camera object.</p>
<table class="generic">
<thead><tr class="qt-style"><th >Value</th><th >Description</th></tr></thead>
<tr valign="top" class="odd"><td >UnloadedState</td><td >The initial camera state, with camera not loaded, the camera capabilities except of supported capture modes are unknown. While the supported settings are unknown in this state, it's allowed to set the camera capture settings like codec, resolution, or frame rate.</td></tr>
<tr valign="top" class="even"><td >LoadedState</td><td >The camera is loaded and ready to be configured.<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>
</td></tr>
<tr valign="top" class="odd"><td >ActiveState</td><td >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>
<p>This property group was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@cameraState -->
<br/>
<!-- $$$captureResolution -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="captureResolution-prop"></a><span class="name">captureResolution</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-size.html">size</a></span></p></td></tr></table></div><div class="qmldoc"><p>The resolution to capture the image at. If empty, the system will pick a good size.</p>
<p>This property group was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@captureResolution -->
<br/>
<!-- $$$capturedImagePath -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="capturedImagePath-prop"></a><span class="qmlreadonly">read-only</span><span class="name">capturedImagePath</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-string.html">string</a></span></p></td></tr></table></div><div class="qmldoc"><p>The path to the captured image.</p>
<p>This property group was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@capturedImagePath -->
<br/>
<!-- $$$digitalZoom -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="digitalZoom-prop"></a><span class="name">digitalZoom</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-real.html">real</a></span></p></td></tr></table></div><div class="qmldoc"><p>The current digital zoom factor.</p>
<p>This property group was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@digitalZoom -->
<br/>
<!-- $$$errorString -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="errorString-prop"></a><span class="qmlreadonly">read-only</span><span class="name">errorString</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-string.html">string</a></span></p></td></tr></table></div><div class="qmldoc"><p>A description of the current error, if any.</p>
<p>This property group was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@errorString -->
<br/>
<!-- $$$exposureCompensation -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="exposureCompensation-prop"></a><span class="name">exposureCompensation</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-real.html">real</a></span></p></td></tr></table></div><div class="qmldoc"><p>Adjustment for the automatically calculated exposure. The value is in EV units.</p>
<p>This property group was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@exposureCompensation -->
<br/>
<!-- $$$exposureMode -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="exposureMode-prop"></a><span class="name">exposureMode</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-enumeration.html">enumeration</a></span></p></td></tr></table></div><div class="qmldoc"><table class="generic">
<thead><tr class="qt-style"><th >Value</th><th >Description</th></tr></thead>
<tr valign="top" class="odd"><td >ExposureManual</td><td >Manual mode.</td></tr>
<tr valign="top" class="even"><td >ExposureAuto</td><td >Automatic mode.</td></tr>
<tr valign="top" class="odd"><td >ExposureNight</td><td >Night mode.</td></tr>
<tr valign="top" class="even"><td >ExposureBacklight</td><td >Backlight exposure mode.</td></tr>
<tr valign="top" class="odd"><td >ExposureSpotlight</td><td >Spotlight exposure mode.</td></tr>
<tr valign="top" class="even"><td >ExposureSports</td><td >Spots exposure mode.</td></tr>
<tr valign="top" class="odd"><td >ExposureSnow</td><td >Snow exposure mode.</td></tr>
<tr valign="top" class="even"><td >ExposureBeach</td><td >Beach exposure mode.</td></tr>
<tr valign="top" class="odd"><td >ExposureLargeAperture</td><td >Use larger aperture with small depth of field.</td></tr>
<tr valign="top" class="even"><td >ExposureSmallAperture</td><td >Use smaller aperture.</td></tr>
<tr valign="top" class="odd"><td >ExposurePortrait</td><td >Portrait exposure mode.</td></tr>
<tr valign="top" class="even"><td >ExposureModeVendor</td><td >The base value for device specific exposure modes.</td></tr>
</table>
<p>This property group was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@exposureMode -->
<br/>
<!-- $$$flashMode -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="flashMode-prop"></a><span class="name">flashMode</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-enumeration.html">enumeration</a></span></p></td></tr></table></div><div class="qmldoc"><table class="generic">
<thead><tr class="qt-style"><th >Value</th><th >Description</th></tr></thead>
<tr valign="top" class="odd"><td >FlashOff</td><td >Flash is Off.</td></tr>
<tr valign="top" class="even"><td >FlashOn</td><td >Flash is On.</td></tr>
<tr valign="top" class="odd"><td >FlashAuto</td><td >Automatic flash.</td></tr>
<tr valign="top" class="even"><td >FlashRedEyeReduction</td><td >Red eye reduction flash.</td></tr>
<tr valign="top" class="odd"><td >FlashFill</td><td >Use flash to fillin shadows.</td></tr>
<tr valign="top" class="even"><td >FlashTorch</td><td >Constant light source, useful for focusing and video capture.</td></tr>
<tr valign="top" class="odd"><td >FlashSlowSyncFrontCurtain</td><td >Use the flash in conjunction with a slow shutter speed. This mode allows better exposure of distant objects and/or motion blur effect.</td></tr>
<tr valign="top" class="even"><td >FlashSlowSyncRearCurtain</td><td >The similar mode to FlashSlowSyncFrontCurtain but flash is fired at the end of exposure.</td></tr>
<tr valign="top" class="odd"><td >FlashManual</td><td >Flash power is manually set.</td></tr>
</table>
<p>This property group was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@flashMode -->
<br/>
<!-- $$$isoSensitivity -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="isoSensitivity-prop"></a><span class="qmlreadonly">read-only</span><span class="name">isoSensitivity</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-real.html">real</a></span></p></td></tr></table></div><div class="qmldoc"><p>The sensor's ISO sensitivity.</p>
<p>This property group was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@isoSensitivity -->
<br/>
<!-- $$$lockStatus -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="lockStatus-prop"></a><span class="qmlreadonly">read-only</span><span class="name">lockStatus</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-enumeration.html">enumeration</a></span></p></td></tr></table></div><div class="qmldoc"><p>The overall status for all the requested camera locks.</p>
<table class="generic">
<thead><tr class="qt-style"><th >Value</th><th >Description</th></tr></thead>
<tr valign="top" class="odd"><td >Unlocked</td><td >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 valign="top" class="even"><td >Searching</td><td >The application has requested the camera focus, exposure or white balance lock with searchAndLock(). This state indicates the camera is focusing or calculating exposure and white balance.</td></tr>
<tr valign="top" class="odd"><td >Locked</td><td >The camera focus, exposure or white balance is locked. The camera is ready to capture, application may check the exposure parameters.<p>The locked state usually means the requested parameter stays the same, except in 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>
</td></tr>
</table>
<p>This property group was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@lockStatus -->
<br/>
<!-- $$$manualWhiteBalance -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="manualWhiteBalance-prop"></a><span class="name">manualWhiteBalance</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-int.html">int</a></span></p></td></tr></table></div><div class="qmldoc"><p>The color temperature used when in manual white balance mode (WhiteBalanceManual).</p>
<p>This property group was introduced in  Mobility 1.1.</p>
<p><b>See also </b><a href="qml-camera.html#whiteBalanceMode-prop">whiteBalanceMode</a>.</p>
</div></div><!-- @@@manualWhiteBalance -->
<br/>
<!-- $$$maximumDigitalZoom -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="maximumDigitalZoom-prop"></a><span class="qmlreadonly">read-only</span><span class="name">maximumDigitalZoom</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-real.html">real</a></span></p></td></tr></table></div><div class="qmldoc"><p>The maximum digital zoom factor, or 1.0 if digital zoom is not supported.</p>
<p>This property group was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@maximumDigitalZoom -->
<br/>
<!-- $$$maximumOpticalZoom -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="maximumOpticalZoom-prop"></a><span class="qmlreadonly">read-only</span><span class="name">maximumOpticalZoom</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-real.html">real</a></span></p></td></tr></table></div><div class="qmldoc"><p>The maximum optical zoom factor, or 1.0 if optical zoom is not supported.</p>
<p>This property group was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@maximumOpticalZoom -->
<br/>
<!-- $$$opticalZoom -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="opticalZoom-prop"></a><span class="name">opticalZoom</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-real.html">real</a></span></p></td></tr></table></div><div class="qmldoc"><p>The current optical zoom factor.</p>
<p>This property group was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@opticalZoom -->
<br/>
<!-- $$$shutterSpeed -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="shutterSpeed-prop"></a><span class="qmlreadonly">read-only</span><span class="name">shutterSpeed</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-real.html">real</a></span></p></td></tr></table></div><div class="qmldoc"><p>The camera's shutter speed, in seconds.</p>
<p>This property group was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@shutterSpeed -->
<br/>
<!-- $$$whiteBalanceMode -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="whiteBalanceMode-prop"></a><span class="name">whiteBalanceMode</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-enumeration.html">enumeration</a></span></p></td></tr></table></div><div class="qmldoc"><table class="generic">
<thead><tr class="qt-style"><th >Value</th><th >Description</th></tr></thead>
<tr valign="top" class="odd"><td >WhiteBalanceManual</td><td >Manual white balance. In this mode the manual white balance property value is used.</td></tr>
<tr valign="top" class="even"><td >WhiteBalanceAuto</td><td >Auto white balance mode.</td></tr>
<tr valign="top" class="odd"><td >WhiteBalanceSunlight</td><td >Sunlight white balance mode.</td></tr>
<tr valign="top" class="even"><td >WhiteBalanceCloudy</td><td >Cloudy white balance mode.</td></tr>
<tr valign="top" class="odd"><td >WhiteBalanceShade</td><td >Shade white balance mode.</td></tr>
<tr valign="top" class="even"><td >WhiteBalanceTungsten</td><td >Tungsten white balance mode.</td></tr>
<tr valign="top" class="odd"><td >WhiteBalanceFluorescent</td><td >Fluorescent white balance mode.</td></tr>
<tr valign="top" class="even"><td >WhiteBalanceIncandescent</td><td >Incandescent white balance mode.</td></tr>
<tr valign="top" class="odd"><td >WhiteBalanceFlash</td><td >Flash white balance mode.</td></tr>
<tr valign="top" class="even"><td >WhiteBalanceSunset</td><td >Sunset white balance mode.</td></tr>
<tr valign="top" class="odd"><td >WhiteBalanceVendor</td><td >Vendor defined white balance mode.</td></tr>
</table>
<p>This property group was introduced in  Mobility 1.1.</p>
<p><b>See also </b><a href="qml-camera.html#manualWhiteBalance-prop">manualWhiteBalance</a>.</p>
</div></div><!-- @@@whiteBalanceMode -->
<br/>
<h2>Signal Handler Documentation</h2>
<!-- $$$apertureChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="apertureChanged-signal"></a>Camera::<span class="name">apertureChanged</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-real.html">real</a></span> )</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@apertureChanged -->
<br/>
<!-- $$$cameraStateChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="cameraStateChanged-signal"></a>Camera::<span class="name">cameraStateChanged</span> ( <span class="type">Camera::State</span> )</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@cameraStateChanged -->
<br/>
<!-- $$$captureResolutionChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="captureResolutionChanged-signal"></a>Camera::<span class="name">captureResolutionChanged</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-item.html">Item</a></span> )</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@captureResolutionChanged -->
<br/>
<!-- $$$digitalZoomChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="digitalZoomChanged-signal"></a>Camera::<span class="name">digitalZoomChanged</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-real.html">real</a></span> )</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@digitalZoomChanged -->
<br/>
<!-- $$$errorChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="errorChanged-signal"></a>Camera::<span class="name">errorChanged</span> ()</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@errorChanged -->
<br/>
<!-- $$$exposureCompensationChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="exposureCompensationChanged-signal"></a>Camera::<span class="name">exposureCompensationChanged</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-real.html">real</a></span> )</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@exposureCompensationChanged -->
<br/>
<!-- $$$exposureModeChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="exposureModeChanged-signal"></a>Camera::<span class="name">exposureModeChanged</span> ( <span class="type">Camera::ExposureMode</span> )</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@exposureModeChanged -->
<br/>
<!-- $$$flashModeChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="flashModeChanged-signal"></a>Camera::<span class="name">flashModeChanged</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-int.html">int</a></span> <i>mode</i> )</p></td></tr></table></div><div class="qmldoc"><p>The flash mode is now <i>mode</i>.</p>
<p>This documentation was introduced in  Mobility 1.1.</p>
<p><b>See also </b><a href="qdeclarativecamera.html#FlashMode-enum">QDeclarativeCamera::FlashMode</a>.</p>
</div></div><!-- @@@flashModeChanged -->
<br/>
<!-- $$$imageCaptured -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="imageCaptured-signal"></a>Camera::<span class="name">imageCaptured</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-string.html">string</a></span> )</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@imageCaptured -->
<br/>
<!-- $$$imageSaved -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="imageSaved-signal"></a>Camera::<span class="name">imageSaved</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-string.html">string</a></span> )</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@imageSaved -->
<br/>
<!-- $$$isoSensitivityChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="isoSensitivityChanged-signal"></a>Camera::<span class="name">isoSensitivityChanged</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-int.html">int</a></span> )</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@isoSensitivityChanged -->
<br/>
<!-- $$$lockStatusChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="lockStatusChanged-signal"></a>Camera::<span class="name">lockStatusChanged</span> ()</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@lockStatusChanged -->
<br/>
<!-- $$$manualWhiteBalanceChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="manualWhiteBalanceChanged-signal"></a>Camera::<span class="name">manualWhiteBalanceChanged</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-int.html">int</a></span> )</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@manualWhiteBalanceChanged -->
<br/>
<!-- $$$maximumDigitalZoomChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="maximumDigitalZoomChanged-signal"></a>Camera::<span class="name">maximumDigitalZoomChanged</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-real.html">real</a></span> )</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@maximumDigitalZoomChanged -->
<br/>
<!-- $$$maximumOpticalZoomChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="maximumOpticalZoomChanged-signal"></a>Camera::<span class="name">maximumOpticalZoomChanged</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-real.html">real</a></span> )</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@maximumOpticalZoomChanged -->
<br/>
<!-- $$$onCaptureFailed -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="onCaptureFailed-signal"></a>Camera::<span class="name">onCaptureFailed</span> ( <span class="type">message</span> )</p></td></tr></table></div><div class="qmldoc"><p>This handler is called when an error occurs during capture. A descriptive message is available in <i>message</i>.</p>
<p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@onCaptureFailed -->
<br/>
<!-- $$$onError -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="onError-signal"></a>Camera::<span class="name">onError</span> ( <span class="type">error</span>, <span class="type"><a href="qml-camera.html#errorString-prop">errorString</a></span> )</p></td></tr></table></div><div class="qmldoc"><p>This handler is called when an error occurs. The enumeration value <i>error</i> is one of the values defined below, and a descriptive string value is available in <i>errorString</i>.</p>
<table class="generic">
<thead><tr class="qt-style"><th >Value</th><th >Description</th></tr></thead>
<tr valign="top" class="odd"><td >NoError</td><td >No errors have occurred.</td></tr>
<tr valign="top" class="even"><td >CameraError</td><td >An error has occurred.</td></tr>
<tr valign="top" class="odd"><td >InvalidRequestError</td><td >System resource doesn't support requested functionality.</td></tr>
<tr valign="top" class="even"><td >ServiceMissingError</td><td >No camera service available.</td></tr>
<tr valign="top" class="odd"><td >NotSupportedFeatureError</td><td >The feature is not supported.</td></tr>
</table>
<p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@onError -->
<br/>
<!-- $$$onImageCaptured -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="onImageCaptured-signal"></a>Camera::<span class="name">onImageCaptured</span> ( <span class="type">preview</span> )</p></td></tr></table></div><div class="qmldoc"><p>This handler is called when an image has been captured but not yet saved to the filesystem. The <i>preview</i> parameter can be used as the URL supplied to an Image element.</p>
<p>This documentation was introduced in  Mobility 1.1.</p>
<p><b>See also </b><a href="qml-camera.html#onImageSaved-signal">onImageSaved</a>.</p>
</div></div><!-- @@@onImageCaptured -->
<br/>
<!-- $$$onImageSaved -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="onImageSaved-signal"></a>Camera::<span class="name">onImageSaved</span> ( <span class="type">path</span> )</p></td></tr></table></div><div class="qmldoc"><p>This handler is called after the image has been written to the filesystem. The <i>path</i> is a local file path, not a URL.</p>
<p>This documentation was introduced in  Mobility 1.1.</p>
<p><b>See also </b><a href="qml-camera.html#onImageCaptured-signal">onImageCaptured</a>.</p>
</div></div><!-- @@@onImageSaved -->
<br/>
<!-- $$$opticalZoomChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="opticalZoomChanged-signal"></a>Camera::<span class="name">opticalZoomChanged</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-real.html">real</a></span> )</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@opticalZoomChanged -->
<br/>
<!-- $$$shutterSpeedChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="shutterSpeedChanged-signal"></a>Camera::<span class="name">shutterSpeedChanged</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-real.html">real</a></span> )</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@shutterSpeedChanged -->
<br/>
<!-- $$$stateChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="stateChanged-signal"></a>Camera::<span class="name">stateChanged</span> ( <span class="type">Camera::State</span> )</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@stateChanged -->
<br/>
<!-- $$$whiteBalanceModeChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="whiteBalanceModeChanged-signal"></a>Camera::<span class="name">whiteBalanceModeChanged</span> ( <span class="type">Camera::WhiteBalanceMode</span> )</p></td></tr></table></div><div class="qmldoc"><p>This documentation was introduced in  Mobility 1.1.</p>
</div></div><!-- @@@whiteBalanceModeChanged -->
<br/>
<p class="naviNextPrevious footerNavi">
</p>
  <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>