Тип 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 : список<размер>

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

Это свойство было добавлено в 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() возвращает параметр capture requestId, используемый с imageExposed(), imageCaptured(), imageMetadataAvailable() и imageSaved() сигналами.

См. также ready.

captureToLocation(location)

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

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

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

setMetadata(key, value)

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

См. также QMediaMetaData.