Qt Mobility Reference Documentation

QCameraExposureControl Class Reference

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

 #include <QCameraExposureControl>

This class is under development and is subject to change.

Inherits QMediaControl.


Public Types

enum ExposureParameter { ISO, Aperture, ShutterSpeed, ExposureCompensation, ..., 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 QCameraExposure::FlashModes flashMode () const = 0
virtual bool isExposureModeSupported ( QCameraExposure::ExposureMode mode ) const = 0
virtual bool isFlashModeSupported ( QCameraExposure::FlashModes mode ) const = 0
virtual bool isFlashReady () 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 setFlashMode ( QCameraExposure::FlashModes mode ) = 0
virtual void setMeteringMode ( QCameraExposure::MeteringMode mode ) = 0
virtual QVariantList supportedParameterRange ( ExposureParameter parameter ) const = 0

Signals

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

Protected Functions

QCameraExposureControl ( QObject * parent = 0 )

Macros

QCameraExposureControl_iid

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.

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::control() and QCamera.


Member Type Documentation

enum QCameraExposureControl::ExposureParameter

ConstantValueDescription
QCameraExposureControl::ISO1Camera ISO sensitivity, specified as integer value.
QCameraExposureControl::Aperture2Lens 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 emited.
QCameraExposureControl::ShutterSpeed3Shutter speed in seconds, specified as qreal.
QCameraExposureControl::ExposureCompensation4Exposure compensation, specified as qreal EV value.
QCameraExposureControl::FlashPower5Manual 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.

ConstantValueDescription
QCameraExposureControl::FlashCompensation6Flash compensation, specified as qreal EV value.
QCameraExposureControl::ExtendedExposureParameter1000The 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

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.

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.

See also setExposureParameter().

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

Signal emitted when the exposure parameter has changed to value.

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

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

Signal emitted when the exposure parameter range has changed.

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

Returns the extended exposure parameter name.

QCameraExposure::FlashModes QCameraExposureControl::flashMode () const [pure virtual]

Returns the current flash mode.

See also setFlashMode().

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

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

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

Returns true if the exposure mode is supported.

bool QCameraExposureControl::isFlashModeSupported ( QCameraExposure::FlashModes mode ) const [pure virtual]

Return true if reqested flash mode is supported. Some QCameraExposure::FlashMode values can be combined, for example QCameraExposure::FlashManual | QCameraExposure::FlashSlowSyncRearCurtain

bool QCameraExposureControl::isFlashReady () const [pure virtual]

Returns true if flash is charged.

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

Returns true if the metering mode is supported.

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

Returns true is exposure parameter is supported by backend.

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

Returns the current metering mode.

See also setMeteringMode().

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

Set the exposure mode to mode.

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 automaticaly, and if possible report the actual value to user with QCameraExposureControl::exposureParameter().

Returns true if parameter is supported and value is correct.

See also exposureParameter().

void QCameraExposureControl::setFlashMode ( QCameraExposure::FlashModes mode ) [pure virtual]

Set the current flash mode.

Usually the single QCameraExposure::FlashMode flag is used, but some non conflicting flags combination are also allowed, like QCameraExposure::FlashManual | QCameraExposure::FlashSlowSyncRearCurtain.

See also flashMode().

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

Set the metering mode to mode.

See also meteringMode().

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


Macro Documentation

QCameraExposureControl_iid

com.nokia.Qt.QCameraExposureControl/1.0

Defines the interface name of the QCameraExposureControl class.


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