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

imageCaptured(requestId, preview)

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

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

См. также imageSaved.

imageMetadataAvailable(requestId, key, value)

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

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

См. также imageCaptured.

imageSaved(requestId, path)

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

Соответствующий обработчик — 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.