Класс 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. Передача значения null или недействительного QVariant позволяет back-end выбирать подходящее значение параметра.
Диапазон допустимых значений зависит от типа параметра. Для 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.15/qcameraimageprocessingcontrol.html