Класс QVCCameraFocus
Класс QVCCameraFocus предоставляет интерфейс для настроек камеры, связанных с фокусировкой и масштабированием.
| Подключение: | #include <QVCCameraFocus> |
Свойства
- customFocusPoint : QPointF
- digitalZoom : const qreal
- focusMode : QCameraFocus::FocusModes
- focusPointMode : QCameraFocus::FocusPointMode
- focusZones : const QCameraFocusZoneList
- opticalZoom : const qreal
Публичные функции
| QPointF | customFocusPoint() const |
| qreal | digitalZoom() const |
| QCameraFocus::FocusModes | focusMode() const |
| QCameraFocus::FocusPointMode | focusPointMode() const |
| QCameraFocusZoneList | focusZones() const |
| bool | isAvailable() const |
| bool | isFocusModeSupported(QCameraFocus::FocusModes mode) const |
| bool | isFocusPointModeSupported(QCameraFocus::FocusPointMode mode) const |
| qreal | maximumDigitalZoom() const |
| qreal | maximumOpticalZoom() const |
| qreal | opticalZoom() const |
| void | setCustomFocusPoint(const QPointF &point) |
| void | setFocusMode(QCameraFocus::FocusModes mode) |
| void | setFocusPointMode(QCameraFocus::FocusPointMode mode) |
| void | zoomTo(qreal optical, qreal digital) |
Сигналы
| void | digitalZoomChanged(qreal value) |
| void | focusZonesChanged() |
| void | maximumDigitalZoomChanged(qreal zoom) |
| void | maximumOpticalZoomChanged(qreal zoom) |
| void | opticalZoomChanged(qreal value) |
Описание свойств
customFocusPoint : QPointF
Свойство представляет положение пользовательской точки фокусировки в относительных координатах кадра: QPointF(0,0) указывает на левую верхнюю точку кадра, QPointF(0,5,0,5) указывает на центр кадра.
Свойство пользовательской точки фокусировки используется только в режиме фокусировки
FocusPointCustom.
Методы доступа:
| QPointF | customFocusPoint() const |
| void | setCustomFocusPoint(const QPointF &point) |
digitalZoom : const qreal
Свойство содержит текущее значение цифрового масштабирования.
Методы доступа:
| qreal | digitalZoom() const |
Сигнал уведомления:
| void | digitalZoomChanged(qreal value) |
См. также QVCCameraFocus::opticalZoom.
focusMode : QCameraFocus::FocusModes
Свойство содержит текущий режим фокусировки камеры.
Оно контролирует способ настройки узла объектива камеры.
Методы доступа:
| QCameraFocus::FocusModes | focusMode() const |
| void | setFocusMode(QCameraFocus::FocusModes mode) |
См. также QVCCameraFocus::isFocusModeSupported().
focusPointMode : QCameraFocus::FocusPointMode
Свойство содержит текущий режим выбора точки фокусировки камеры.
Если режим фокусировки камеры настроен на использование режима автофокусировки, это свойство управляет тем, как камера будет выбирать области кадра, которые будут использоваться для автофокусировки.
Методы доступа:
| QCameraFocus::FocusPointMode | focusPointMode() const |
| void | setFocusPointMode(QCameraFocus::FocusPointMode mode) |
См. также QVCCameraFocus::isFocusPointModeSupported().
focusZones : const QCameraFocusZoneList
Возвращает список активных зон фокусировки.
Если выбран режим фокусировки QCamera::FocusPointAuto или QCamera::FocusPointFaceDetection, этот метод возвращает список зон, на которых фактически сфокусирована камера.
Система координат такая же, как и для пользовательских точек фокусировки: QPointF(0,0) указывает на левую верхнюю точку кадра, QPointF(0.5,0.5) указывает на центр кадра.
Методы доступа:
| QCameraFocusZoneList | focusZones() const |
Сигнал уведомления:
| void | focusZonesChanged() |
opticalZoom : const qreal
Свойство содержит текущее значение оптического масштабирования.
Методы доступа:
| qreal | opticalZoom() const |
Сигнал уведомления:
| void | opticalZoomChanged(qreal value) |
См. также QVCCameraFocus::digitalZoom.
Описание функций-членов
[signal] void QVCCameraFocus::digitalZoomChanged(qreal value)
Сигнал испускается, когда значение цифрового масштабирования меняется на новое value.
Примечание. Сигнал уведомления для свойства digitalZoom.
[signal] void QVCCameraFocus::focusZonesChanged()
Сигнал испускается при изменении набора зон, используемых при автофокусировке.
Они могут измениться, когда зона сфокусирована или теряет фокус, или когда обнаружены новые зоны фокусировки.
Примечание. Сигнал уведомления для свойства focusZones.
bool QVCCameraFocus::isAvailable() const
Возвращает true, если настройки, связанные с фокусировкой, поддерживаются этой камерой.
Возможно, также потребуется проверить, поддерживаются ли какие-либо конкретные функции.
bool QVCCameraFocus::isFocusModeSupported(QCameraFocus::FocusModes mode) const
Возвращает true, если режим фокусировки mode поддерживается камерой.
bool QVCCameraFocus::isFocusPointModeSupported(QCameraFocus::FocusPointMode mode) const
Возвращает true, если поддерживается режим точки фокусировки mode.
qreal QVCCameraFocus::maximumDigitalZoom() const
Возвращает максимальный цифровой зум.
Он будет 1.0 на камерах, которые не поддерживают цифровой зум.
[signal] void QVCCameraFocus::maximumDigitalZoomChanged(qreal zoom)
Сигнал испускается при изменении максимального поддерживаемого значения цифрового масштабирования zoom.
Максимальное поддерживаемое значение масштабирования может зависеть от других настроек камеры, таких как режим съемки или разрешение.
qreal QVCCameraFocus::maximumOpticalZoom() const
Возвращает максимальный оптический зум.
Он будет 1.0 на камерах, которые не поддерживают оптический зум.
[signal] void QVCCameraFocus::maximumOpticalZoomChanged(qreal zoom)
Сигнал испускается при изменении максимального поддерживаемого значения оптического масштабирования zoom.
[signal] void QVCCameraFocus::opticalZoomChanged(qreal value)
Сигнал испускается, когда значение оптического масштабирования меняется на новое value.
Примечание. Сигнал уведомления для свойства opticalZoom.
void QVCCameraFocus::zoomTo(qreal optical, qreal digital)
Устанавливает значения оптического (optical) и цифрового (digital) масштабирования камеры.
Поскольку может потребоваться перемещение физического компонента, изменение значения масштабирования может не быть мгновенным.