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