ImageCapture QML 类型

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

import 语句：

import QtMultimedia

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

特性

preview : string
readyForCapture : bool

信号

errorOccurred ( requestId , error , message )
imageCaptured ( requestId , previewImage )
imageMetadataAvailable ( requestId , key , value )
imageSaved ( requestId , path )

方法

capture ()
captureToFile ( location )
saveToFile ( location )

详细描述

This type allows you to capture still images and be notified when they are available or saved to disk.

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
    }
}

特性文档编制

[read-only] preview : string

This property holds a url to the latest captured image. It can be connected to the source property of an Image element to show the last captured image.

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

另请参阅 saveToFile .

[read-only] readyForCapture : bool

This property holds a bool value indicating whether the camera is ready to capture photos or not.

调用 capture () 或 captureToFile () while ready is false is not permitted and results in an error.

信号文档编制

errorOccurred ( requestId , error , message )

This signal is emitted when an error occurs during capture with requestId . error is an enumeration of type ImageCapture::Error. A descriptive message is available in message .

注意： 相应处理程序是 onErrorOccurred .

imageCaptured ( requestId , previewImage )

This signal is emitted when an image with requestId has been captured but not yet saved to the filesystem. The previewImage parameter is the captured image.

注意： 相应处理程序是 onImageCaptured .

另请参阅 imageSaved and preview .

imageMetadataAvailable ( requestId , key , value )

This signal is emitted when the image with requestId has new metadata available with the key key and value value .

注意： 相应处理程序是 onImageMetadataAvailable .

另请参阅 imageCaptured .

imageSaved ( requestId , path )

This signal is emitted after the image with requestId has been written to the filesystem. The path is a local file path, not a URL.

注意： 相应处理程序是 onImageSaved .

另请参阅 imageCaptured .

方法文档编制

capture ()

开始图像捕获。 imageCaptured and imageSaved signals will be emitted when the capture is complete.

The captured image will be available through the preview property that can be used as the source for a QML Image item. The saveToFile () method can then be used save the image.

Camera saves all the capture parameters like exposure settings or image processing parameters, so changes to camera parameters after capture() is called do not affect previous capture requests.

capture() returns the capture requestId parameter, used with imageExposed(), imageCaptured (), imageMetadataAvailable () 和 imageSaved () 信号。

另请参阅 readyForCapture and preview .

captureToFile ( location )

Does the same as capture () but additionally automatically saves the captured image to the specified location .

另请参阅 capture .

saveToFile ( location )

Saves the last captured image to location .

另请参阅 capture and preview .