Spec-Zone.ru › Qt 5.14

Тип QML CameraFocus

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

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

Свойства

  • customFocusPoint : точка
  • 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 : точка

Это свойство содержит положение пользовательской точки фокусировки в относительных координатах кадра: 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.14/qml-qtmultimedia-camerafocus.html

Spec-Zone.ru

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