Тип QML CameraCapture

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

• Список всех членов, включая унаследованные

Свойства

• capturedImagePath : строка
• errorString : строка
• ready : логическое
• resolution : размер

Сигналы

• captureFailed(requestId, сообщение)
• imageCaptured(requestId, предпросмотр)
• imageMetadataAvailable(requestId, ключ, значение)
• imageSaved(requestId, путь)

Методы

• cancelCapture()
• capture()
• captureToLocation(местоположение)
• setMetadata(ключ, значение)

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

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

CameraCapture является дочерним элементом Camera (как imageCapture свойство) и не может быть создан напрямую.

Item {
    width: 640
    height: 360

    Camera {
        id: camera

        imageCapture {
            onImageCaptured: {
                // Show the preview in an Image
                photoPreview.source = preview
            }
        }
    }

    VideoOutput {
        source: camera
        focus : visible // to receive focus and capture key events when visible
        anchors.fill: parent

        MouseArea {
            anchors.fill: parent;
            onClicked: camera.imageCapture.capture();
        }
    }

    Image {
        id: photoPreview
    }
}

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

capturedImagePath : строка

Это свойство содержит расположение последнего захваченного изображения.

errorString : строка

Это свойство содержит сообщение об ошибке, связанное с последним захватом.

ready : логическое

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

Вызов capture(), в то время как ready false недопустимо и приводит к ошибке.

resolution : размер

Это свойство содержит разрешение/размер изображения, которое нужно захватить. Если оно пустое, система выбирает соответствующее разрешение.

Документация по сигналам

captureFailed(requestId, сообщение)

Этот сигнал излучается, когда во время захвата с requestId возникает ошибка. Описательное сообщение доступно в сообщении.

Соответствующий обработчик - onCaptureFailed.

imageCaptured(requestId, предпросмотр)

Этот сигнал излучается, когда изображение с requestId было захвачено, но еще не сохранено в файловой системе. Параметр предпросмотр может быть использован в качестве URL, предоставляемого Image.

Соответствующий обработчик - onImageCaptured.

См. также imageSaved.

imageMetadataAvailable(requestId, ключ, значение)

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

Соответствующий обработчик - onImageMetadataAvailable.

См. также imageCaptured.

imageSaved(requestId, путь)

Этот сигнал излучается после того, как изображение с requestId было записано в файловую систему. путь - это локальный путь к файлу, а не URL.

Соответствующий обработчик - onImageSaved.

См. также imageCaptured.

Документация по методам

cancelCapture()

Отмена ожидающих запросов захвата изображений.

capture()

Запуск захвата изображения. Сигналы imageCaptured и imageSaved будут излучены, когда захват будет завершен.

Изображение будет захвачено по умолчанию в системном расположении, обычно QStandardPaths::writableLocation(QStandardPaths::PicturesLocation) для неподвижных изображений или QStandardPaths::writableLocation(QStandardPaths::MoviesLocation) для видео.

Камера сохраняет все параметры захвата, такие как параметры экспозиции или параметры обработки изображений, поэтому изменения параметров камеры после вызова capture() не влияют на предыдущие запросы захвата.

capture() возвращает параметр requestId захвата, используемый с imageExposed(), imageCaptured(), imageMetadataAvailable() и imageSaved() сигналами.

См. также ready.

captureToLocation(местоположение)

Запуск захвата изображения в указанное местоположение. Сигналы imageCaptured и imageSaved будут излучены, когда захват будет завершен.

CameraCapture::captureToLocation возвращает параметр requestId захвата, используемый с imageExposed(), imageCaptured(), imageMetadataAvailable() и imageSaved() сигналами.

Если приложение не может записать в указанное местоположение, CameraCapture излучит ошибку. Наиболее вероятные причины, по которым приложение не может записать в местоположение, заключаются в том, что путь указан неправильно и местоположение не существует, или приложение не имеет прав на запись в это местоположение.

setMetadata(ключ, значение)

Устанавливает определенный ключ метаданных ключ со значением значение для последующих захватов изображений.

См. также QMediaMetaData.