Тип QML CameraCapture

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

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

Свойства

• capturedImagePath : строка
• errorString : строка
• ready : логическое значение
• resolution : размер
• supportedResolutions : список<размер>

Сигналы

• captureFailed(requestId, message)
• imageCaptured(requestId, preview)
• imageMetadataAvailable(requestId, key, value)
• imageSaved(requestId, path)

Методы

• cancelCapture()
• capture()
• captureToLocation(location)
• setMetadata(key, value)

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

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

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 : размер

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

См. также supportedResolutions.

supportedResolutions : список<размер>

Это свойство содержит список разрешений, поддерживаемых для захвата. Информация может быть использована для установки допустимого значения resolution. Если камера не загружена, список будет пустым.

Это свойство было введено в Qt 5.9.

См. также resolution.

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

captureFailed(requestId, message)

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

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

Примечание: Соответствующий обработчик — onCaptureFailed.

imageCaptured(requestId, preview)

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

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

Примечание: Соответствующий обработчик — onImageCaptured.

См. также imageSaved.

imageMetadataAvailable(requestId, key, value)

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

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

Примечание: Соответствующий обработчик — onImageMetadataAvailable.

См. также imageCaptured.

imageSaved(requestId, path)

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

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

Примечание: Соответствующий обработчик — onImageSaved.

См. также imageCaptured.

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

cancelCapture()

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

capture()

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

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

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

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

См. также ready.

captureToLocation(location)

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

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

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

setMetadata(key, value)

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

См. также QMediaMetaData.