MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QCameraExposureControl Class Reference

The QCameraExposureControl class supplies control for exposure related camera parameters. More...

 #include <QCameraExposureControl>

Inherits: QMediaControl.

This class was introduced in Qt Mobility 1.1.

Public Types

enum ExposureParameter { InvalidParameter, ISO, Aperture, ShutterSpeed, ..., ExtendedExposureParameter }
enum ParameterFlag { AutomaticValue, ReadOnly, ContinuousRange }
flags ParameterFlags

Public Functions

~QCameraExposureControl ()
virtual QCameraExposure::ExposureMode exposureMode () const = 0
virtual QVariant exposureParameter ( ExposureParameter parameter ) const = 0
virtual ParameterFlags exposureParameterFlags ( ExposureParameter parameter ) const = 0
virtual QString extendedParameterName ( ExposureParameter parameter ) = 0
virtual bool isExposureModeSupported ( QCameraExposure::ExposureMode mode ) const = 0
virtual bool isMeteringModeSupported ( QCameraExposure::MeteringMode mode ) const = 0
virtual bool isParameterSupported ( ExposureParameter parameter ) const = 0
virtual QCameraExposure::MeteringMode meteringMode () const = 0
virtual void setExposureMode ( QCameraExposure::ExposureMode mode ) = 0
virtual bool setExposureParameter ( ExposureParameter parameter, const QVariant & value ) = 0
virtual void setMeteringMode ( QCameraExposure::MeteringMode mode ) = 0
virtual QVariantList supportedParameterRange ( ExposureParameter parameter ) const = 0
  • 29 public functions inherited from QObject

Signals

void exposureParameterChanged ( int parameter )
void exposureParameterRangeChanged ( int parameter )
void flashReady ( bool ready )

Protected Functions

QCameraExposureControl ( QObject * parent = 0 )
  • 7 protected functions inherited from QObject

Macros

QCameraExposureControl_iid

Additional Inherited Members

  • 1 property inherited from QObject
  • 1 public slot inherited from QObject
  • 1 public variable inherited from QObject
  • 4 static public members inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

The QCameraExposureControl class supplies control for exposure related camera parameters.

The interface name of QCameraExposureControl is com.nokia.Qt.QCameraExposureControl/1.0 as defined in QCameraExposureControl_iid.

See also QCamera.

Member Type Documentation

enum QCameraExposureControl::ExposureParameter

Constant Value Description
QCameraExposureControl::InvalidParameter 0 Parameter is invalid.
QCameraExposureControl::ISO 1 Camera ISO sensitivity, specified as integer value.
QCameraExposureControl::Aperture 2 Lens aperture is specified as an qreal F number. The supported apertures list can change depending on the focal length, in such a case the exposureParameterRangeChanged() signal is emitted.
QCameraExposureControl::ShutterSpeed 3 Shutter speed in seconds, specified as qreal.
QCameraExposureControl::ExposureCompensation 4 Exposure compensation, specified as qreal EV value.
QCameraExposureControl::FlashPower 5 Manual flash power, specified as qreal value. Accepted power range is [0..1.0], with 0 value means no flash and 1.0 corresponds to full flash power.

This value is only used in the manual flash mode.

Constant Value Description
QCameraExposureControl::FlashCompensation 6 Flash compensation, specified as qreal EV value.
QCameraExposureControl::ExtendedExposureParameter 1000 The base value for platform specific extended parameters. For such parameters the sequential values starting from ExtendedExposureParameter shuld be used.

enum QCameraExposureControl::ParameterFlag
flags QCameraExposureControl::ParameterFlags

Constant Value Description
QCameraExposureControl::AutomaticValue 0x01 Use the automatic values for parameters.
QCameraExposureControl::ReadOnly 0x02 Parameters are read only.
QCameraExposureControl::ContinuousRange 0x04 Parameters are continuous in their range.

The ParameterFlags type is a typedef for QFlags<ParameterFlag>. It stores an OR combination of ParameterFlag values.

Member Function Documentation

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

Constructs a camera exposure control object with parent.

QCameraExposureControl::~QCameraExposureControl ()

Destruct the camera control object.

QCameraExposure::ExposureMode QCameraExposureControl::exposureMode () const [pure virtual]

Returns the exposure mode.

This function was introduced in Qt Mobility 1.1.

See also setExposureMode().

QVariant QCameraExposureControl::exposureParameter ( ExposureParameter parameter ) const [pure virtual]

Returns the exposure parameter value, or invalid QVariant() if the value is unknown or not supported.

This function was introduced in Qt Mobility 1.1.

See also setExposureParameter().

void QCameraExposureControl::exposureParameterChanged ( int parameter ) [signal]

Signal emitted when the exposure parameter has changed.

This function was introduced in Qt Mobility 1.1.

ParameterFlags QCameraExposureControl::exposureParameterFlags ( ExposureParameter parameter ) const [pure virtual]

Returns the properties of exposure parameter.

This function was introduced in Qt Mobility 1.1.

void QCameraExposureControl::exposureParameterRangeChanged ( int parameter ) [signal]

Signal emitted when the exposure parameter range has changed.

This function was introduced in Qt Mobility 1.1.

QString QCameraExposureControl::extendedParameterName ( ExposureParameter parameter ) [pure virtual]

Returns the extended exposure parameter name.

This function was introduced in Qt Mobility 1.1.

void QCameraExposureControl::flashReady ( bool ready ) [signal]

Signal emitted when flash state changes, flash is charged ready.

This function was introduced in Qt Mobility 1.1.

bool QCameraExposureControl::isExposureModeSupported ( QCameraExposure::ExposureMode mode ) const [pure virtual]

Returns true if the exposure mode is supported.

This function was introduced in Qt Mobility 1.1.

bool QCameraExposureControl::isMeteringModeSupported ( QCameraExposure::MeteringMode mode ) const [pure virtual]

Returns true if the metering mode is supported.

This function was introduced in Qt Mobility 1.1.

bool QCameraExposureControl::isParameterSupported ( ExposureParameter parameter ) const [pure virtual]

Returns true is exposure parameter is supported by backend.

This function was introduced in Qt Mobility 1.1.

QCameraExposure::MeteringMode QCameraExposureControl::meteringMode () const [pure virtual]

Returns the current metering mode.

This function was introduced in Qt Mobility 1.1.

See also setMeteringMode().

void QCameraExposureControl::setExposureMode ( QCameraExposure::ExposureMode mode ) [pure virtual]

Set the exposure mode to mode.

This function was introduced in Qt Mobility 1.1.

See also exposureMode().

bool QCameraExposureControl::setExposureParameter ( ExposureParameter parameter, const QVariant & value ) [pure virtual]

Set the exposure parameter to value. If a null or invalid QVariant is passed, backend should choose the value automatically, and if possible report the actual value to user with QCameraExposureControl::exposureParameter().

Returns true if parameter is supported and value is correct.

This function was introduced in Qt Mobility 1.1.

See also exposureParameter().

void QCameraExposureControl::setMeteringMode ( QCameraExposure::MeteringMode mode ) [pure virtual]

Set the metering mode to mode.

This function was introduced in Qt Mobility 1.1.

See also meteringMode().

QVariantList QCameraExposureControl::supportedParameterRange ( ExposureParameter parameter ) const [pure virtual]

Returns the list of supported parameter values;

This function was introduced in Qt Mobility 1.1.

Macro Documentation

QCameraExposureControl_iid

com.nokia.Qt.QCameraExposureControl/1.0

Defines the interface name of the QCameraExposureControl class.