Класс QCameraExposureControl
Класс QCameraExposureControl позволяет управлять параметрами экспозиции камеры. Подробнее...
| Заголовок: | #include <QCameraExposureControl> |
| qmake: | QT += multimedia |
| Наследуется от: | QMediaControl |
Этот класс устарел. Он предоставляется для совместимости со старым кодом. Мы настоятельно рекомендуем не использовать его в новом коде.
Типы публичного доступа
| перечисление | ExposureParameter { ISO, Aperture, ShutterSpeed, ExposureCompensation, FlashPower, …, ExtendedExposureParameter } |
Функции публичного доступа
| виртуальный | ~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. Поддерживаемый список диафрагм может меняться в зависимости от фокусного расстояния, в таком случае излучается сигнал exposureParameterRangeChanged(). |
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.
END_OF_DOCUMENT_MARKER
[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. Если передан нулевой или некорректный объект 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.15/qcameraexposurecontrol.html