QML类型说明-CameraCapture

CameraCapture

ImportStatement:   import QtMultimedia 5.0

 

Properties

capturedImagePath: string

errorString: string

ready : bool

resolution :size

 

Signals

captureFailed(requestId,message)

imageCaptured(requestId,preview)

imageMetadataAvailable(requestId,key, value)

imageSaved(requestId,path)

 

Methods

cancelCapture()

capture()

captureToLocation(location)

setMetadata(key,value)

 

DetailedDescription

这个组件允许我们捕捉图片，当图片准备好时给出通知或保存图片到磁盘。我们可以调节捕捉图片的分辨率和设置图片的保存位置。这个组件是Camera的子模块，不能在QML中直接创建。

 

importQtQuick 2.0

importQtMultimedia 5.0

 

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 andcapture key events when visible

        anchors.fill: parent

 

        MouseArea {

            anchors.fill: parent;

            onClicked:camera.imageCapture.capture();

        }

    }

 

    Image {

        id: photoPreview

    }

}

 

PropertyDocumentation

capturedImagePath: string

最后捕捉的图片的位置。

 

errorString: string

最后捕捉的错误信息，如果有错误的化。

 

ready : bool

相机是否准备好捕捉。当相机处于准备好的状态，就能调用capture()去捕捉图片。如果相机没有准备好，请求和相关联的所有设置就会被放入队列，等待尽可能快地被执行。

 

resolution :size

这个属性保存捕捉图片的分辨率/尺寸。如果为空，那么系统选择适当的分辨率。

 

SignalDocumentation

captureFailed(requestId,message)

当具有requestId这个ID号的捕捉请求出现错误时，发送这个信号。错误的详细信息保存在message中。

 

imageCaptured(requestId,preview)

当具有requestId这个ID号的请求捕捉了图片，又没有保存到磁盘时，这个信号被发射。preview是可以利用的图片的URL。

 

imageMetadataAvailable(requestId,key, value)

当requestId的请求有新的metadata可利用时，这个信号被发射。key和value为metadata的key和value。

 

imageSaved(requestId,path)

当requestId捕捉的图片被写入磁盘时，这个信号被发射。path是文件的路径，不是URL。

 

MethodDocumentation

cancelCapture()

取消图片捕捉请求。

 

capture()

开始图片捕捉。当捕捉完成，imageCaptured和imageSaved将会按各自的条件发射。

捕获的图片通常在默认的系统位置：

QStandardPaths::writableLocation(QStandardPaths::PicturesLocation)用于保存图片。

QStandardPaths::writableLocation(QStandardPaths::MoviesLocation)用于保存视频。

相机会保存所有捕捉参数（如曝光设置或图像处理参数），所以在capture()调用之后改变相机参数，不会影响之前的捕捉请求。

CameraCapture::capture返回requestId参数，用于imageExposed()、imageCaptured()、imageMetadataAvailable()和imageSaved()信号。

 

captureToLocation(location)

捕捉图片到指定位置。当捕捉完成，imageCaptured和imageSaved信号将根据条件发射。CameraCapture::captureToLocation返回requestId参数，用于和imageExposed()、imageCaptured()、imageMetadataAvailable()和imageSaved()信号匹配。如果应用不能写数据到指定位置，则发射错误信号。可能的原因为要写的目标路径是错误的，location不存在或没有写权限。

 

setMetadata(key,value)

为随后的捕捉设置一个特定的metadata，将key设置到value。同时参阅QMediaMetaData.