Qt Mobility Reference Documentation

QCameraControl Class Reference

The QCameraControl class is an abstract base class for classes that control still cameras or video cameras. More...

 #include <QCameraControl>

This class is under development and is subject to change.

Inherits QMediaControl.


Public Functions

~QCameraControl ()
virtual QCamera::CaptureMode captureMode () const = 0
virtual bool isCaptureModeSupported ( QCamera::CaptureMode mode ) const = 0
virtual void setCaptureMode ( QCamera::CaptureMode mode ) = 0
virtual void setState ( QCamera::State state ) = 0
virtual QCamera::State state () const = 0

Signals

void captureModeChanged ( QCamera::CaptureMode mode )
void error ( int error, const QString & errorString )
void stateChanged ( QCamera::State state )

Protected Functions

QCameraControl ( QObject * parent = 0 )

Macros

QCameraControl_iid

Detailed Description

The QCameraControl class is an abstract base class for classes that control still cameras or video cameras.

This service is provided by a QMediaService object via QMediaService::control(). It is used by QCamera.

The interface name of QCameraControl is com.nokia.Qt.QCameraControl/1.0 as defined in QCameraControl_iid.

The Camera API of Qt Mobility is still in Technology Preview. It has not undergone the same level of review and testing as the rest of the APIs.

The API exposed by the classes in this component are not stable, and will undergo modification or removal prior to the final release of Qt Mobility.

See also QMediaService::requestControl() and QCamera.


Member Function Documentation

QCameraControl::QCameraControl ( QObject * parent = 0 ) [protected]

Constructs a camera control object with parent.

QCameraControl::~QCameraControl ()

Destruct the camera control object.

QCamera::CaptureMode QCameraControl::captureMode () const [pure virtual]

Returns the current capture mode.

See also setCaptureMode().

void QCameraControl::captureModeChanged ( QCamera::CaptureMode mode ) [signal]

Signal emitted when the camera capture mode changes.

void QCameraControl::error ( int error, const QString & errorString ) [signal]

Signal emitted when an error occurs with error code error and a description of the error errorString.

bool QCameraControl::isCaptureModeSupported ( QCamera::CaptureMode mode ) const [pure virtual]

Returns true if the capture mode is suported. QCamera::CaptureDisabled mode is always considered supported and not checked by backend.

Backend should return supported modes even in Stopped state.

void QCameraControl::setCaptureMode ( QCamera::CaptureMode mode ) [pure virtual]

Sets the current capture mode.

Setting the capture mode also triggers asynchronous camera state change to QCamera::Idle, to allow capture settings configuration before the camera is activated.

See also captureMode().

void QCameraControl::setState ( QCamera::State state ) [pure virtual]

Sets the camera state. This operation is asynchronous, with state chages notified with stateChanged() signal.

See also state() and QCamera::State.

QCamera::State QCameraControl::state () const [pure virtual]

Returns the state of the camera service.

See also setState() and QCamera::state.

void QCameraControl::stateChanged ( QCamera::State state ) [signal]

Signal emitted when the camera state changes.


Macro Documentation

QCameraControl_iid

com.nokia.Qt.QCameraControl/1.0

Defines the interface name of the QCameraControl class.


Copyright © 2009-2010 Nokia Corporation and/or its subsidiary(-ies) Trademarks
Qt Mobility Project 1.1.0