MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

Contents

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.

© 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide.

All other trademarks are property of their respective owners. Privacy Policy


Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia.

Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.