Класс QCameraExposureControl
Класс QCameraExposureControl позволяет управлять параметрами экспозиции камеры. Подробнее...
| Заголовок: | #include <QCameraExposureControl> |
| qmake: | QT += multimedia |
| Наследует: | QMediaControl |
Типы public
| перечисление | ExposureParameter { ISO, Aperture, ShutterSpeed, ExposureCompensation, FlashPower, …, ExtendedExposureParameter } |
Функции public
| виртуальный | ~QCameraExposureControl() |
| виртуальный QVariant | actualValue(QCameraExposureControl::ExposureParameter parameter) const = 0 |
| виртуальный bool | isParameterSupported(QCameraExposureControl::ExposureParameter parameter) const = 0 |
| виртуальный QVariant | requestedValue(QCameraExposureControl::ExposureParameter parameter) const = 0 |
| виртуальный bool | setValue(QCameraExposureControl::ExposureParameter parameter, const QVariant &value) = 0 |
| виртуальный QVariantList | supportedParameterRange(QCameraExposureControl::ExposureParameter parameter, bool *continuous) const = 0 |
Сигналы
| void | actualValueChanged(int parameter) |
| void | parameterRangeChanged(int parameter) |
| void | requestedValueChanged(int parameter) |
Защищенные функции
| QCameraExposureControl(QObject *parent = nullptr) |
Макросы
| QCameraExposureControl_iid |
Подробное описание
Класс QCameraExposure — это стандартный метод настройки параметров экспозиции при использовании функций камеры. Этот класс предоставляет более полный, но менее удобный в использовании интерфейс, а также служит интерфейсом для реализации при написании новой реализации функциональности QCamera.
Вы можете настроить ряд параметров, которые повлияют на изображения и видео, снятые с помощью соответствующего объекта QCamera — см. перечисление ExposureParameter.
Имя интерфейса QCameraExposureControl составляет org.qt-project.qt.cameraexposurecontrol/5.0 как определено в QCameraExposureControl_iid.
См. также QCameraExposure и QCamera.
Документация по типам членов
перечисление QCameraExposureControl::ExposureParameter
| Константа | Значение | Описание |
|---|---|---|
QCameraExposureControl::ISO |
0 |
Чувствительность ISO камеры, задается как целое число. |
QCameraExposureControl::Aperture |
1 |
Диафрагма объектива задается как числовая величина f. Поддерживаемые значения диафрагмы могут изменяться в зависимости от фокусного расстояния; в таком случае излучается сигнал parameterRangeChanged(). |
QCameraExposureControl::ShutterSpeed |
2 |
Выдержка в секундах, задается как qreal. |
QCameraExposureControl::ExposureCompensation |
3 |
Компенсация экспозиции, задается как значение EV qreal. |
QCameraExposureControl::FlashPower |
4 |
Ручная мощность вспышки, задается как значение qreal. Допустимый диапазон мощностей [0..1.0], значение 0 означает отсутствие вспышки, а 1.0 соответствует полной мощности вспышки. |
Это значение используется только в ручном режиме вспышки.
| Константа | Значение | Описание |
|---|---|---|
QCameraExposureControl::TorchPower |
6 |
Ручная мощность фонарика, задается как значение qreal. Допустимый диапазон мощностей [0..1.0], значение 0 означает отсутствие света, а 1.0 соответствует полной мощности фонарика. |
Это значение используется только в режиме фонарика вспышки.
| Константа | Значение | Описание |
|---|---|---|
QCameraExposureControl::FlashCompensation |
5 |
Компенсация вспышки, задается как значение EV qreal. |
QCameraExposureControl::SpotMeteringPoint |
7 |
Относительные координаты кадра точки, используемой для измерений экспозиции в режиме точечного измерения, задается как QPointF. |
QCameraExposureControl::ExposureMode |
8 |
Режим экспозиции камеры. |
QCameraExposureControl::MeteringMode |
9 |
Режим замера камеры. |
QCameraExposureControl::ExtendedExposureParameter |
1000 |
Базовое значение для платформоспецифических расширенных параметров. Для таких параметров должны использоваться последовательные значения, начиная с ExtendedExposureParameter. |
Документация по функциям членов
[protected] QCameraExposureControl::QCameraExposureControl(QObject *parent = nullptr)
Создает объект управления экспозицией камеры с parent.
[signal] void QCameraExposureControl::actualValueChanged(int parameter)
Сигнал, излучаемый при изменении фактического значения параметра parameter, обычно в результате работы алгоритмов автоматической экспозиции или примененного ручного параметра экспозиции.
Функция была добавлена в Qt 5.0.
[signal] void QCameraExposureControl::parameterRangeChanged(int parameter)
Сигнал, излучаемый при изменении поддерживаемого диапазона значений параметра parameter экспозиции.
Функция была добавлена в Qt 5.0.
[signal] void QCameraExposureControl::requestedValueChanged(int parameter)
Сигнал, излучаемый при изменении запрошенного значения параметра parameter экспозиции, обычно в результате вызова setValue().
Функция была добавлена в Qt 5.0.
[virtual] QCameraExposureControl::~QCameraExposureControl()
Уничтожает объект управления экспозицией камеры.
[pure virtual] QVariant QCameraExposureControl::actualValue(QCameraExposureControl::ExposureParameter parameter) const
Возвращает фактическое значение параметра parameter экспозиции или недействительный QVariant() если значение неизвестно или не поддерживается.
Фактическое значение параметра может отличаться от запрошенного, если выбран автоматический режим или камера поддерживает только ограниченный набор значений в пределах поддерживаемого диапазона.
Функция была добавлена в Qt 5.0.
[pure virtual] bool QCameraExposureControl::isParameterSupported(QCameraExposureControl::ExposureParameter parameter) const
Возвращает true, если параметр parameter экспозиции поддерживается бэкендом.
Функция была добавлена в Qt 5.0.
[pure virtual] QVariant QCameraExposureControl::requestedValue(QCameraExposureControl::ExposureParameter parameter) const
Возвращает запрошенное значение параметра parameter экспозиции.
Функция была добавлена в Qt 5.0.
[pure virtual] bool QCameraExposureControl::setValue(QCameraExposureControl::ExposureParameter parameter, const QVariant &value)
Установите параметр экспозиции parameter в значение value. Если передан null или некорректный QVariant, бэкенд должен автоматически выбрать значение и, если возможно, сообщить фактическое значение пользователю с помощью QCameraExposureControl::actualValue().
Возвращает true, если параметр поддерживается и значение корректно.
Эта функция была добавлена в Qt 5.0.
[pure virtual] QVariantList QCameraExposureControl::supportedParameterRange(QCameraExposureControl::ExposureParameter parameter, bool *continuous) const
Возвращает список поддерживаемых значений параметра parameter;
Если камера поддерживает произвольное значение параметра экспозиции в пределах допустимого диапазона, *continuous устанавливается в true, в противном случае *continuous устанавливается в false.
Эта функция была добавлена в Qt 5.0.
Документация макросов
QCameraExposureControl_iid
org.qt-project.qt.cameraexposurecontrol/5.0
Определяет имя интерфейса класса QCameraExposureControl.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/qcameraexposurecontrol.html