Класс QCameraExposure
Класс QCameraExposure предоставляет интерфейс для параметров экспозиции камеры. Подробнее...
| Заголовок: | #include <QCameraExposure> |
| qmake: | QT += multimedia |
| Наследуется от: | QObject |
Типы
| Перечисление | РежимЭкспозиции { Автоматический, Ручной, Портретный, Ночной, ..., РежимПроизводителя } |
| Перечисление | РежимВспышки { Автоматический, Выключен, Включен, СнижениеКрасныхГлаз, ..., Ручной } |
| Флаги | РежимыВспышки |
| Перечисление | РежимИзмерения { Матричный, Средневзвешенный, Точечный } |
Свойства
|
|
- 1 свойство унаследовано от QObject
Общедоступные функции
| qreal | диафрагма() const |
| qreal | компенсацияЭкспозиции() const |
| РежимЭкспозиции | режимЭкспозиции() const |
| РежимыВспышки | режимВспышки() const |
| bool | доступен() const |
| bool | поддерживаетсяРежимЭкспозиции(РежимЭкспозиции mode) const |
| bool | поддерживаетсяРежимВспышки(РежимыВспышки mode) const |
| bool | вспышкаГотова() const |
| bool | поддерживаетсяРежимИзмерения(РежимИзмерения mode) const |
| int | чувствительностьИзо() const |
| РежимИзмерения | режимИзмерения() const |
| qreal | запрашиваемаяДиафрагма() const |
| int | запрашиваемаяЧувствительностьИзо() const |
| qreal | запрашиваемаяВыдержка() const |
| void | установитьТочкуИзмерения(const QPointF &point) |
| qreal | выдержка() const |
| QPointF | точкаИзмерения() const |
| QList<qreal> | поддерживаемыеДиафрагмы(bool *continuous = Q_NULLPTR) const |
| QList<int> | поддерживаемыеЧувствительностиИзо(bool *continuous = Q_NULLPTR) const |
| QList<qreal> | поддерживаемыеВыдержки(bool *continuous = Q_NULLPTR) const |
- 32 общедоступных функции унаследованы от QObject
Открытые слоты
| void | установитьАвтоматическуюДиафрагму() |
| void | установитьАвтоматическуюЧувствительностьISO() |
| void | установитьАвтоматическуюВыдержку() |
| void | установитьКомпенсациюЭкспозиции(qreal ev) |
| void | установитьРежимЭкспозиции(ExposureMode mode) |
| void | установитьРежимВспышки(FlashModes mode) |
| void | установитьРучнуюДиафрагму(qreal aperture) |
| void | установитьРучнуюЧувствительностьISO(int iso) |
| void | установитьРучнуюВыдержку(qreal seconds) |
| void | установитьРежимЗамера(MeteringMode mode) |
- 1 открытый слот унаследованный от QObject
Сигналы
| void | изменениеДиафрагмы(qreal value) |
| void | изменениеДиапазонаДиафрагмы() |
| void | изменениеКомпенсацииЭкспозиции(qreal value) |
| void | вспышкаГотова(bool ready) |
| void | изменениеЧувствительностиISO(int value) |
| void | изменениеВыдержки(qreal speed) |
| void | изменениеДиапазонаВыдержки() |
- 2 сигнала унаследованных от QObject
Дополнительные унаследованные члены
- 11 статических открытых членов унаследованных от 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 |
Базовое значение для режимов экспозиции, специфичных для устройства. |
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
Это свойство содержит используемый режим экспозиции.
Функции доступа:
| ExposureMode | exposureMode() const |
| void | setExposureMode(ExposureMode mode) |
См. также QCameraExposure::isExposureModeSupported().
flashMode : QCameraExposure::FlashModes
Это свойство содержит используемый режим вспышки.
Обычно используется один флаг QCameraExposure::FlashMode, но также допускаются некоторые комбинации неконфликтных флагов, например, QCameraExposure::FlashManual | QCameraExposure::FlashSlowSyncRearCurtain.
Функции доступа:
| FlashModes | flashMode() const |
| void | setFlashMode(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
Это свойство содержит используемый режим замера.
Функции доступа:
| MeteringMode | meteringMode() const |
| void | setMeteringMode(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(ExposureMode mode) const
Возвращает true, если режим экспозиции mode поддерживается.
bool QCameraExposure::isFlashModeSupported(FlashModes mode) const
Возвращает true, если режим вспышки mode поддерживается.
bool QCameraExposure::isFlashReady() const
Возвращает true, если вспышка заряжена.
Примечание: Функция-член для свойства flashReady.
bool QCameraExposure::isMeteringModeSupported(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, если включена автоматическая выдержка.
END_OF_DOCUMENT_MARKER
[slot] void QCameraExposure::setAutoAperture()
Включить автоматическое диафрагму
[slot] void QCameraExposure::setAutoIsoSensitivity()
Включить автоматическую чувствительность
[slot] void QCameraExposure::setAutoShutterSpeed()
Включить автоматическую выдержку
[slot] void QCameraExposure::setManualAperture(qreal 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 = Q_NULLPTR) const
Возвращает список значений диафрагмы, поддерживаемых камерой. Список диафрагм может изменяться в зависимости от фокусного расстояния, в этом случае излучается сигнал apertureRangeChanged().
Если камера поддерживает произвольные значения диафрагмы в пределах поддерживаемого диапазона, *continuous устанавливается в true, в противном случае *continuous устанавливается в false.
QList<int> QCameraExposure::supportedIsoSensitivities(bool *continuous = Q_NULLPTR) const
Возвращает список поддерживаемых значений ISO чувствительности камеры.
Если камера поддерживает произвольные значения ISO чувствительности в пределах поддерживаемого диапазона, *continuous устанавливается в true, в противном случае *continuous устанавливается в false.
QList<qreal> QCameraExposure::supportedShutterSpeeds(bool *continuous = Q_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.9/qcameraexposure.html