Класс QCameraImageProcessingControl
Класс QCameraImageProcessingControl предоставляет абстрактный класс для управления параметрами обработки изображений, такими как баланс белого, контрастность, насыщенность, резкость и шумоподавление.
| Заголовок: | #include <QCameraImageProcessingControl> |
| qmake: | QT += multimedia |
| Наследует: | QMediaControl |
Общедоступные типы
| перечисление | ProcessingParameter { WhiteBalancePreset, ColorTemperature, Contrast, Saturation, ..., ExtendedParameter } |
Общедоступные функции
| ~QCameraImageProcessingControl() | |
| виртуальная bool | isParameterSupported(ProcessingParameter parameter) const = 0 |
| виртуальная bool | isParameterValueSupported(ProcessingParameter parameter, const QVariant &value) const = 0 |
| виртуальная QVariant | parameter(ProcessingParameter parameter) const = 0 |
| виртуальный void | setParameter(ProcessingParameter parameter, const QVariant &value) = 0 |
- 32 общедоступных функции, унаследованные от QObject
Защищённые функции
| QCameraImageProcessingControl(QObject *parent = Q_NULLPTR) |
- 9 защищённых функций, унаследованных от QObject
Макросы
| QCameraImageProcessingControl_iid |
Дополнительные унаследованные члены
- 1 свойство, унаследованное от QObject
- 1 общедоступный слот, унаследованный от QObject
- 2 сигнала, унаследованные от QObject
- 11 статические общедоступные члены, унаследованные от QObject
Подробное описание
Класс QCameraImageProcessingControl предоставляет абстрактный класс для управления параметрами обработки изображений, такими как баланс белого, контрастность, насыщенность, резкость и шумоподавление.
Имя интерфейса QCameraImageProcessingControl — org.qt-project.qt.cameraimageprocessingcontrol/5.0, как определено в QCameraImageProcessingControl_iid.
Сервис камеры может выбирать параметры обработки изображений в зависимости от свойств сенсора, настроек камеры и параметров захвата.
Данный класс позволяет изменять некоторые параметры обработки изображений для достижения желаемых результатов.
Параметры с суффиксом «Настройка», такие как ContrastAdjustment, SaturationAdjustment и т. д., позволяют настраивать значения параметров, выбранные движком камеры, в то время как параметры, такие как Contrast и Saturation, перезаписывают их.
Например, установка параметра SharpeningAdjustment в -0,1 немного уменьшает количество применяемой резкости, в то время как установка параметра Sharpening в 0 отключает резкость полностью.
См. также QMediaService::requestControl() и QCamera.
Документация по типам членов
перечисление QCameraImageProcessingControl::ProcessingParameter
| Константа | Значение | Описание |
|---|---|---|
QCameraImageProcessingControl::WhiteBalancePreset |
0 |
Настройка баланса белого. |
QCameraImageProcessingControl::ColorTemperature |
1 |
Цветовая температура в К. Это значение используется при выборе ручного режима баланса белого. |
QCameraImageProcessingControl::Contrast |
2 |
Контрастность изображения. |
QCameraImageProcessingControl::Saturation |
3 |
Насыщенность изображения. |
QCameraImageProcessingControl::Brightness |
4 |
Яркость изображения. |
QCameraImageProcessingControl::Sharpening |
5 |
Степень резкости. |
QCameraImageProcessingControl::Denoising |
6 |
Степень шумоподавления. |
QCameraImageProcessingControl::ContrastAdjustment |
7 |
Настройка контрастности. |
QCameraImageProcessingControl::SaturationAdjustment |
8 |
Настройка насыщенности. |
QCameraImageProcessingControl::BrightnessAdjustment |
9 |
Настройка яркости. |
QCameraImageProcessingControl::SharpeningAdjustment |
10 |
Настройка резкости. |
QCameraImageProcessingControl::DenoisingAdjustment |
11 |
Настройка шумоподавления. |
QCameraImageProcessingControl::ColorFilter |
12 |
Применяемый фильтр изображения. С версии 5.5 |
QCameraImageProcessingControl::ExtendedParameter |
1000 |
Базовое значение для платформенно-зависимых расширенных параметров. |
Документация по функциям членов
[protected] QCameraImageProcessingControl::QCameraImageProcessingControl(QObject *parent = Q_NULLPTR)
Создаёт объект управления обработкой изображений с parent.
QCameraImageProcessingControl::~QCameraImageProcessingControl()
Уничтожает объект управления обработкой изображений.
[pure virtual] bool QCameraImageProcessingControl::isParameterSupported(ProcessingParameter parameter) const
Возвращает true, если камера поддерживает настройку параметра обработки изображения parameter.
Обычно поддерживаемые настройки являются статическими, но некоторые параметры могут быть недоступны в зависимости от других настроек камеры, таких как предустановки. В таком случае должны быть возвращены текущие поддерживаемые параметры.
[pure virtual] bool QCameraImageProcessingControl::isParameterValueSupported(ProcessingParameter parameter, const QVariant &value) const
Возвращает true, если камера поддерживает установку значения параметра обработки изображения parameter со значением value.
Используется только для параметров с ограниченным набором значений, таких как WhiteBalancePreset.
[pure virtual] QVariant QCameraImageProcessingControl::parameter(ProcessingParameter parameter) const
Возвращает значение параметра обработки изображения parameter.
См. также setParameter().
[pure virtual] void QCameraImageProcessingControl::setParameter(ProcessingParameter parameter, const QVariant &value)
Устанавливает значение параметра обработки изображения parameter со значением value. Передача значения null или недопустимого QVariant позволяет бэкенду выбрать подходящее значение параметра.
Допустимый диапазон значений зависит от типа параметра. Для WhiteBalancePreset значение должно быть одним из значений QCameraImageProcessing::WhiteBalanceMode; для Contrast, Saturation, Brightness, Sharpening и Denoising значение должно находиться в диапазоне [0..1.0] с недопустимым значением QVariant, указывающим значение параметра по умолчанию; для ContrastAdjustment, SaturationAdjustment, BrightnessAdjustment, SharpeningAdjustment и DenoisingAdjustment значение должно находиться в диапазоне [-1.0..1.0] с значением по умолчанию 0.
См. также parameter().
Документация макросов
QCameraImageProcessingControl_iid
org.qt-project.qt.cameraimageprocessingcontrol/5.0
Определяет имя интерфейса класса QCameraImageProcessingControl.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qcameraimageprocessingcontrol.html