Класс QCameraExposure
Класс QCameraExposure предоставляет интерфейс для настроек камеры, связанных с экспозицией. Подробнее...
| Заголовок: | #include <QCameraExposure> |
| qmake: | QT += multimedia |
| Наследует: | 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 |
Открытые слоты
| 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) |
Сигналы
| void | диафрагмаИзменилась(qreal value) |
| void | диапазонДиафрагмыИзменился() |
| void | компенсацияЭкспозицииИзменилась(qreal value) |
| void | вспышкаГотова(bool ready) |
| void | чувствительностьISOИзменилась(int value) |
| void | выдержкаИзменилась(qreal speed) |
| void | диапазонВыдержкиИзменился() |
Подробное описание
Документация по типам членов
enum QCameraExposure::РежимЭкспозиции
| Константа | Значение | Описание |
|---|---|---|
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()
Сигнал, генерируемый при изменении диапазона выдержки.
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.13/qcameraexposure.html
