Класс QCameraFocus

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

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

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

Свойства

• 1 свойство унаследовано от QObject

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

• 31 открытая функция унаследована от QObject

Сигналы

• 2 сигнала унаследованы от QObject

Дополнительные унаследованные члены

• 1 открытый слот унаследован от QObject
• 11 статических открытых членов унаследованы от QObject
• 9 защищенных функций унаследованы от QObject

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

Класс 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.

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

enum QCameraFocus::FocusModeflags QCameraFocus::FocusModes

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

enum QCameraFocus::FocusPointMode

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

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

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

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

[signal] void QCameraFocus::focusZonesChanged()

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

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

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

bool QCameraFocus::isAvailable() const

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

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

bool QCameraFocus::isFocusModeSupported(FocusModes mode) const

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

bool QCameraFocus::isFocusPointModeSupported(FocusPointMode mode) const

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

qreal QCameraFocus::maximumDigitalZoom() const

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

Будет 1.0 для камер, которые не поддерживают цифровой зум.

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

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

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

qreal QCameraFocus::maximumOpticalZoom() const

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

Будет 1.0 для камер, которые не поддерживают оптический зум.

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

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

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

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

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

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

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

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