Тип 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