ImageCapture QML Type

用于捕获摄像头图像的接口。更多...

• 所有成员（包括继承的成员）的列表

属性

• error : enumeration
• errorString : string
• fileFormat : enumeration
• metaData : mediaMetaData
• preview : string
• quality : enumeration
• readyForCapture : bool
• supportedFormats : list<FileFormat> (since 6.10)

信号

• errorOccurred(id, error, errorString)
• imageCaptured(requestId, preview)
• imageMetadataAvailable(id, metaData)
• imageSaved(id, fileName)

方法

• int capture()
• int captureToFile(location)
• void saveToFile(location)

详细说明

此类允许您捕获静止图像，并在图像可用或保存到磁盘时收到通知。

Item {
    width: 640
    height: 360

    CaptureSession {
        imageCapture : ImageCapture {
            id: imageCapture
        }
        camera: Camera {
            id: camera
        }

        videoOutput: videoOutput
    }
    VideoOutput {
        id: videoOutput
        anchors.fill: parent

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

    Image {
        id: photoPreview
        source: imageCapture.preview // always shows the last captured image
    }
}

属性文档

error : enumeration [read-only]

该属性存储了上次发生的错误类型。它可以是以下类型之一。

另请参阅 errorString 。

errorString : string [read-only]

该属性保存了最近出现的错误消息。

另请参阅 error 。

fileFormat : enumeration

该属性指定了图像将以何种文件格式写入。其值可以是以下选项之一。

metaData : mediaMetaData

该属性包含将嵌入到图像中的元数据。

preview : string [read-only]

该属性保存了最新捕获图像的 URL。它可与 `Image ` 元素的 `source` 属性关联，以显示最后捕获的图像。

CaptureSession {
    camera: Camera {}
    imageCapture: ImageCapture {
        id: capture
    }
}
Image {
    source: capture.preview
}

另请参阅 saveToFile 。

quality : enumeration

该属性在存储捕获的图像时保留画质提示。其值可以是以下选项之一。

readyForCapture : bool [read-only]

该属性保存一个布尔值，用于指示相机是否已准备好拍摄照片。

当相机处于就绪状态时，若调用capture()或captureToFile()，且false 为false，则该操作不被允许，并将引发错误。

supportedFormats : list<FileFormat> [read-only, since 6.10]

包含支持的文件格式列表。

该属性自 Qt 6.10 起引入。

另请参阅 fileFormat 。

信号文档

errorOccurred(id, error, errorString)

当使用请求的id 进行捕获时发生错误，将发出此信号。error 是ImageCapture::Error类型的枚举。描述性消息可在errorString 中获取。

另请参阅 error 和errorString 。

imageCaptured(requestId, preview)

当已捕获请求 ID 为requestId 的图像但尚未将其保存到文件系统时，会触发此信号。preview 参数即为该捕获的图像。

另请参阅 imageSaved 和preview 。

imageMetadataAvailable(id, metaData)

当请求的id 对应的图像有新的metaData 时，会发出此信号。

另请参阅 imageCaptured 。

imageSaved(id, fileName)

当请求的id 对应的图像已写入文件系统后，将触发此信号。fileName 是一个本地文件路径，而非 URL。

另请参阅 imageCaptured 。

方法文档

int capture()

开始捕获图像。当捕获完成时，将触发imageCaptured 和imageSaved 信号。

捕获的图像可通过 preview 属性获取，该属性可作为 QML Image 项的来源。随后可使用saveToFile() 方法保存图像。

相机会保存所有捕获参数（如曝光设置或图像处理参数），因此调用 `capture()` 之后对相机参数所做的更改不会影响之前的捕获请求。

capture() 返回捕获请求 ID 参数，该参数用于配合 imageExposed()、imageCaptured()、imageMetadataAvailable() 和imageSaved() 信号使用。

另请参阅 readyForCapture 和preview 。

int captureToFile(location)

其功能与capture() 相同，但会额外将捕获的图像自动保存到指定的location 。返回捕获请求 ID（requestId）参数。

另请参阅 capture()。

void saveToFile(location)

将最后捕获的图像保存到location 。

另请参阅 capture 和preview 。