Класс QCameraFocus

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

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

Типы публичного доступа

Свойства

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

Публичные функции

• 31 публичная функция унаследована от QObject

Сигналы

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

Статические публичные члены

• 9 статических публичных членов унаследованы от QObject

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

• 1 публичный слот унаследован от 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.

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

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

Тип FocusModes является типом-синонимом для QFlags<FocusMode>. Он хранит результат объединения по «ИЛИ» значений FocusMode.

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

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

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

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

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

[signal] void QCameraFocus::focusZonesChanged()

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

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

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

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 для камер, не поддерживающих цифровой зум.

[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.

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