Класс QCameraImageProcessingControl
Класс QCameraImageProcessingControl предоставляет абстрактный класс для управления параметрами обработки изображений, такими как баланс белого, контраст, насыщенность, резкость и шумоподавление. Подробнее...
| Заголовок: | #include <QCameraImageProcessingControl> |
| qmake: | QT += multimedia |
| Наследуется от: | QMediaControl |
Открытые типы
| перечисление | ProcessingParameter { BalanceБелогоПресет, ТемператураЦвета, Контраст, Насыщенность, ..., РасширенныйПараметр } |
Открытые функции
| виртуальный | ~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 и т. д., позволяют настраивать значения параметров, выбранные движком камеры, в то время как параметры, такие как Контраст и Насыщенность, перезаписывают их.
Например, установка параметра 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.
Используется только для параметров с ограниченным набором значений, например, BalanceБелогоПресет.
[pure virtual] QVariant QCameraImageProcessingControl::parameter(QCameraImageProcessingControl::ProcessingParameter parameter) const
Возвращает значение параметра обработки изображения parameter.
См. также setParameter().
[pure virtual] void QCameraImageProcessingControl::setParameter(QCameraImageProcessingControl::ProcessingParameter parameter, const QVariant &value)
Устанавливает значение параметра обработки изображения parameter value. Передача значения null или недействительного QVariant позволяет бэкенду выбрать подходящее значение параметра.
Диапазон допустимых значений зависит от типа параметра. Для BalanceБелогоПресет значение должно быть одним из значений QCameraImageProcessing::WhiteBalanceMode; для Контраста, Насыщенности, Яркости, Резкости и Шумоподавления значение должно быть в диапазоне [0..1,0] с недействительным значением QVariant, указывающим на значение параметра по умолчанию; для ContrastAdjustment, SaturationAdjustment, BrightnessAdjustment, SharpeningAdjustment и DenoisingAdjustment значение должно быть в диапазоне [-1,0..1,0] с значением по умолчанию 0.
См. также parameter().
END_OF_DOCUMENT_MARKER ```Документация макросов
QCameraImageProcessingControl::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.13/qcameraimageprocessingcontrol.html