用于捕获摄像头图像的接口。 更多...
导入语句: | import QtMultimedia |
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 } }
preview : string |
This property holds a url to the latest captured image. It can be connected to the source property of an 图像 element to show the last captured image.
CaptureSession { camera: Camera {} imageCapture: ImageCapture { id: capture } } Image { source: capture.preview }
另请参阅 saveToFile .
readyForCapture : bool |
This property holds a bool value indicating whether the camera is ready to capture photos or not.
调用
capture()
or
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() and imageSaved() signals.
另请参阅 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 .