Spec-Zone.ru › Qt 5.15

Тип QML CameraFocus

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

Описание импорта: import QtMultimedia 5.15
  • Список всех членов, включая унаследованные

Свойства

  • customFocusPoint : point
  • focusMode : перечисление
  • focusPointMode : перечисление
  • focusZones : список<focusZone>
  • supportedFocusModes : список<FocusMode>
  • supportedFocusPointModes : список<перечисление>

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

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

Его не следует создавать отдельно, вместо этого следует использовать свойство focus объекта Camera.

Item {
    width: 640
    height: 360

    Camera {
        id: camera

        focus {
            focusMode: Camera.FocusMacro
            focusPointMode: Camera.FocusPointCustom
            customFocusPoint: Qt.point(0.2, 0.2) // Focus relative to top-left corner
        }
    }

    VideoOutput {
        source: camera
        anchors.fill: parent
    }
}

Документация по свойствам

customFocusPoint : point

Это свойство содержит позицию пользовательской точки фокусировки в относительных координатах кадра: QPointF(0,0) указывает на верхнюю левую точку кадра, QPointF(0.5,0.5) — на центр кадра.

Пользовательская точка фокусировки используется только в режиме фокусировки FocusPointCustom.

focusMode : перечисление

Это свойство содержит текущий режим фокусировки камеры, который может иметь одно из следующих значений:

Значение Описание
FocusManual Ручной или фиксированный режим фокусировки.
FocusHyperfocal Фокусировка на гиперфокальное расстояние, с достижением максимальной глубины резкости. Все объекты на расстояниях от половины этого расстояния до бесконечности будут приемлемо резкими.
FocusInfinity Фокусировка строго на бесконечность.
FocusAuto Режим автофокусировки единичного срабатывания.
FocusContinuous Режим непрерывной автофокусировки.
FocusMacro Единичный автофокус на объекты, близкие к камере.

Можно комбинировать несколько значений Camera::FocusMode, например Camera.FocusMacro + Camera.FocusContinuous.

В режимах автоматической фокусировки свойство focusPointMode и свойство focusZones предоставляют информацию и управление тем, как выполняется автоматическая фокусировка.

focusPointMode : перечисление

Это свойство содержит текущий режим точки фокусировки камеры. Он используется в режимах автоматической фокусировки, чтобы определить, на чём сосредоточиться. Если текущий режим точки фокусировки равен Camera.FocusPointCustom, свойство customFocusPoint позволяет указать, на какую часть кадра нужно сфокусироваться.

Свойство может принимать одно из следующих значений:

Значение Описание
FocusPointAuto Автоматически выбрать одну или несколько точек фокусировки.
FocusPointCenter Фокусировка на центр кадра.
FocusPointFaceDetection Фокусировка на лицах в кадре.
FocusPointCustom Фокусировка на пользовательской точке, определённой свойством customFocusPoint.

focusZones : список<focusZone>

Это свойство содержит список текущих зон фокусировки камеры, каждая из которых включает area указанные в тех же координатах, что и customFocusPoint, и зона status как одно из следующих значений:

Значение Описание
Camera.FocusAreaUnused Эта область точки фокусировки в настоящее время не используется при автофокусировке.
Camera.FocusAreaSelected Эта область точки фокусировки используется при автофокусировке, но не сфокусирована.
Camera.FocusAreaFocused Эта точка фокусировки используется при автофокусировке и сфокусирована.
VideoOutput {
    id: viewfinder
    source: camera

    //display focus areas on camera viewfinder:
    Repeater {
          model: camera.focus.focusZones

          Rectangle {
              border {
                  width: 2
                  color: status == Camera.FocusAreaFocused ? "green" : "white"
              }
              color: "transparent"

              // Map from the relative, normalized frame coordinates
              property variant mappedRect: viewfinder.mapNormalizedRectToItem(area);

              x: mappedRect.x
              y: mappedRect.y
              width: mappedRect.width
              height: mappedRect.height
          }
    }
}

supportedFocusModes : список<FocusMode>

Это свойство содержит поддерживаемые режимы фокусировки камеры.

Это свойство было добавлено в Qt 5.11.

См. также focusMode.

supportedFocusPointModes : список<перечисление>

Это свойство содержит поддерживаемые режимы точек фокусировки камеры.

Это свойство было добавлено в Qt 5.10.

См. также focusPointMode.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qml-qtmultimedia-camerafocus.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API