diff options
author | Dmytro Poplavskiy <dmytro.poplavskiy@nokia.com> | 2012-03-12 13:27:42 +1000 |
---|---|---|
committer | Qt by Nokia <qt-info@nokia.com> | 2012-03-12 07:36:06 +0100 |
commit | a15b9d3ce88037c973f868fdf6959eea4e157f68 (patch) | |
tree | ea55ab6234609d50d05eaa1deb74d82c64e6c30d /src/multimedia/camera | |
parent | 2b73f92a7ff0068ebb9453f5fdb09305a2561799 (diff) |
QCamera capture documentation fixes
Added documentation for camera capture queue behavior.
Change-Id: I4989f94c5de0edb3ac99135dcb3e11d76195a880
Reviewed-by: Michael Goddard <michael.goddard@nokia.com>
Diffstat (limited to 'src/multimedia/camera')
-rw-r--r-- | src/multimedia/camera/qcameraimagecapture.cpp | 13 |
1 files changed, 12 insertions, 1 deletions
diff --git a/src/multimedia/camera/qcameraimagecapture.cpp b/src/multimedia/camera/qcameraimagecapture.cpp index 0754963ae..fd516c0e4 100644 --- a/src/multimedia/camera/qcameraimagecapture.cpp +++ b/src/multimedia/camera/qcameraimagecapture.cpp @@ -493,6 +493,12 @@ void QCameraImageCapture::setCaptureDestination(QCameraImageCapture::CaptureDest /*! \property QCameraImageCapture::readyForCapture Indicates the service is ready to capture a an image immediately. + + It's permissible to call capture() while the camera status is QCamera::ActiveStatus + regardless of isReadyForCapture property value. + If camera is not ready to capture image immediately, + the capture request is queued with all the related camera settings + to be executed as soon as possible. */ bool QCameraImageCapture::isReadyForCapture() const @@ -513,7 +519,8 @@ bool QCameraImageCapture::isReadyForCapture() const /*! Capture the image and save it to \a file. This operation is asynchronous in majority of cases, - followed by signals QCameraImageCapture::imageCaptured(), QCameraImageCapture::imageSaved() + followed by signals QCameraImageCapture::imageExposed(), + QCameraImageCapture::imageCaptured(), QCameraImageCapture::imageSaved() or QCameraImageCapture::error(). If an empty \a file is passed, the camera backend choses @@ -521,6 +528,10 @@ bool QCameraImageCapture::isReadyForCapture() const if only file name without full path is specified, the image will be saved to the default directory, with a full path reported with imageCaptured() and imageSaved() signals. + QCamera saves all the capture parameters like exposure settings or + image processing parameters, so changes to camera paramaters after + capture() is called do not affect previous capture requests. + QCameraImageCapture::capture returns the capture Id parameter, used with imageExposed(), imageCaptured() and imageSaved() signals. */ |