QCameraImageCapture Class Reference
The QCameraImageCapture class is used for the recording of media content. More...
#include <QCameraImageCapture>
This class is under development and is subject to change.
Inherits QMediaBindableInterface.
Public Types
enum | DriveMode { SingleImageCapture } |
enum | Error { NoError, NotReadyError, ResourceError, NotSupportedFeatureError, FormatError, OutOfSpaceError } |
Properties
Public Functions
Reimplemented Public Functions
Public Slots
Signals
Reimplemented Protected Functions
Detailed Description
The QCameraImageCapture class is used for the recording of media content.
The QCameraImageCapture class is a high level images recording class. It's not intended to be used alone but for accessing the media recording functions of other media objects, like QCamera.
camera = new QCamera;
viewFinder = new QCameraViewfinder;
camera->setViewfinder(viewFinder);
viewFinder->show();
imageCapture = new QCameraImageCapture(camera);
camera->setCaptureMode(QCamera::CaptureStillImage);
camera->start();
camera->searchAndLock();
imageCapture->capture();
camera->unlock();
See also QCamera.
Member Type Documentation
enum QCameraImageCapture::DriveMode
enum QCameraImageCapture::Error
|
Constant | Value | Description |
QCameraImageCapture::NoError | 0 | No Errors. |
QCameraImageCapture::NotReadyError | 1 | The service is not ready for capture yet. |
QCameraImageCapture::ResourceError | 2 | Device is not ready or not available. |
QCameraImageCapture::NotSupportedFeatureError | 4 | Device does not support stillimages capture. |
QCameraImageCapture::FormatError | 5 | Current format is not supported. |
QCameraImageCapture::OutOfSpaceError | 3 | No space left on device. |
Property Documentation
readyForCapture : const bool
Indicates the service is ready to capture a an image immediately.
Access functions:
bool | isReadyForCapture () const |
Notifier signal:
Member Function Documentation
QCameraImageCapture::QCameraImageCapture ( QMediaObject * mediaObject, QObject * parent = 0 )
Constructs a media recorder which records the media produced by mediaObject.
The parent is passed to QMediaObject.
QCameraImageCapture::~QCameraImageCapture ()
Destroys images capture object.
QtMultimediaKit::AvailabilityError QCameraImageCapture::availabilityError () const
Returns the availability error code.
void QCameraImageCapture::cancelCapture () [slot]
Cancel incomplete capture requests. Already captured and queused for proicessing images may be discarded.
int QCameraImageCapture::capture ( const QString & file = QString() ) [slot]
Capture the image and save it to file. This operation is asynchronous in majority of cases, followed by signals QCameraImageCapture::imageCaptured(), QCameraImageCapture::imageSaved() or QCameraImageCapture::error().
If an empty file is passed, the camera backend choses the default location and naming scheme for photos on the system, 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.
QCameraImageCapture::capture returns the capture Id parameter, used with imageExposed(), imageCaptured() and imageSaved() signals.
QImageEncoderSettings QCameraImageCapture::encodingSettings () const
Returns the image encoder settings being used.
See also setEncodingSettings().
Error QCameraImageCapture::error () const
Returns the current error state.
See also errorString().
void QCameraImageCapture::error ( int id, QCameraImageCapture::Error error, const QString & errorString ) [signal]
Signals that the capture request id has failed with an error and errorString description.
QString QCameraImageCapture::errorString () const
Returns a string describing the current error state.
See also error().
void QCameraImageCapture::imageCaptured ( int id, const QImage & preview ) [signal]
Signal emited when the frame with request id was captured, but not processed and saved yet. Frame preview can be displayed to user.
QString QCameraImageCapture::imageCodecDescription ( const QString & codec ) const
Returns a description of an image codec.
void QCameraImageCapture::imageExposed ( int id ) [signal]
Signal emited when the frame with request id was exposed.
void QCameraImageCapture::imageSaved ( int id, const QString & fileName ) [signal]
Signal emited when the frame with request id was saved to fileName.
bool QCameraImageCapture::isAvailable () const
Returns true if the images capture service ready to use.
QMediaObject * QCameraImageCapture::mediaObject () const [virtual]
Reimplemented from QMediaBindableInterface::mediaObject().
See also setMediaObject().
void QCameraImageCapture::readyForCaptureChanged ( bool ready ) [signal]
Signals that a camera's ready for capture state has changed.
void QCameraImageCapture::setEncodingSettings ( const QImageEncoderSettings & settings )
Sets the image encodeing settings.
If some parameters are not specified, or null settings are passed, the encoder choose the default encoding parameters.
See also encodingSettings().
bool QCameraImageCapture::setMediaObject ( QMediaObject * mediaObject ) [virtual protected]
Reimplemented from QMediaBindableInterface::setMediaObject().
See also mediaObject().
QStringList QCameraImageCapture::supportedImageCodecs () const
Returns a list of supported image codecs.
QList<QSize> QCameraImageCapture::supportedResolutions ( const QImageEncoderSettings & settings = QImageEncoderSettings(), bool * continuous = 0 ) const
Returns a list of resolutions images can be encoded at.
If non null image settings parameter is passed, the returned list is reduced to resolution supported with partial settings like image codec or quality applied.
If the encoder supports arbitrary resolutions within the supported range, *continuous is set to true, otherwise *continuous is set to false.
See also QImageEncoderSettings::resolution().