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