Класс QCameraImageProcessingControl
Класс QCameraImageProcessingControl предоставляет абстрактный класс для управления параметрами обработки изображений, такими как баланс белого, контраст, насыщенность, резкость и шумоподавление. Подробнее...
| Заголовок: | #include <QCameraImageProcessingControl> |
| qmake: | QT += multimedia |
| Наследует: | QMediaControl |
Открытые типы
| перечисление | ProcessingParameter { WhiteBalancePreset, ColorTemperature, Contrast, Saturation, Brightness, …, ExtendedParameter } |
Открытые функции
| виртуальный | ~QCameraImageProcessingControl() |
| виртуальный bool | isParameterSupported(QCameraImageProcessingControl::ProcessingParameter parameter) const = 0 |
| виртуальный bool | isParameterValueSupported(QCameraImageProcessingControl::ProcessingParameter parameter, const QVariant &value) const = 0 |
| виртуальный QVariant | parameter(QCameraImageProcessingControl::ProcessingParameter parameter) const = 0 |
| виртуальный void | setParameter(QCameraImageProcessingControl::ProcessingParameter parameter, const QVariant &value) = 0 |
Защищенные функции
| QCameraImageProcessingControl(QObject *parent = nullptr) |
Макросы
| QCameraImageProcessingControl_iid |
Подробное описание
Имя интерфейса 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 = nullptr)
Конструирует объект управления обработкой изображений с parent.
[virtual] QCameraImageProcessingControl::~QCameraImageProcessingControl()
Деструктор объекта управления обработкой изображений.
[pure virtual] bool QCameraImageProcessingControl::isParameterSupported(QCameraImageProcessingControl::ProcessingParameter parameter) const
Возвращает true, если камера поддерживает настройку параметра обработки изображения parameter.
Обычно поддерживаемая настройка является статической, но некоторые параметры могут быть недоступны в зависимости от других настроек камеры, например, предустановок. В этом случае должны быть возвращены текущие поддерживаемые параметры.
[pure virtual] bool QCameraImageProcessingControl::isParameterValueSupported(QCameraImageProcessingControl::ProcessingParameter parameter, const QVariant &value) const
Возвращает true, если камера поддерживает установку значения параметра обработки изображения parameter value.
Используется только для параметров с ограниченным набором значений, например, WhiteBalancePreset.
[pure virtual] QVariant QCameraImageProcessingControl::parameter(QCameraImageProcessingControl::ProcessingParameter parameter) const
Возвращает значение параметра обработки изображения parameter.
См. также setParameter().
[pure virtual] void QCameraImageProcessingControl::setParameter(QCameraImageProcessingControl::ProcessingParameter parameter, const QVariant &value)
Устанавливает значение параметра обработки изображения parameter value. Передача нулевого или недопустимого значения 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.14/qcameraimageprocessingcontrol.html