Класс QCameraExposureControl
Класс QCameraExposureControl позволяет управлять параметрами экспозиции камеры. Подробнее...
| Заголовок: | #include <QCameraExposureControl> |
| qmake: | QT += multimedia |
| Наследует: | QMediaControl |
Типы public
| перечисление | ExposureParameter { ISO, Aperture, ShutterSpeed, ExposureCompensation, ..., ExtendedExposureParameter } |
Функции public
| virtual | ~QCameraExposureControl() |
| virtual QVariant | actualValue(QCameraExposureControl::ExposureParameter parameter) const = 0 |
| virtual bool | isParameterSupported(QCameraExposureControl::ExposureParameter parameter) const = 0 |
| virtual QVariant | requestedValue(QCameraExposureControl::ExposureParameter parameter) const = 0 |
| virtual bool | setValue(QCameraExposureControl::ExposureParameter parameter, const QVariant &value) = 0 |
| virtual QVariantList | supportedParameterRange(QCameraExposureControl::ExposureParameter parameter, bool *continuous) const = 0 |
- 31 функция public, унаследованная от QObject
Сигналы
| void | actualValueChanged(int parameter) |
| void | parameterRangeChanged(int parameter) |
| void | requestedValueChanged(int parameter) |
- 2 сигнала, унаследованные от QObject
Статические public члены
| const QMetaObject | staticMetaObject |
- 9 статических public членов, унаследованных от QObject
Защищенные функции
| QCameraExposureControl(QObject *parent = nullptr) |
- 9 защищенных функций, унаследованных от QObject
Макросы
| QCameraExposureControl_iid |
Дополнительные унаследованные члены
Подробное описание
Класс QCameraExposureControl позволяет управлять параметрами экспозиции камеры.
Класс 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 (qreal). Список поддерживаемых диафрагм может меняться в зависимости от фокусного расстояния, в этом случае излучается сигнал 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.
[virtual] QCameraExposureControl::~QCameraExposureControl()
Уничтожает объект управления экспозицией камеры.
[pure virtual] QVariant QCameraExposureControl::actualValue(QCameraExposureControl::ExposureParameter parameter) const
Возвращает фактическое значение параметра parameter экспозиции или недействительное QVariant() если значение неизвестно или не поддерживается.
Фактическое значение параметра может отличаться от запрошенного, если выбран автоматический режим или камера поддерживает только ограниченный набор значений в поддерживаемом диапазоне.
Функция была добавлена в Qt 5.0.
[signal] void QCameraExposureControl::actualValueChanged(int parameter)
Сигнал, излучаемый при изменении фактического значения параметра parameter экспозиции, обычно в результате работы алгоритмов автоматической экспозиции или примененного ручного параметра экспозиции.
Функция была добавлена в Qt 5.0.
[pure virtual] bool QCameraExposureControl::isParameterSupported(QCameraExposureControl::ExposureParameter parameter) const
Возвращает true, если параметр экспозиции parameter поддерживается бэкендом.
Эта функция была добавлена в Qt 5.0.
[signal] void QCameraExposureControl::parameterRangeChanged(int parameter)
Сигнал, который генерируется, когда поддерживаемый диапазон значений параметра экспозиции parameter изменился.
Эта функция была добавлена в Qt 5.0.
[pure virtual] QVariant QCameraExposureControl::requestedValue(QCameraExposureControl::ExposureParameter parameter) const
Возвращает запрошенное значение параметра экспозиции parameter.
Эта функция была добавлена в Qt 5.0.
[signal] void QCameraExposureControl::requestedValueChanged(int parameter)
Сигнал, который генерируется, когда запрошенное значение параметра экспозиции parameter изменилось, обычно в результате вызова setValue().
Эта функция была добавлена в Qt 5.0.
[pure virtual] bool QCameraExposureControl::setValue(QCameraExposureControl::ExposureParameter parameter, const QVariant &value)
Устанавливает значение параметра экспозиции parameter равным value. Если передается значение QVariant null или некорректное значение, бэкенд должен автоматически выбрать значение и, если возможно, сообщить пользователю фактическое значение с помощью 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.12/qcameraexposurecontrol.html