Тип QML CameraFocus
Интерфейс для настроек камеры, связанных с фокусом. Подробнее...
| Заявление об импорте: | import QtMultimedia 5.12 |
Свойства
- 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.12/qml-qtmultimedia-camerafocus.html