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 { 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.

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 QCamera.


Member Type Documentation

enum QCameraExposureControl::ExposureParameter

ConstantValueDescription
QCameraExposureControl::InvalidParameter0Parameter is invalid.
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

ConstantValueDescription
QCameraExposureControl::AutomaticValue0x01Use the automatic values for parameters.
QCameraExposureControl::ReadOnly0x02Parameters are read only.
QCameraExposureControl::ContinuousRange0x04Parameters are continous 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.

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.

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

Returns the properties of exposure parameter.

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.

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::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::setMeteringMode ( QCameraExposure::MeteringMode mode ) [pure virtual]

Set the metering mode to mode.

See also meteringMode().

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

Returns the list of supported parameter values;


Macro Documentation

QCameraExposureControl_iid

com.nokia.Qt.QCameraExposureControl/1.0

Defines the interface name of the QCameraExposureControl class.

X

Thank you for giving your feedback.

Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.