Класс 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 |
- 34 открытых функций унаследовано от QObject
Сигналы
| void | actualValueChanged(int parameter) |
| void | parameterRangeChanged(int parameter) |
| void | requestedValueChanged(int parameter) |
- 2 сигнала унаследовано от QObject
Защищенные функции
| QCameraExposureControl(QObject *parent = nullptr) |
- 9 защищенных функций унаследовано от QObject
Макросы
| QCameraExposureControl_iid |
Дополнительные унаследованные члены
- 1 свойство унаследовано от QObject
- 1 открытый слот унаследован от QObject
- 1 открытая переменная унаследована от QObject
- 10 статических открытых членов унаследовано от QObject
- 2 защищенные переменные унаследованы от 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 = 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, бэкэнд должен автоматически выбрать значение и, если возможно, сообщить фактическое значение пользователю с помощью 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/archives/qt-5.11/qcameraexposurecontrol.html