Класс QCameraFocus

Класс QCameraFocus предоставляет интерфейс для управления настройками камеры, связанными с фокусировкой и зумом. Подробнее...

• Список всех членов, включая унаследованные

Открытые типы

Свойства

Открытые функции

Сигналы

Подробное описание

На оборудовании, которое это поддерживает, этот класс позволяет изменять фокус или зум (оптический и цифровой). Это также включает в себя такие вещи, как режим «Макро» для работы с близкими объектами (например, для считывания штрих-кодов или распознавания букв) или «наведение на фокусировку» — указание интересной области видоискателя, чтобы оборудование попыталось сфокусироваться на ней.

QCameraFocus *focus = camera->focus();
focus->setFocusPointMode(QCameraFocus::FocusPointCustom);
focus->setCustomFocusPoint(QPointF(0.25f, 0.75f)); // A point near the bottom left, 25% away from the corner, near that shiny vase

Масштабирование можно выполнить несколькими способами — обычно более дорогой, но с лучшим качеством, является оптический зум, который позволяет использовать весь диапазон датчика камеры для сбора пикселей изображения. Кроме того, возможен цифровой зум, который, как правило, просто увеличивает часть кадра датчика и отбрасывает другие части. Если оборудование камеры поддерживает оптический зум, его следует использовать в первую очередь. Метод maximumOpticalZoom() позволяет проверить это. Метод zoomTo() позволяет одновременно изменять оптический и цифровой зум.

focus->zoomTo(3.0, 4.0); // Super zoom!

Некоторые замечания об автофокусе

Некоторое оборудование поддерживает подвижную линзу фокусировки, и, как правило, это оборудование также поддерживает автоматическую фокусировку с помощью некоторого эвристического метода. Вы можете повлиять на это с помощью параметра FocusPointMode — обычно в фокус попадает центр кадра, но некоторые устройства также поддерживают фокусировку на любых лицах, обнаруженных в кадре, или на определенной точке (обычно предоставляемой пользователем в сценарии «касание для фокусировки»).

Этот класс (в сочетании с QCameraFocusZone) может предоставить информацию о том, какие части изображения датчика камеры находятся в фокусе или используются для автоматической фокусировки через свойство focusZones:

focus->setFocusPointMode(QCameraFocus::FocusPointAuto);
QList<QCameraFocusZone> zones = focus->focusZones();
foreach (QCameraFocusZone zone, zones) {
    if (zone.status() == QCameraFocusZone::Focused) {
        // Draw a green box at zone.area()
    } else if (zone.status() == QCameraFocusZone::Selected) {
        // This area is selected for autofocusing, but is not in focus
        // Draw a yellow box at zone.area()
    }
}

См. также QCameraFocusZone.

Документация типов членов

перечисление QCameraFocus::FocusModeфлаги QCameraFocus::FocusModes

Тип FocusModes — это псевдоним для QFlags<FocusMode>. Он хранит логическое ИЛИ сочетание значений FocusMode.

перечисление QCameraFocus::FocusPointMode

Документация по членам-функциям

[signal] void QCameraFocus::digitalZoomChanged(qreal value)

Сигнал, генерируемый при изменении значения цифрового зума на новое значение value.

Примечание: Сигнал уведомления для свойства digitalZoom.

[signal] void QCameraFocus::focusZonesChanged()

Этот сигнал генерируется при изменении набора зон, используемых в автоматической фокусировке.

Это может измениться, когда зона сфокусирована или теряет фокус, или были обнаружены новые зоны фокусировки.

Примечание: Сигнал уведомления для свойства focusZones.

[signal] void QCameraFocus::maximumDigitalZoomChanged(qreal zoom)

Сигнал, генерируемый при изменении максимального поддерживаемого значения цифрового зума zoom.

Максимальное поддерживаемое значение зума может зависеть от других настроек камеры, таких как режим захвата или разрешение.

[signal] void QCameraFocus::maximumOpticalZoomChanged(qreal zoom)

Сигнал, генерируемый при изменении максимального поддерживаемого значения оптического зума zoom.

[signal] void QCameraFocus::opticalZoomChanged(qreal value)

Сигнал, генерируемый при изменении значения оптического зума на новое значение value.

Примечание: Сигнал уведомления для свойства opticalZoom.

bool QCameraFocus::isAvailable() const

Возвращает true, если настройки, связанные с фокусировкой, поддерживаются этой камерой.

Возможно, вам также необходимо проверить, поддерживаются ли определённые функции.

bool QCameraFocus::isFocusModeSupported(QCameraFocus::FocusModes mode) const

Возвращает true, если режим фокусировки mode поддерживается камерой.

bool QCameraFocus::isFocusPointModeSupported(QCameraFocus::FocusPointMode mode) const

Возвращает true, если режим точки фокусировки mode поддерживается.

qreal QCameraFocus::maximumDigitalZoom() const

Возвращает максимальный цифровой зум.

Это будет 1.0 на камерах, которые не поддерживают цифровой зум.

qreal QCameraFocus::maximumOpticalZoom() const

Возвращает максимальный оптический зум.

Это будет 1.0 на камерах, которые не поддерживают оптический зум.

void QCameraFocus::zoomTo(qreal optical, qreal digital)

Устанавливает значения оптического и цифрового зума камеры optical и digital.

Поскольку может быть физический компонент для перемещения, изменение значения зума может не быть мгновенным.