QCameraImageProcessingControl Class

The QCameraImageProcessingControl class provides an abstract class for controlling image processing parameters, like white balance, contrast, saturation, sharpening and denoising. More...

Header: #include <QCameraImageProcessingControl>
qmake: QT += multimedia
Inherits: QMediaControl

This class is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Public Types

enum ProcessingParameter { WhiteBalancePreset, ColorTemperature, Contrast, Saturation, Brightness, …, ExtendedParameter }

Macros

Detailed Description

The interface name of QCameraImageProcessingControl is org.qt-project.qt.cameraimageprocessingcontrol/5.0 as defined in QCameraImageProcessingControl_iid.

Camera service may choose the parameters of image processing pipeline depending on sensor properties camera settings and capture parameters.

This control allows to modify some parameters of image processing pipeline to achieve desired results.

Parameters with the "Adjustment" suffix, like ContrastAdjustment, SaturationAdjustment etc allows to adjust the parameter values, selected by camera engine, while parameters like Contrast and Saturation overwrites them.

For example setting the SharpeningAdjustment parameter to -0.1 slightly reduces the amount of sharpening applied, while settings the Sharpening parameter to 0 disables sharpening at all.

See also QMediaService::requestControl() and QCamera.

Member Type Documentation

enum QCameraImageProcessingControl::ProcessingParameter

ConstantValueDescription
QCameraImageProcessingControl::WhiteBalancePreset0The white balance preset.
QCameraImageProcessingControl::ColorTemperature1Color temperature in K. This value is used when the manual white balance mode is selected.
QCameraImageProcessingControl::Contrast2Image contrast.
QCameraImageProcessingControl::Saturation3Image saturation.
QCameraImageProcessingControl::Brightness4Image brightness.
QCameraImageProcessingControl::Sharpening5Amount of sharpening applied.
QCameraImageProcessingControl::Denoising6Amount of denoising applied.
QCameraImageProcessingControl::ContrastAdjustment7Image contrast adjustment.
QCameraImageProcessingControl::SaturationAdjustment8Image saturation adjustment.
QCameraImageProcessingControl::BrightnessAdjustment9Image brightness adjustment.
QCameraImageProcessingControl::SharpeningAdjustment10Adjustment of sharpening applied.
QCameraImageProcessingControl::DenoisingAdjustment11Adjustment of denoising applied.
QCameraImageProcessingControl::ColorFilter12Image filter applied. Since 5.5
QCameraImageProcessingControl::ExtendedParameter1000The base value for platform specific extended parameters.

Macro Documentation

QCameraImageProcessingControl_iid

org.qt-project.qt.cameraimageprocessingcontrol/5.0

Defines the interface name of the QCameraImageProcessingControl class.