/usr/share/qt5/doc/qtmultimedia/qml-qtmultimedia-cameraexposure.html is in qtmultimedia5-doc-html 5.2.1-0ubuntu5.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 | <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.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" />
<!-- qdeclarativecameraexposure.cpp -->
<title>CameraExposure | QtMultimedia 5.2</title>
<link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
<div class="main">
<div class="main-rounded">
<div class="navigationbar">
<ul>
<li>Qt 5.2</li>
<li><a href="qtmultimedia-index.html">Qt Multimedia</a></li>
<li><a href="qtmultimedia-qmlmodule.html">QML Types</a></li>
<li>CameraExposure</li>
<li id="buildversion">
Qt 5.2.1 Reference Documentation</li>
</ul>
</div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<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="#methods">Methods</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">CameraExposure</h1>
<span class="subtitle"></span>
<!-- $$$CameraExposure-brief -->
<p>An interface for exposure related camera settings. <a href="#details">More...</a></p>
<!-- @@@CameraExposure -->
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> Import Statement:</td><td class="memItemRight bottomAlign"> </b><tt>import QtMultimedia 5.0</tt></td></tr></table><ul>
<li><a href="qml-qtmultimedia-cameraexposure-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-qtmultimedia-cameraexposure.html#aperture-prop">aperture</a></b></b> : real</li>
<li class="fn"><b><b><a href="qml-qtmultimedia-cameraexposure.html#exposureCompensation-prop">exposureCompensation</a></b></b> : real</li>
<li class="fn"><b><b><a href="qml-qtmultimedia-cameraexposure.html#exposureMode-prop">exposureMode</a></b></b> : enumeration</li>
<li class="fn"><b><b><a href="qml-qtmultimedia-cameraexposure.html#iso-prop">iso</a></b></b> : int</li>
<li class="fn"><b><b><a href="qml-qtmultimedia-cameraexposure.html#manualAperture-prop">manualAperture</a></b></b> : real</li>
<li class="fn"><b><b><a href="qml-qtmultimedia-cameraexposure.html#manualIso-prop">manualIso</a></b></b> : real</li>
<li class="fn"><b><b><a href="qml-qtmultimedia-cameraexposure.html#manualShutterSpeed-prop">manualShutterSpeed</a></b></b> : real</li>
<li class="fn"><b><b><a href="qml-qtmultimedia-cameraexposure.html#meteringMode-prop">meteringMode</a></b></b> : enumeration</li>
<li class="fn"><b><b><a href="qml-qtmultimedia-cameraexposure.html#shutterSpeed-prop">shutterSpeed</a></b></b> : real</li>
<li class="fn"><b><b><a href="qml-qtmultimedia-cameraexposure.html#spotMeteringPoint-prop">spotMeteringPoint</a></b></b> : QPointF</li>
</ul>
<a name="methods"></a>
<h2>Methods</h2>
<ul>
<li class="fn"><b><b><a href="qml-qtmultimedia-cameraexposure.html#setAutoAperture-method">setAutoAperture</a></b></b>()</li>
<li class="fn"><b><b><a href="qml-qtmultimedia-cameraexposure.html#setAutoIsoSensitivity-method">setAutoIsoSensitivity</a></b></b>()</li>
<li class="fn"><b><b><a href="qml-qtmultimedia-cameraexposure.html#setAutoShutterSpeed-method">setAutoShutterSpeed</a></b></b>()</li>
</ul>
<!-- $$$CameraExposure-description -->
<a name="details"></a>
<h2>Detailed Description</h2>
<p>This type is part of the <b><a href="qtmultimedia-module.html">QtMultimedia</a> 5.0</b> module.</p>
<p>CameraExposure allows you to adjust exposure related settings like aperture and shutter speed, metering and ISO speed.</p>
<p>It should not be constructed separately, instead the <tt>exposure</tt> property of the a <a href="qml-qtmultimedia-camera.html">Camera</a> should be used.</p>
<pre class="qml">import QtQuick 2.0
import QtMultimedia 5.0
<span class="type"><a href="qml-qtmultimedia-camera.html">Camera</a></span> {
<span class="name">id</span>: <span class="name">camera</span>
<span class="name">exposure</span>.exposureCompensation: -<span class="number">1.0</span>
<span class="name">exposure</span>.exposureMode: <span class="name">Camera</span>.<span class="name">ExposurePortrait</span>
}</pre>
<p>Several settings have both an automatic and a manual mode. In the automatic modes the camera software itself will decide what a reasonable setting is, but in most cases these settings can be overridden with a specific manual setting.</p>
<p>For example, to select automatic shutter speed selection:</p>
<pre class="cpp"> camera<span class="operator">.</span>exposure<span class="operator">.</span><a href="qml-qtmultimedia-cameraexposure.html#setAutoShutterSpeed-method">setAutoShutterSpeed</a>()</pre>
<p>Or for a specific shutter speed:</p>
<pre class="cpp"> camera<span class="operator">.</span>exposure<span class="operator">.</span>manualShutterSpeed <span class="operator">=</span> <span class="number">0.01</span> <span class="comment">// 10ms</span></pre>
<p>You can only choose one or the other mode.</p>
<!-- @@@CameraExposure -->
<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="name">aperture</span> : <span class="type">real</span></p></td></tr></table></div><div class="qmldoc"><p>This property holds the current lens aperture as an F number (the ratio of the focal length to effective aperture diameter).</p>
<p><b>See also </b><a href="qml-qtmultimedia-cameraexposure.html#manualAperture-prop">manualAperture</a> and <a href="qml-qtmultimedia-cameraexposure.html#setAutoAperture-method">setAutoAperture()</a>.</p>
</div></div><!-- @@@aperture -->
<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">real</span></p></td></tr></table></div><div class="qmldoc"><p>This property holds the adjustment value for the automatically calculated exposure. The value is in EV units.</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">enumeration</span></p></td></tr></table></div><div class="qmldoc"><p>This property holds the camera exposure mode.</p>
<p>The mode can be one of the following:</p>
<table class="generic">
<thead><tr class="qt-style"><th >Value</th><th >Description</th></tr></thead>
<tr valign="top" class="odd"><td >Camera.ExposureManual</td><td >Manual mode.</td></tr>
<tr valign="top" class="even"><td >Camera.ExposureAuto</td><td >Automatic mode.</td></tr>
<tr valign="top" class="odd"><td >Camera.ExposureNight</td><td >Night mode.</td></tr>
<tr valign="top" class="even"><td >Camera.ExposureBacklight</td><td >Backlight exposure mode.</td></tr>
<tr valign="top" class="odd"><td >Camera.ExposureSpotlight</td><td >Spotlight exposure mode.</td></tr>
<tr valign="top" class="even"><td >Camera.ExposureSports</td><td >Spots exposure mode.</td></tr>
<tr valign="top" class="odd"><td >Camera.ExposureSnow</td><td >Snow exposure mode.</td></tr>
<tr valign="top" class="even"><td >Camera.ExposureBeach</td><td >Beach exposure mode.</td></tr>
<tr valign="top" class="odd"><td >Camera.ExposureLargeAperture</td><td >Use larger aperture with small depth of field.</td></tr>
<tr valign="top" class="even"><td >Camera.ExposureSmallAperture</td><td >Use smaller aperture.</td></tr>
<tr valign="top" class="odd"><td >Camera.ExposurePortrait</td><td >Portrait exposure mode.</td></tr>
<tr valign="top" class="even"><td >Camera.ExposureModeVendor</td><td >The base value for device specific exposure modes.</td></tr>
</table>
</div></div><!-- @@@exposureMode -->
<br/>
<!-- $$$iso -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="iso-prop"></a><span class="name">iso</span> : <span class="type">int</span></p></td></tr></table></div><div class="qmldoc"><p>This property holds the sensor's ISO sensitivity value.</p>
</div></div><!-- @@@iso -->
<br/>
<!-- $$$manualAperture -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="manualAperture-prop"></a><span class="name">manualAperture</span> : <span class="type">real</span></p></td></tr></table></div><div class="qmldoc"><p>This property holds the aperture (F number) value for capturing photos.</p>
<p>If the value is less than zero, the camera automatically determines an appropriate aperture value.</p>
<p><a href="qml-qtmultimedia-cameraexposure.html#aperture-prop">aperture</a>, <a href="qml-qtmultimedia-cameraexposure.html#setAutoAperture-method">setAutoAperture()</a></p>
</div></div><!-- @@@manualAperture -->
<br/>
<!-- $$$manualIso -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="manualIso-prop"></a><span class="name">manualIso</span> : <span class="type">real</span></p></td></tr></table></div><div class="qmldoc"><p>This property holds the ISO settings for capturing photos.</p>
<p>If a negative value is specified, the camera will automatically determine an appropriate value.</p>
<p><b>See also </b><a href="qml-qtmultimedia-cameraexposure.html#iso-prop">iso</a> and <a href="qml-qtmultimedia-cameraexposure.html#setAutoIsoSensitivity-method">setAutoIsoSensitivity()</a>.</p>
</div></div><!-- @@@manualIso -->
<br/>
<!-- $$$manualShutterSpeed -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="manualShutterSpeed-prop"></a><span class="name">manualShutterSpeed</span> : <span class="type">real</span></p></td></tr></table></div><div class="qmldoc"><p>This property holds the shutter speed value (in seconds). If the value is less than zero, the camera automatically determines an appropriate shutter speed.</p>
<p><a href="qml-qtmultimedia-cameraexposure.html#shutterSpeed-prop">shutterSpeed</a>, <a href="qml-qtmultimedia-cameraexposure.html#setAutoShutterSpeed-method">setAutoShutterSpeed()</a></p>
</div></div><!-- @@@manualShutterSpeed -->
<br/>
<!-- $$$meteringMode -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="meteringMode-prop"></a><span class="name">meteringMode</span> : <span class="type">enumeration</span></p></td></tr></table></div><div class="qmldoc"><p>This property holds the camera metering mode (how exposure is balanced).</p>
<p>The mode can be one of the following:</p>
<table class="generic">
<thead><tr class="qt-style"><th >Value</th><th >Description</th></tr></thead>
<tr valign="top" class="odd"><td >Camera.MeteringMatrix</td><td >A matrix of sample points is used to measure exposure.</td></tr>
<tr valign="top" class="even"><td >Camera.MeteringAverage</td><td >An average is used to measure exposure.</td></tr>
<tr valign="top" class="odd"><td >Camera.MeteringSpot</td><td >A specific location (<a href="qml-qtmultimedia-cameraexposure.html#spotMeteringPoint-prop">spotMeteringPoint</a>) is used to measure exposure.</td></tr>
</table>
</div></div><!-- @@@meteringMode -->
<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="name">shutterSpeed</span> : <span class="type">real</span></p></td></tr></table></div><div class="qmldoc"><p>This property holds the camera's current shutter speed value in seconds. To affect the shutter speed you can use the <a href="qml-qtmultimedia-cameraexposure.html#manualShutterSpeed-prop">manualShutterSpeed</a> property and <a href="qml-qtmultimedia-cameraexposure.html#setAutoShutterSpeed-method">setAutoShutterSpeed()</a>.</p>
</div></div><!-- @@@shutterSpeed -->
<br/>
<!-- $$$spotMeteringPoint -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="spotMeteringPoint-prop"></a><span class="name">spotMeteringPoint</span> : <span class="type">QPointF</span></p></td></tr></table></div><div class="qmldoc"><p>The property holds the frame coordinates of the point to use for exposure metering. This point is only used in spot metering mode, and it typically defaults to the center <tt>(0.5, 0.5)</tt>.</p>
</div></div><!-- @@@spotMeteringPoint -->
<br/>
<h2>Method Documentation</h2>
<!-- $$$setAutoAperture -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="setAutoAperture-method"></a><span class="name">setAutoAperture</span>()</p></td></tr></table></div><div class="qmldoc"><p>Turn on auto aperture selection. The manual aperture value is reset to -1.0</p>
</div></div><!-- @@@setAutoAperture -->
<br/>
<!-- $$$setAutoIsoSensitivity -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="setAutoIsoSensitivity-method"></a><span class="name">setAutoIsoSensitivity</span>()</p></td></tr></table></div><div class="qmldoc"><p>Turn on auto ISO sensitivity selection. The manual ISO value is reset to -1.</p>
</div></div><!-- @@@setAutoIsoSensitivity -->
<br/>
<!-- $$$setAutoShutterSpeed -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="setAutoShutterSpeed-method"></a><span class="name">setAutoShutterSpeed</span>()</p></td></tr></table></div><div class="qmldoc"><p>Turn on auto shutter speed selection. The manual shutter speed value is reset to -1.0</p>
</div></div><!-- @@@setAutoShutterSpeed -->
<br/>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2013 Digia Plc and/or its
subsidiaries. Documentation contributions included herein are the copyrights of
their respective owners.<br> The documentation provided herein is licensed under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.<br> Digia, Qt and their respective logos are trademarks of Digia Plc in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. </p>
</div>
</body>
</html>
|