Класс QCameraImageProcessing
Класс QCameraImageProcessing предоставляет интерфейс для настроек обработки изображений, связанных с камерой. Подробнее...
| Заголовок: | #include <QCameraImageProcessing> |
| qmake: | QT += multimedia |
| Наследуется от: | QObject |
Открытые типы
| перечисление | ColorFilter { ColorFilterNone, ColorFilterGrayscale, ColorFilterNegative, ColorFilterSolarize, ..., ColorFilterVendor } |
| перечисление | WhiteBalanceMode { WhiteBalanceAuto, WhiteBalanceManual, WhiteBalanceSunlight, WhiteBalanceCloudy, ..., WhiteBalanceVendor } |
Открытые функции
| qreal | brightness() const |
| QCameraImageProcessing::ColorFilter | colorFilter() const |
| qreal | contrast() const |
| qreal | denoisingLevel() const |
| bool | isAvailable() const |
| bool | isColorFilterSupported(QCameraImageProcessing::ColorFilter filter) const |
| bool | isWhiteBalanceModeSupported(QCameraImageProcessing::WhiteBalanceMode mode) const |
| qreal | manualWhiteBalance() const |
| qreal | saturation() const |
| void | setBrightness(qreal value) |
| void | setColorFilter(QCameraImageProcessing::ColorFilter filter) |
| void | setContrast(qreal value) |
| void | setDenoisingLevel(qreal level) |
| void | setManualWhiteBalance(qreal colorTemperature) |
| void | setSaturation(qreal value) |
| void | setSharpeningLevel(qreal level) |
| void | setWhiteBalanceMode(QCameraImageProcessing::WhiteBalanceMode mode) |
| qreal | sharpeningLevel() const |
| QCameraImageProcessing::WhiteBalanceMode | whiteBalanceMode() const |
Подробное описание
После захвата данных для кадрового изображения аппаратного и программного обеспечения камеры выполняется различные задачи обработки изображений для получения конечного изображения. Это включает компенсацию цвета окружающего света, снижение шума, а также внесение других корректировок в изображение.
Вы можете получить этот класс из экземпляра объекта QCamera.
Например, вы можете установить баланс белого (или цветовую температуру), используемый для обработки изображений:
camera = new QCamera;
QCameraImageProcessing *imageProcessing = camera->imageProcessing();
if (imageProcessing->isAvailable()) {
imageProcessing->setWhiteBalanceMode(QCameraImageProcessing::WhiteBalanceFluorescent);
} Или отрегулировать количество производимого шумоподавления:
imageProcessing->setDenoisingLevel(-0.3); //reduce the amount of denoising applied
В некоторых случаях изменение этих настроек может привести к более длительной задержке перед готовностью изображения.
Дополнительную информацию об обработке изображений кадров камеры см. в разделе Обработка изображений камеры.
См. также QCameraImageProcessingControl.
Документация по типам членов
перечисление QCameraImageProcessing::ColorFilter
| Константа | Значение | Описание |
|---|---|---|
QCameraImageProcessing::ColorFilterNone |
0 |
К изображениям не применяется никакой фильтр. |
QCameraImageProcessing::ColorFilterGrayscale |
1 |
Фильтр градации серого. |
QCameraImageProcessing::ColorFilterNegative |
2 |
Фильтр отрицания. |
QCameraImageProcessing::ColorFilterSolarize |
3 |
Фильтр солнечной экспозиции. |
QCameraImageProcessing::ColorFilterSepia |
4 |
Фильтр сепии. |
QCameraImageProcessing::ColorFilterPosterize |
5 |
Фильтр посторизации. |
QCameraImageProcessing::ColorFilterWhiteboard |
6 |
Фильтр белой доски. |
QCameraImageProcessing::ColorFilterBlackboard |
7 |
Фильтр чёрной доски. |
QCameraImageProcessing::ColorFilterAqua |
8 |
Фильтр аква. |
QCameraImageProcessing::ColorFilterVendor |
1000 |
Базовое значение для фильтров, определённых поставщиком. |
Это перечисление было введено или изменено в Qt 5.5.
перечисление QCameraImageProcessing::WhiteBalanceMode
| Константа | Значение | Описание |
|---|---|---|
QCameraImageProcessing::WhiteBalanceAuto |
0 |
Режим автоматического баланса белого. |
QCameraImageProcessing::WhiteBalanceManual |
1 |
Ручной баланс белого. В этом режиме баланс белого следует установить с помощью setManualWhiteBalance() |
QCameraImageProcessing::WhiteBalanceSunlight |
2 |
Режим баланса белого при солнечном свете. |
QCameraImageProcessing::WhiteBalanceCloudy |
3 |
Режим баланса белого при пасмурной погоде. |
QCameraImageProcessing::WhiteBalanceShade |
4 |
Режим баланса белого в тени. |
QCameraImageProcessing::WhiteBalanceTungsten |
5 |
Режим баланса белого при вольфрамовом (накаливаемом) освещении. |
QCameraImageProcessing::WhiteBalanceFluorescent |
6 |
Режим баланса белого при люминесцентном освещении. |
QCameraImageProcessing::WhiteBalanceFlash |
7 |
Режим баланса белого при вспышке. |
QCameraImageProcessing::WhiteBalanceSunset |
8 |
Режим баланса белого при закате. |
QCameraImageProcessing::WhiteBalanceVendor |
1000 |
Базовое значение для режимов баланса белого, определённых поставщиком. |
Документация по функциям-членам
qreal QCameraImageProcessing::brightness() const
Возвращает значение настройки яркости.
См. также setBrightness().
QCameraImageProcessing::ColorFilter QCameraImageProcessing::colorFilter() const
Возвращает фильтр цвета, который будет применяться к данным изображения, полученным с камеры.
Эта функция была добавлена в Qt 5.5.
См. также setColorFilter().
qreal QCameraImageProcessing::contrast() const
Возвращает значение настройки контраста.
См. также setContrast().
qreal QCameraImageProcessing::denoisingLevel() const
Возвращает уровень корректировки шумоподавления.
См. также setDenoisingLevel().
bool QCameraImageProcessing::isAvailable() const
Возвращает true, если параметры обработки изображений поддерживаются данной камерой.
bool QCameraImageProcessing::isColorFilterSupported(QCameraImageProcessing::ColorFilter filter) const
Возвращает true, если цветовой filter поддерживается.
Эта функция была добавлена в Qt 5.5.
bool QCameraImageProcessing::isWhiteBalanceModeSupported(QCameraImageProcessing::WhiteBalanceMode mode) const
Возвращает true, если режим баланса белого mode поддерживается.
qreal QCameraImageProcessing::manualWhiteBalance() const
Возвращает текущую цветовую температуру, если текущий режим баланса белого WhiteBalanceManual. Для других режимов возвращаемое значение не определено.
См. также setManualWhiteBalance().
qreal QCameraImageProcessing::saturation() const
Возвращает значение корректировки насыщенности.
См. также setSaturation().
void QCameraImageProcessing::setBrightness(qreal value)
Устанавливает корректировку яркости на value.
Допустимые значения корректировки яркости находятся в диапазоне от -1,0 до 1,0 с по умолчанию 0.
См. также brightness().
void QCameraImageProcessing::setColorFilter(QCameraImageProcessing::ColorFilter filter)
Устанавливает цветовой filter, который будет применяться к данным изображения, полученным от камеры.
Эта функция была добавлена в Qt 5.5.
См. также colorFilter().
void QCameraImageProcessing::setContrast(qreal value)
Устанавливает корректировку контраста на value.
Допустимые значения корректировки контраста находятся в диапазоне от -1,0 до 1,0 с по умолчанию 0.
См. также contrast().
void QCameraImageProcessing::setDenoisingLevel(qreal level)
Устанавливает уровень корректировки шумоподавления level.
Допустимые значения шумоподавления находятся в диапазоне от -1,0 до 1,0 с по умолчанию 0.
Если значение параметра установлено в 0, степень шумоподавления выбирается камерой и зависит от возможностей и настроек камеры. Изменение значения в диапазоне -1,0..1,0 регулирует степень шумоподавления в пределах поддерживаемого диапазона.
См. также denoisingLevel().
void QCameraImageProcessing::setManualWhiteBalance(qreal colorTemperature)
Устанавливает ручной баланс белого на colorTemperature. Используется, когда whiteBalanceMode() установлено в WhiteBalanceManual. Единицы измерения — Кельвин.
См. также manualWhiteBalance().
void QCameraImageProcessing::setSaturation(qreal value)
Устанавливает значение корректировки насыщенности на value.
Допустимые значения насыщенности находятся в диапазоне от -1,0 до 1,0 с по умолчанию 0.
См. также saturation().
void QCameraImageProcessing::setSharpeningLevel(qreal level)
Устанавливает уровень корректировки резкости level.
Допустимые значения резкости находятся в диапазоне от -1,0 до 1,0 с по умолчанию 0.
См. также sharpeningLevel().
void QCameraImageProcessing::setWhiteBalanceMode(QCameraImageProcessing::WhiteBalanceMode mode)
Устанавливает режим баланса белого на mode.
См. также whiteBalanceMode().
qreal QCameraImageProcessing::sharpeningLevel() const
Возвращает уровень корректировки резкости.
См. также setSharpeningLevel().
QCameraImageProcessing::WhiteBalanceMode QCameraImageProcessing::whiteBalanceMode() const
Возвращает используемый режим баланса белого.
См. также setWhiteBalanceMode().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.13/qcameraimageprocessing.html