Класс QCameraExposureControl
Класс QCameraExposureControl позволяет управлять параметрами экспозиции камеры. Подробнее...
| Заголовок: | #include <QCameraExposureControl> |
| qmake: | QT += multimedia |
| Наследуется от: | QMediaControl |
Открытые типы
| перечисление | ExposureParameter { ISO, Aperture, ShutterSpeed, ExposureCompensation, ..., 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. Список поддерживаемых диафрагм может изменяться в зависимости от фокусного расстояния, в таком случае генерируется сигнал 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
Возвращает значение запрошенного параметра экспозиции.
Эта функция была введена в 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, в противном случае в false.
Эта функция была введена в Qt 5.0.
Документация по макросам
QCameraExposureControl::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.13/qcameraexposurecontrol.html