Класс QCameraExposure
Класс QCameraExposure предоставляет интерфейс для параметров экспозиции камеры. Подробнее...
| Заголовок: | #include <QCameraExposure> |
| qmake: | QT += multimedia |
| Наследует: | QObject |
Общедоступные типы
| перечисление | ExposureMode { ExposureAuto, ExposureManual, ExposurePortrait, ExposureNight, ExposureBacklight, …, ExposureModeVendor } |
| перечисление | FlashMode { FlashAuto, FlashOff, FlashOn, FlashRedEyeReduction, FlashFill, …, FlashManual } |
| флаги | FlashModes |
| перечисление | MeteringMode { MeteringMatrix, MeteringAverage, MeteringSpot } |
Свойства
|
|
Общедоступные функции
| qreal | aperture() const |
| qreal | exposureCompensation() const |
| QCameraExposure::ExposureMode | exposureMode() const |
| QCameraExposure::FlashModes | flashMode() const |
| bool | isAvailable() const |
| bool | isExposureModeSupported(QCameraExposure::ExposureMode mode) const |
| bool | isFlashModeSupported(QCameraExposure::FlashModes mode) const |
| bool | isFlashReady() const |
| bool | isMeteringModeSupported(QCameraExposure::MeteringMode mode) const |
| int | isoSensitivity() const |
| QCameraExposure::MeteringMode | meteringMode() const |
| qreal | requestedAperture() const |
| int | requestedIsoSensitivity() const |
| qreal | requestedShutterSpeed() const |
| void | setSpotMeteringPoint(const QPointF &point) |
| qreal | shutterSpeed() const |
| QPointF | spotMeteringPoint() const |
| QList<qreal> | supportedApertures(bool *continuous = nullptr) const |
| QList<int> | supportedIsoSensitivities(bool *continuous = nullptr) const |
| QList<qreal> | supportedShutterSpeeds(bool *continuous = nullptr) const |
Общедоступные слоты
| void | setAutoAperture() |
| void | setAutoIsoSensitivity() |
| void | setAutoShutterSpeed() |
| void | setExposureCompensation(qreal ev) |
| void | setExposureMode(QCameraExposure::ExposureMode mode) |
| void | setFlashMode(QCameraExposure::FlashModes mode) |
| void | setManualAperture(qreal aperture) |
| void | setManualIsoSensitivity(int iso) |
| void | setManualShutterSpeed(qreal seconds) |
| void | setMeteringMode(QCameraExposure::MeteringMode mode) |
Сигналы
| void | apertureChanged(qreal value) |
| void | apertureRangeChanged() |
| void | exposureCompensationChanged(qreal value) |
| void | flashReady(bool ready) |
| void | isoSensitivityChanged(int value) |
| void | shutterSpeedChanged(qreal speed) |
| void | shutterSpeedRangeChanged() |
Защищенные функции
| virtual | ~QCameraExposure() |
Подробное описание
Документация по членам типа
перечисление QCameraExposure::ExposureMode
| Константа | Значение | Описание |
|---|---|---|
QCameraExposure::ExposureAuto |
0 |
Автоматический режим. |
QCameraExposure::ExposureManual |
1 |
Ручной режим. |
QCameraExposure::ExposurePortrait |
2 |
Режим экспозиции портрета. |
QCameraExposure::ExposureNight |
3 |
Ночной режим. |
QCameraExposure::ExposureBacklight |
4 |
Режим экспозиции против света. |
QCameraExposure::ExposureSpotlight |
5 |
Режим экспозиции прожектора. |
QCameraExposure::ExposureSports |
6 |
Режим экспозиции точек. |
QCameraExposure::ExposureSnow |
7 |
Режим экспозиции снега. |
QCameraExposure::ExposureBeach |
8 |
Режим экспозиции пляжа. |
QCameraExposure::ExposureLargeAperture |
9 |
Использование большего диафрагменного отверстия с малой глубиной резкости. |
QCameraExposure::ExposureSmallAperture |
10 |
Использование меньшего диафрагменного отверстия. |
QCameraExposure::ExposureAction |
11 |
Режим действия. С версии 5.5 |
QCameraExposure::ExposureLandscape |
12 |
Режим пейзажа. С версии 5.5 |
QCameraExposure::ExposureNightPortrait |
13 |
Режим ночного портрета. С версии 5.5 |
QCameraExposure::ExposureTheatre |
14 |
Режим театра. С версии 5.5 |
QCameraExposure::ExposureSunset |
15 |
Режим заката. С версии 5.5 |
QCameraExposure::ExposureSteadyPhoto |
16 |
Режим стабильной фотографии. С версии 5.5 |
QCameraExposure::ExposureFireworks |
17 |
Режим фейерверка. С версии 5.5 |
QCameraExposure::ExposureParty |
18 |
Режим вечеринки. С версии 5.5 |
QCameraExposure::ExposureCandlelight |
19 |
Режим свечей. С версии 5.5 |
QCameraExposure::ExposureBarcode |
20 |
Режим штрих-кода. С версии 5.5 |
QCameraExposure::ExposureModeVendor |
1000 |
Базовое значение для режимов экспозиции, специфичных для устройства. |
enum QCameraExposure::FlashModeфлаги QCameraExposure::FlashModes
| Константа | Значение | Описание |
|---|---|---|
QCameraExposure::FlashAuto |
0x1 |
Автоматическая вспышка. |
QCameraExposure::FlashOff |
0x2 |
Вспышка выключена. |
QCameraExposure::FlashOn |
0x4 |
Вспышка включена. |
QCameraExposure::FlashRedEyeReduction |
0x8 |
Вспышка с уменьшением эффекта красных глаз. |
QCameraExposure::FlashFill |
0x10 |
Использование вспышки для заполнения теней. |
QCameraExposure::FlashTorch |
0x20 |
Постоянный источник света. Если поддерживается, фонарик может быть включен без загрузки камеры. |
QCameraExposure::FlashVideoLight |
0x40 |
Постоянный источник света, полезный для записи видео. Свет включается только во время активности камеры. |
QCameraExposure::FlashSlowSyncFrontCurtain |
0x80 |
Использование вспышки в сочетании с медленной выдержкой. Этот режим позволяет лучше экспонировать удаленные объекты и/или эффект размытия движения. |
QCameraExposure::FlashSlowSyncRearCurtain |
0x100 |
Аналогичный режим FlashSlowSyncFrontCurtain, но вспышка срабатывает в конце экспозиции. |
QCameraExposure::FlashManual |
0x200 |
Мощность вспышки устанавливается вручную. |
Тип FlashModes — это псевдоним для QFlags<FlashMode>. Он хранит логическое ИЛИ сочетание значений FlashMode.
enum QCameraExposure::MeteringMode
| Константа | Значение | Описание |
|---|---|---|
QCameraExposure::MeteringMatrix |
1 |
Матричный режим замера экспозиции. |
QCameraExposure::MeteringAverage |
2 |
Режим замера экспозиции с весом центра. |
QCameraExposure::MeteringSpot |
3 |
Точечный режим замера экспозиции. |
Документация свойств
aperture : const qreal
Диафрагма объектива задаётся как число f, отношение фокусного расстояния к эффективному диаметру диафрагмы.
Функции доступа:
| qreal | aperture() const |
Сигнал уведомления:
| void | apertureChanged(qreal value) |
См. также supportedApertures(), setAutoAperture(), setManualAperture(), и requestedAperture().
exposureCompensation : qreal
Компенсация экспозиции в единицах EV.
Свойство компенсации экспозиции позволяет настраивать автоматически вычисляемую экспозицию.
Функции доступа:
| qreal | exposureCompensation() const |
| void | setExposureCompensation(qreal ev) |
Сигнал уведомления:
| void | exposureCompensationChanged(qreal value) |
exposureMode : QCameraExposure::ExposureMode
Это свойство содержит используемый режим экспозиции.
Функции доступа:
| QCameraExposure::ExposureMode | exposureMode() const |
| void | setExposureMode(QCameraExposure::ExposureMode mode) |
См. также QCameraExposure::isExposureModeSupported().
flashMode : QCameraExposure::FlashModes
Это свойство содержит используемый режим вспышки.
Обычно используется один флаг QCameraExposure::FlashMode, но также допускаются некоторые неконфликтующие комбинации флагов, например, QCameraExposure::FlashManual | QCameraExposure::FlashSlowSyncRearCurtain.
Функции доступа:
| QCameraExposure::FlashModes | flashMode() const |
| void | setFlashMode(QCameraExposure::FlashModes mode) |
См. также QCameraExposure::isFlashModeSupported() и QCameraExposure::isFlashReady().
flashReady : const bool
Указывает, заряжена ли вспышка и готова ли к использованию.
Функции доступа:
| bool | isFlashReady() const |
Сигнал уведомления:
| void | flashReady(bool ready) |
isoSensitivity : const int
Это свойство содержит чувствительность сенсора ISO.
Функции доступа:
| int | isoSensitivity() const |
Сигнал уведомления:
| void | isoSensitivityChanged(int value) |
См. также supportedIsoSensitivities(), setAutoIsoSensitivity(), и setManualIsoSensitivity().
meteringMode : QCameraExposure::MeteringMode
Это свойство содержит используемый режим замера экспозиции.
Функции доступа:
| QCameraExposure::MeteringMode | meteringMode() const |
| void | setMeteringMode(QCameraExposure::MeteringMode mode) |
См. также QCameraExposure::isMeteringModeSupported().
shutterSpeed : const qreal
Выдержка камеры в секундах.
Функции доступа:
| qreal | shutterSpeed() const |
Сигнал уведомления:
| void | shutterSpeedChanged(qreal speed) |
См. также supportedShutterSpeeds(), setAutoShutterSpeed(), и setManualShutterSpeed().
Документация по членам-функциям
[signal] void QCameraExposure::apertureChanged(qreal value)
Сигнал, генерируемый при изменении диафрагмы на value.
Примечание: Сигнал уведомления для свойства aperture.
[signal] void QCameraExposure::apertureRangeChanged()
Сигнал, генерируемый при изменении диапазона диафрагмы.
[signal] void QCameraExposure::exposureCompensationChanged(qreal value)
Сигнал, генерируемый при изменении компенсации экспозиции на value.
Примечание: Сигнал уведомления для свойства exposureCompensation.
[signal] void QCameraExposure::flashReady(bool ready)
Сигнал об изменении состояния готовности вспышки ready.
Примечание: Сигнал уведомления для свойства flashReady.
[signal] void QCameraExposure::isoSensitivityChanged(int value)
Сигнал, генерируемый при изменении чувствительности на value.
Примечание: Сигнал уведомления для свойства isoSensitivity.
[slot] void QCameraExposure::setAutoAperture()
Включить автоматическое управление диафрагмой.
[slot] void QCameraExposure::setAutoIsoSensitivity()
Включить автоматическую настройку чувствительности.
[slot] void QCameraExposure::setAutoShutterSpeed()
Включить автоматическое управление выдержкой.
[slot] void QCameraExposure::setManualAperture(qreal aperture)
Устанавливает значение ручной диафрагмы aperture.
[slot] void QCameraExposure::setManualIsoSensitivity(int iso)
Устанавливает ручную чувствительность на iso
[slot] void QCameraExposure::setManualShutterSpeed(qreal seconds)
Устанавливает ручную выдержку на seconds
[signal] void QCameraExposure::shutterSpeedChanged(qreal speed)
Сигнализирует об изменении выдержки камеры на speed.
Примечание: Сигнал уведомления для свойства shutterSpeed.
[signal] void QCameraExposure::shutterSpeedRangeChanged()
Сигнал, генерируемый при изменении диапазона выдержки.
[virtual protected] QCameraExposure::~QCameraExposure()
Уничтожает объект экспозиции камеры.
bool QCameraExposure::isAvailable() const
Возвращает true, если настройки экспозиции поддерживаются данной камерой.
bool QCameraExposure::isExposureModeSupported(QCameraExposure::ExposureMode mode) const
Возвращает true, если режим экспозиции mode поддерживается.
bool QCameraExposure::isFlashModeSupported(QCameraExposure::FlashModes mode) const
Возвращает true, если режим вспышки mode поддерживается.
bool QCameraExposure::isFlashReady() const
Возвращает true, если вспышка заряжена.
Примечание: Функция-геттер для свойства flashReady.
bool QCameraExposure::isMeteringModeSupported(QCameraExposure::MeteringMode mode) const
Возвращает true, если режим замера mode поддерживается.
qreal QCameraExposure::requestedAperture() const
Возвращает запрошенную ручную диафрагму или -1.0, если включена автоматическая диафрагма.
int QCameraExposure::requestedIsoSensitivity() const
Возвращает запрошенную чувствительность ISO или -1, если включена автоматическая чувствительность ISO.
qreal QCameraExposure::requestedShutterSpeed() const
Возвращает запрошенную ручную выдержку в секундах или -1.0, если включена автоматическая выдержка.
void QCameraExposure::setSpotMeteringPoint(const QPointF &point)
Позволяет установить точку замера экспозиции в point.
См. также spotMeteringPoint().
qreal QCameraExposure::shutterSpeed() const
Возвращает текущую выдержку в секундах.
Примечание: Функция-геттер для свойства shutterSpeed.
QPointF QCameraExposure::spotMeteringPoint() const
В случае поддержки, точка замера экспозиции — (нормализованное) положение точки изображения, где будет выполняться измерение экспозиции. Обычно используется для указания «интересующей» области изображения, которая должна быть правильно экспонирована.
Координаты относительны к кадру: QPointF(0,0) указывает на верхний левый угол кадра, QPointF(0.5,0.5) — на центр кадра, который обычно является значением по умолчанию для точки замера экспозиции.
Точка замера экспозиции используется только в режиме точечного замера.
См. также setSpotMeteringPoint().
QList<qreal> QCameraExposure::supportedApertures(bool *continuous = nullptr) const
Возвращает список значений диафрагмы, которые поддерживает камера. Список диафрагм может изменяться в зависимости от фокусного расстояния, в этом случае испускается сигнал apertureRangeChanged().
Если камера поддерживает произвольные значения диафрагмы в допустимом диапазоне, *continuous устанавливается в true, иначе — в false.
QList<int> QCameraExposure::supportedIsoSensitivities(bool *continuous = nullptr) const
Возвращает список значений чувствительности ISO, которые поддерживает камера.
Если камера поддерживает произвольные значения чувствительности ISO в допустимом диапазоне, *continuous устанавливается в true, иначе — в false.
QList<qreal> QCameraExposure::supportedShutterSpeeds(bool *continuous = nullptr) const
Возвращает список значений выдержки в секундах, которые поддерживает камера.
Если камера поддерживает произвольные значения выдержки в допустимом диапазоне, *continuous устанавливается в true, иначе — в false.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qcameraexposure.html
