ImageCapture QML 类型

用于捕获相机图像的接口。更多...

导入声明	import QtMultimedia

所有成员列表，包括继承的成员

属性

preview : string
readyForCapture : bool

信号

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

方法

capture()
captureToFile(location)
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
    }
}

属性文档

preview : string [read-only]

此属性包含指向最新捕获图像的 URL。它可以用作 Image 元素的源属性，以显示最后捕获的图像。

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

另请参阅 saveToFile.

readyForCapture : bool [read-only]

此属性包含一个布尔值，指示相机是否准备就绪以捕获照片。

当 ready 为 false 时，不允许调用 capture() 或 captureToFile()，这将导致错误。

信号文档

errorOccurred(id, error, errorString)

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

注意： 相应的处理程序为 onErrorOccurred.

imageCaptured(requestId, preview)

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

注意： 相应的处理程序为 onImageCaptured.

另请参阅 imageSaved 和 preview.

imageMetadataAvailable(id, metaData)

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

注意：相应的处理程序是 onImageMetadataAvailable。

另请参阅：imageCaptured。

imageSaved(id, fileName)

在请求的 id 的图像被写入文件系统之后，会发出此信号。参数 fileName 是本地文件路径，而不是 URL。

注意：相应的处理程序是 onImageSaved。

另请参阅：imageCaptured。

方法文档

capture()

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

捕获的图像将通过可以用于 QML Image 项源的预览属性可用。然后可以使用 saveToFile() 方法保存图像。

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

capture() 返回 capture requestId 参数，与 imageExposed()，imageCaptured()，imageMetadataAvailable() 和 imageSaved() 信号一起使用。

另请参阅：readyForCapture 和 preview。

captureToFile(location)

与 capture() 的功能相同，但另外还会自动将捕获的图像保存到指定的 location。

另请参阅：capture。

saveToFile(location)

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

另请参阅：capture 和 preview。