/usr/share/qt5/doc/qtmultimedia/qcameraimageprocessingcontrol.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 | <?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" />
<!-- qcameraimageprocessingcontrol.cpp -->
<title>QCameraImageProcessingControl Class | 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-module.html">C++ Classes</a></li>
<li>QCameraImageProcessingControl</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="#public-types">Public Types</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#protected-functions">Protected Functions</a></li>
<li class="level1"><a href="#macros">Macros</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QCameraImageProcessingControl Class</h1>
<!-- $$$QCameraImageProcessingControl-brief -->
<p>The QCameraImageProcessingControl class provides an abstract class for controlling image processing parameters, like white balance, contrast, saturation, sharpening and denoising. <a href="#details">More...</a></p>
<!-- @@@QCameraImageProcessingControl -->
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> Header:</td><td class="memItemRight bottomAlign"> </b><tt><span class="preprocessor">#include <QCameraImageProcessingControl></span>
</tt></td></tr><tr><td class="memItemLeft rightAlign topAlign"> qmake:</td><td class="memItemRight bottomAlign"> <tt>QT += multimedia</tt></td></tr><tr><td class="memItemLeft rightAlign topAlign"> Inherits:</td><td class="memItemRight bottomAlign"> <a href="qmediacontrol.html">QMediaControl</a>.</td></tr></table><ul>
<li><a href="qcameraimageprocessingcontrol-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="qcameraimageprocessingcontrol.html#ProcessingParameter-enum">ProcessingParameter</a></b> { WhiteBalancePreset, ColorTemperature, Contrast, Saturation, ..., ExtendedParameter }</td></tr>
</table>
<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="qcameraimageprocessingcontrol.html#dtor.QCameraImageProcessingControl">~QCameraImageProcessingControl</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qcameraimageprocessingcontrol.html#isParameterSupported">isParameterSupported</a></b>(ProcessingParameter<i> parameter</i>) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qcameraimageprocessingcontrol.html#isParameterValueSupported">isParameterValueSupported</a></b>(ProcessingParameter<i> parameter</i>, const QVariant &<i> value</i>) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QVariant </td><td class="memItemRight bottomAlign"><b><a href="qcameraimageprocessingcontrol.html#parameter">parameter</a></b>(ProcessingParameter<i> parameter</i>) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qcameraimageprocessingcontrol.html#setParameter">setParameter</a></b>(ProcessingParameter<i> parameter</i>, const QVariant &<i> value</i>) = 0</td></tr>
</table>
<a name="protected-functions"></a>
<h2>Protected Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qcameraimageprocessingcontrol.html#QCameraImageProcessingControl">QCameraImageProcessingControl</a></b>(QObject *<i> parent</i> = 0)</td></tr>
</table>
<a name="macros"></a>
<h2>Macros</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qcameraimageprocessingcontrol.html#QCameraImageProcessingControl_iid">QCameraImageProcessingControl_iid</a></b></td></tr>
</table>
<a name="details"></a>
<!-- $$$QCameraImageProcessingControl-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QCameraImageProcessingControl class provides an abstract class for controlling image processing parameters, like white balance, contrast, saturation, sharpening and denoising.</p>
<p>The interface name of QCameraImageProcessingControl is <tt>org.qt-project.qt.cameraimageprocessingcontrol/5.0</tt> as defined in <a href="qcameraimageprocessingcontrol.html#QCameraImageProcessingControl_iid">QCameraImageProcessingControl_iid</a>.</p>
<p>Camera service may choose the parameters of image processing pipeline depending on sensor properties camera settings and capture parameters.</p>
<p>This control allows to modify some parameters of image processing pipeline to achieve desired results.</p>
<p>Parameters with the "Adjustment" suffix, like <a href="qcameraimageprocessingcontrol.html#ProcessingParameter-enum">ContrastAdjustment</a>, <a href="qcameraimageprocessingcontrol.html#ProcessingParameter-enum">SaturationAdjustment</a> etc allows to adjust the parameter values, selected by camera engine, while parameters like Contrast and Saturation overwrites them.</p>
<p>For example setting the <a href="qcameraimageprocessingcontrol.html#ProcessingParameter-enum">SharpeningAdjustment</a> parameter to -0.1 slightly reduces the amount of sharpening applied, while settings the Sharpening parameter to 0 disables sharpening at all.</p>
</div>
<p><b>See also </b><a href="qmediaservice.html#requestControl">QMediaService::requestControl</a>() and <a href="qcamera.html">QCamera</a>.</p>
<!-- @@@QCameraImageProcessingControl -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$ProcessingParameter$$$WhiteBalancePreset$$$ColorTemperature$$$Contrast$$$Saturation$$$Brightness$$$Sharpening$$$Denoising$$$ContrastAdjustment$$$SaturationAdjustment$$$BrightnessAdjustment$$$SharpeningAdjustment$$$DenoisingAdjustment$$$ExtendedParameter -->
<h3 class="fn"><a name="ProcessingParameter-enum"></a>enum QCameraImageProcessingControl::<span class="name">ProcessingParameter</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>QCameraImageProcessingControl::WhiteBalancePreset</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">The white balance preset.</td></tr>
<tr><td class="topAlign"><tt>QCameraImageProcessingControl::ColorTemperature</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">Color temperature in K. This value is used when the manual white balance mode is selected.</td></tr>
<tr><td class="topAlign"><tt>QCameraImageProcessingControl::Contrast</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">Image contrast.</td></tr>
<tr><td class="topAlign"><tt>QCameraImageProcessingControl::Saturation</tt></td><td class="topAlign"><tt>3</tt></td><td class="topAlign">Image saturation.</td></tr>
<tr><td class="topAlign"><tt>QCameraImageProcessingControl::Brightness</tt></td><td class="topAlign"><tt>4</tt></td><td class="topAlign">Image brightness.</td></tr>
<tr><td class="topAlign"><tt>QCameraImageProcessingControl::Sharpening</tt></td><td class="topAlign"><tt>5</tt></td><td class="topAlign">Amount of sharpening applied.</td></tr>
<tr><td class="topAlign"><tt>QCameraImageProcessingControl::Denoising</tt></td><td class="topAlign"><tt>6</tt></td><td class="topAlign">Amount of denoising applied.</td></tr>
<tr><td class="topAlign"><tt>QCameraImageProcessingControl::ContrastAdjustment</tt></td><td class="topAlign"><tt>7</tt></td><td class="topAlign">Image contrast adjustment.</td></tr>
<tr><td class="topAlign"><tt>QCameraImageProcessingControl::SaturationAdjustment</tt></td><td class="topAlign"><tt>8</tt></td><td class="topAlign">Image saturation adjustment.</td></tr>
<tr><td class="topAlign"><tt>QCameraImageProcessingControl::BrightnessAdjustment</tt></td><td class="topAlign"><tt>9</tt></td><td class="topAlign">Image brightness adjustment.</td></tr>
<tr><td class="topAlign"><tt>QCameraImageProcessingControl::SharpeningAdjustment</tt></td><td class="topAlign"><tt>10</tt></td><td class="topAlign">Adjustment of sharpening applied.</td></tr>
<tr><td class="topAlign"><tt>QCameraImageProcessingControl::DenoisingAdjustment</tt></td><td class="topAlign"><tt>11</tt></td><td class="topAlign">Adjustment of denoising applied.</td></tr>
<tr><td class="topAlign"><tt>QCameraImageProcessingControl::ExtendedParameter</tt></td><td class="topAlign"><tt>1000</tt></td><td class="topAlign">The base value for platform specific extended parameters.</td></tr>
</table>
<!-- @@@ProcessingParameter -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QCameraImageProcessingControl[overload1]$$$QCameraImageProcessingControlQObject* -->
<h3 class="fn"><a name="QCameraImageProcessingControl"></a>QCameraImageProcessingControl::<span class="name">QCameraImageProcessingControl</span>(<span class="type">QObject</span> *<i> parent</i> = 0)<tt> [protected]</tt></h3>
<p>Constructs an image processing control object with <i>parent</i>.</p>
<!-- @@@QCameraImageProcessingControl -->
<!-- $$$~QCameraImageProcessingControl[overload1]$$$~QCameraImageProcessingControl -->
<h3 class="fn"><a name="dtor.QCameraImageProcessingControl"></a>QCameraImageProcessingControl::<span class="name">~QCameraImageProcessingControl</span>()</h3>
<p>Destruct the image processing control object.</p>
<!-- @@@~QCameraImageProcessingControl -->
<!-- $$$isParameterSupported[overload1]$$$isParameterSupportedProcessingParameter -->
<h3 class="fn"><a name="isParameterSupported"></a><span class="type">bool</span> QCameraImageProcessingControl::<span class="name">isParameterSupported</span>(<span class="type"><a href="qcameraimageprocessingcontrol.html#ProcessingParameter-enum">ProcessingParameter</a></span><i> parameter</i>) const<tt> [pure virtual]</tt></h3>
<p>Returns true if the camera supports adjusting image processing <i>parameter</i>.</p>
<p>Usually the supported setting is static, but some parameters may not be available depending on other camera settings, like presets. In such case the currently supported parameters should be returned.</p>
<!-- @@@isParameterSupported -->
<!-- $$$isParameterValueSupported[overload1]$$$isParameterValueSupportedProcessingParameterconstQVariant& -->
<h3 class="fn"><a name="isParameterValueSupported"></a><span class="type">bool</span> QCameraImageProcessingControl::<span class="name">isParameterValueSupported</span>(<span class="type"><a href="qcameraimageprocessingcontrol.html#ProcessingParameter-enum">ProcessingParameter</a></span><i> parameter</i>, const <span class="type">QVariant</span> &<i> value</i>) const<tt> [pure virtual]</tt></h3>
<p>Returns true if the camera supports setting the image processing <i>parameter</i> <i>value</i>.</p>
<p>It's used only for parameters with a limited set of values, like <a href="qcameraimageprocessingcontrol.html#ProcessingParameter-enum">WhiteBalancePreset</a>.</p>
<!-- @@@isParameterValueSupported -->
<!-- $$$parameter[overload1]$$$parameterProcessingParameter -->
<h3 class="fn"><a name="parameter"></a><span class="type">QVariant</span> QCameraImageProcessingControl::<span class="name">parameter</span>(<span class="type"><a href="qcameraimageprocessingcontrol.html#ProcessingParameter-enum">ProcessingParameter</a></span><i> parameter</i>) const<tt> [pure virtual]</tt></h3>
<p>Returns the image processing <i>parameter</i> value.</p>
<p><b>See also </b><a href="qcameraimageprocessingcontrol.html#setParameter">setParameter</a>().</p>
<!-- @@@parameter -->
<!-- $$$setParameter[overload1]$$$setParameterProcessingParameterconstQVariant& -->
<h3 class="fn"><a name="setParameter"></a><span class="type">void</span> QCameraImageProcessingControl::<span class="name">setParameter</span>(<span class="type"><a href="qcameraimageprocessingcontrol.html#ProcessingParameter-enum">ProcessingParameter</a></span><i> parameter</i>, const <span class="type">QVariant</span> &<i> value</i>)<tt> [pure virtual]</tt></h3>
<p>Sets the image processing <i>parameter</i> <i>value</i>. Passing the null or invalid QVariant value allows backend to choose the suitable parameter value.</p>
<p>The valid values range depends on the parameter type. For <a href="qcameraimageprocessingcontrol.html#ProcessingParameter-enum">WhiteBalancePreset</a> the value should be one of <a href="qcameraimageprocessing.html#WhiteBalanceMode-enum">QCameraImageProcessing::WhiteBalanceMode</a> values; for Contrast, Saturation, Brightness, Sharpening and Denoising the value should be in [0..1.0] range with invalid QVariant value indicating the default parameter value; for <a href="qcameraimageprocessingcontrol.html#ProcessingParameter-enum">ContrastAdjustment</a>, <a href="qcameraimageprocessingcontrol.html#ProcessingParameter-enum">SaturationAdjustment</a>, <a href="qcameraimageprocessingcontrol.html#ProcessingParameter-enum">BrightnessAdjustment</a>, <a href="qcameraimageprocessingcontrol.html#ProcessingParameter-enum">SharpeningAdjustment</a> and <a href="qcameraimageprocessingcontrol.html#ProcessingParameter-enum">DenoisingAdjustment</a> the value should be in [-1.0..1.0] range with default 0.</p>
<p><b>See also </b><a href="qcameraimageprocessingcontrol.html#parameter">parameter</a>().</p>
<!-- @@@setParameter -->
</div>
<div class="macros">
<h2>Macro Documentation</h2>
<!-- $$$QCameraImageProcessingControl_iid[overload1]$$$QCameraImageProcessingControl_iid -->
<h3 class="fn"><a name="QCameraImageProcessingControl_iid"></a><span class="name">QCameraImageProcessingControl_iid</span></h3>
<p><tt>org.qt-project.qt.cameraimageprocessingcontrol/5.0</tt></p>
<p>Defines the interface name of the <a href="qcameraimageprocessingcontrol.html">QCameraImageProcessingControl</a> class.</p>
<!-- @@@QCameraImageProcessingControl_iid -->
</div>
</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>
|