QCameraImageProcessingControl Class

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

头: #include <QCameraImageProcessingControl>
qmake: QT += multimedia
继承: QMediaControl

该类已过时。 提供它是为使旧源代码能继续工作。强烈建议不要在新代码中使用它。

公共类型

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

公共函数

virtual ~QCameraImageProcessingControl ()
virtual bool isParameterSupported (QCameraImageProcessingControl::ProcessingParameter 参数 ) const = 0
virtual bool isParameterValueSupported (QCameraImageProcessingControl::ProcessingParameter 参数 , const QVariant & value ) const = 0
virtual QVariant 参数 (QCameraImageProcessingControl::ProcessingParameter 参数 ) const = 0
virtual void setParameter (QCameraImageProcessingControl::ProcessingParameter 参数 , const QVariant & value ) = 0

保护函数

QCameraImageProcessingControl (QObject * parent = nullptr)

QCameraImageProcessingControl_iid

详细描述

The interface name of QCameraImageProcessingControl is org.qt-project.qt.cameraimageprocessingcontrol/5.0 作为定义在 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.

另请参阅 QMediaService::requestControl () 和 QCamera .

成员类型文档编制

enum QCameraImageProcessingControl:: ProcessingParameter

常量 描述
QCameraImageProcessingControl::WhiteBalancePreset 0 The white balance preset.
QCameraImageProcessingControl::ColorTemperature 1 Color temperature in K. This value is used when the manual white balance mode is selected.
QCameraImageProcessingControl::Contrast 2 Image contrast.
QCameraImageProcessingControl::Saturation 3 Image saturation.
QCameraImageProcessingControl::Brightness 4 Image brightness.
QCameraImageProcessingControl::Sharpening 5 Amount of sharpening applied.
QCameraImageProcessingControl::Denoising 6 Amount of denoising applied.
QCameraImageProcessingControl::ContrastAdjustment 7 Image contrast adjustment.
QCameraImageProcessingControl::SaturationAdjustment 8 Image saturation adjustment.
QCameraImageProcessingControl::BrightnessAdjustment 9 Image brightness adjustment.
QCameraImageProcessingControl::SharpeningAdjustment 10 Adjustment of sharpening applied.
QCameraImageProcessingControl::DenoisingAdjustment 11 Adjustment of denoising applied.
QCameraImageProcessingControl::ColorFilter 12 Image filter applied. Since 5.5
QCameraImageProcessingControl::ExtendedParameter 1000 The base value for platform specific extended parameters.

成员函数文档编制

[protected] QCameraImageProcessingControl:: QCameraImageProcessingControl ( QObject * parent = nullptr)

Constructs an image processing control object with parent .

[虚拟] QCameraImageProcessingControl:: ~QCameraImageProcessingControl ()

Destruct the image processing control object.

[pure virtual] bool QCameraImageProcessingControl:: isParameterSupported ( QCameraImageProcessingControl::ProcessingParameter 参数 ) const

Returns true if the camera supports adjusting image processing 参数 .

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.

[pure virtual] bool QCameraImageProcessingControl:: isParameterValueSupported ( QCameraImageProcessingControl::ProcessingParameter 参数 , const QVariant & value ) const

Returns true if the camera supports setting the image processing 参数 value .

It's used only for parameters with a limited set of values, like WhiteBalancePreset .

[pure virtual] QVariant QCameraImageProcessingControl:: 参数 ( QCameraImageProcessingControl::ProcessingParameter 参数 ) const

Returns the image processing 参数 值。

另请参阅 setParameter ().

[pure virtual] void QCameraImageProcessingControl:: setParameter ( QCameraImageProcessingControl::ProcessingParameter 参数 , const QVariant & value )

Sets the image processing 参数 value . Passing the null or invalid QVariant value allows backend to choose the suitable parameter value.

The valid values range depends on the parameter type. For WhiteBalancePreset the value should be one of QCameraImageProcessing::WhiteBalanceMode 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 ContrastAdjustment , SaturationAdjustment , BrightnessAdjustment , SharpeningAdjustment and DenoisingAdjustment the value should be in [-1.0..1.0] range with default 0.

另请参阅 参数 ().

宏文档编制

QCameraImageProcessingControl_iid

org.qt-project.qt.cameraimageprocessingcontrol/5.0

定义接口名为 QCameraImageProcessingControl 类。