Класс QCameraExposure
Класс QCameraExposure предоставляет интерфейс для настройки параметров экспозиции камеры. Подробнее...
| Заголовок: | #include <QCameraExposure> |
| qmake: | QT += multimedia |
| Наследует: | QObject |
Открытые типы
| перечисление | РежимЭкспозиции { Автоматический, Ручной, Портрет, Ночь, ..., Производитель } |
| перечисление | РежимВспышки { Автоматический, Выкл, Вкл, СнижениеКрасныхГлаз, ..., Ручной } |
| флаги | РежимыВспышки |
| перечисление | РежимИзмерения { Матричный, Средневзвешенный, Точечный } |
Свойства
|
|
- 1 свойство унаследовано от QObject
Открытые функции
| qreal | диафрагма() const |
| qreal | компенсацияЭкспозиции() const |
| QCameraExposure::РежимЭкспозиции | режимЭкспозиции() const |
| QCameraExposure::РежимыВспышки | режимВспышки() const |
| bool | доступен() const |
| bool | поддерживаетсяРежимЭкспозиции(QCameraExposure::РежимЭкспозиции mode) const |
| bool | поддерживаетсяРежимВспышки(QCameraExposure::РежимыВспышки mode) const |
| bool | вспышкаГотова() const |
| bool | поддерживаетсяРежимИзмерения(QCameraExposure::РежимИзмерения mode) const |
| int | чувствительностьISO() const |
| QCameraExposure::РежимИзмерения | режимИзмерения() const |
| qreal | запрошеннаяДиафрагма() const |
| int | запрошеннаяЧувствительностьISO() const |
| qreal | запрошеннаяВыдержка() const |
| void | установитьТочкуИзмерения(const QPointF &point) |
| qreal | выдержка() const |
| QPointF | точкаИзмерения() const |
| QList<qreal> | поддерживаемыеДиафрагмы(bool *continuous = nullptr) const |
| QList<int> | поддерживаемыеЧувствительностиISO(bool *continuous = nullptr) const |
| QList<qreal> | поддерживаемыеВыдержки(bool *continuous = nullptr) const |
- 31 открытая функция унаследована от QObject
Открытые слоты
| void | автоматическаяДиафрагма() |
| void | автоматическаяЧувствительностьISO() |
| void | автоматическаяВыдержка() |
| void | установитьКомпенсациюЭкспозиции(qreal ev) |
| void | установитьРежимЭкспозиции(QCameraExposure::РежимЭкспозиции mode) |
| void | установитьРежимВспышки(QCameraExposure::РежимыВспышки mode) |
| void | установитьРучнуюДиафрагму(qreal aperture) |
| void | установитьРучнуюЧувствительностьISO(int iso) |
| void | установитьРучнуюВыдержку(qreal seconds) |
| void | установитьРежимИзмерения(QCameraExposure::РежимИзмерения mode) |
- 1 открытый слот унаследован от QObject
Сигналы
| void | измененаДиафрагма(qreal value) |
| void | изменёнДиапазонДиафрагмы() |
| void | измененаКомпенсацияЭкспозиции(qreal value) |
| void | вспышкаГотова(bool ready) |
| void | измененаЧувствительностьISO(int value) |
| void | измененаВыдержка(qreal speed) |
| void | изменёнДиапазонВыдержки() |
- 2 сигнала унаследованы от QObject
Статические открытые члены
| const QMetaObject | staticMetaObject |
- 9 статических открытых членов унаследованы от QObject
Дополнительные унаследованные члены
- 9 защищённых функций унаследованы от 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 |
Базовое значение для режимов экспозиции, специфичных для устройства. |
перечисление 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.
перечисление 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/qt-5.12/qcameraexposure.html