Класс QCameraExposure
Класс QCameraExposure предоставляет интерфейс для настроек камеры, связанных с экспозицией. Подробнее...
| Заголовок: | #include <QCameraExposure> |
| qmake: | QT += multimedia |
| Наследует: | QObject |
Открытые типы
| перечисление | ExposureMode { ExposureAuto, ExposureManual, ExposurePortrait, ExposureNight, ..., ExposureModeVendor } |
| перечисление | FlashMode { FlashAuto, FlashOff, FlashOn, FlashRedEyeReduction, ..., FlashManual } |
| флаги | FlashModes |
| перечисление | MeteringMode { MeteringMatrix, MeteringAverage, MeteringSpot } |
Свойства
|
|
- 1 свойство унаследовано от QObject
Открытые функции
| 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 |
- 34 открытые функции унаследованы от QObject
Открытые слоты
| 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) |
- 1 открытый слот унаследован от QObject
Сигналы
| void | apertureChanged(qreal value) |
| void | apertureRangeChanged() |
| void | exposureCompensationChanged(qreal value) |
| void | flashReady(bool ready) |
| void | isoSensitivityChanged(int value) |
| void | shutterSpeedChanged(qreal speed) |
| void | shutterSpeedRangeChanged() |
- 2 сигнала унаследованы от QObject
Дополнительные унаследованные члены
- 1 открытая переменная унаследована от QObject
- 10 статических открытых членов унаследованы от QObject
- 9 защищенных функций унаследованы от QObject
- 2 защищенных переменных унаследованы от QObject
Подробное описание
Класс 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.
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 поддерживается.
[signal] void QCameraExposure::isoSensitivityChanged(int value)
Сигнал, генерируемый при изменении чувствительности на value.
Примечание: Сигнал уведомления для свойства isoSensitivity.
qreal QCameraExposure::requestedAperture() const
Возвращает запрошенную ручную диафрагму или -1.0, если автоматическая диафрагма включена.
int QCameraExposure::requestedIsoSensitivity() const
Возвращает запрошенную чувствительность ISO или -1, если автоматическая чувствительность ISO включена.
qreal QCameraExposure::requestedShutterSpeed() const
Возвращает запрошенную выдержку затвора в секундах или -1.0, если автоматическая выдержка включена.
[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
void QCameraExposure::setSpotMeteringPoint(const QPointF &point)
Позволяет установить точку точечной экспозиции на point.
См. также spotMeteringPoint().
qreal QCameraExposure::shutterSpeed() const
Возвращает текущую выдержку затвора в секундах.
Примечание: Функция-получатель свойства shutterSpeed.
[signal] void QCameraExposure::shutterSpeedChanged(qreal speed)
Сигнализирует о том, что выдержка затвора камеры speed изменилась.
Примечание: Сигнал-уведомление для свойства shutterSpeed.
[signal] void QCameraExposure::shutterSpeedRangeChanged()
Сигнал, излучаемый при изменении диапазона выдержки затвора.
QPointF QCameraExposure::spotMeteringPoint() const
При поддержке, точка точечной экспозиции — это (нормализованное) положение точки изображения, где будет выполнено измерение экспозиции. Это обычно используется для указания «интересной» области изображения, которая должна быть правильно экспонирована.
Координаты относительны координатам кадра: QPointF(0,0) указывает на верхнюю левую точку кадра, QPointF(0.5,0.5) — на центр кадра, который обычно является значением по умолчанию для точки точечной экспозиции.
Точка точечной экспозиции используется только в режиме точечной экспозиции.
См. также setSpotMeteringPoint().
QList<qreal> QCameraExposure::supportedApertures(bool *continuous = nullptr) const
Возвращает список значений диафрагмы, поддерживаемых камерой. Список диафрагм может изменяться в зависимости от фокусного расстояния, в этом случае излучается сигнал apertureRangeChanged().
Если камера поддерживает произвольные значения диафрагмы в допустимом диапазоне, *continuous устанавливается в значение true, в противном случае *continuous устанавливается в значение false.
QList<int> QCameraExposure::supportedIsoSensitivities(bool *continuous = nullptr) const
Возвращает список поддерживаемых ISO-чувствительностей камеры.
Если камера поддерживает произвольные значения ISO-чувствительности в допустимом диапазоне, *continuous устанавливается в true, в противном случае *continuous устанавливается в false.
QList<qreal> QCameraExposure::supportedShutterSpeeds(bool *continuous = nullptr) const
Возвращает список значений выдержки затвора в секундах, поддерживаемых камерой.
Если камера поддерживает произвольные значения выдержки затвора в допустимом диапазоне, *continuous устанавливается в значение true, в противном случае *continuous устанавливается в значение false.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.11/qcameraexposure.html
