Класс QCameraImageProcessingControl
Класс QCameraImageProcessingControl предоставляет абстрактный класс для управления параметрами обработки изображений, такими как баланс белого, контраст, насыщенность, резкость и подавление шума.
| Заголовок: | #include <QCameraImageProcessingControl> |
| qmake: | QT += multimedia |
| Наследует: | QMediaControl |
Публичные типы
| перечисление | ProcessingParameter { BalanceWhitePreset, ColorTemperature, Contrast, Saturation, ..., 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 |
- 31 публичная функция унаследованная от QObject
Статические публичные члены
| const QMetaObject | staticMetaObject |
- 9 статических публичных членов, унаследованных от QObject
Защищенные функции
| QCameraImageProcessingControl(QObject *parent = nullptr) |
- 9 защищенных функций, унаследованных от QObject
Макросы
| QCameraImageProcessingControl_iid |
Дополнительные наследуемые члены
- 1 свойство, унаследованное от QObject
- 1 публичный слот, унаследованный от QObject
- 2 сигнала, унаследованные от 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 = 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.
Используется только для параметров с ограниченным набором значений, таких как BalanceWhitePreset.
[pure virtual] QVariant QCameraImageProcessingControl::parameter(QCameraImageProcessingControl::ProcessingParameter parameter) const
Возвращает значение параметра обработки изображения parameter.
См. также setParameter().
[pure virtual] void QCameraImageProcessingControl::setParameter(QCameraImageProcessingControl::ProcessingParameter parameter, const QVariant &value)
Устанавливает значение параметра обработки изображений. Передача нулевого или некорректного значения QVariant позволяет бэкэнду выбрать подходящее значение параметра.
Диапазон допустимых значений зависит от типа параметра. Для WhiteBalancePreset значение должно быть одним из значений перечисления QCameraImageProcessing::WhiteBalanceMode; для Контрастности, Насыщенности, Яркости, Резкости и Шумпонирования значение должно быть в диапазоне [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.12/qcameraimageprocessingcontrol.html