MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QCameraExposure Class Reference

The QCameraExposure class provides interface for exposure related camera settings. More...

 #include <QCameraExposure>

Inherits: QObject.

This class was introduced in Qt Mobility 1.1.

Public Types

enum ExposureMode { ExposureManual, ExposureAuto, ExposureNight, ExposureBacklight, ..., ExposureModeVendor }
enum FlashMode { FlashOff, FlashOn, FlashAuto, FlashRedEyeReduction, ..., FlashManual }
flags FlashModes
enum MeteringMode { MeteringAverage, MeteringSpot, MeteringMatrix }

Properties

  • 1 property inherited from QObject

Public Functions

qreal aperture () const
qreal exposureCompensation () const
ExposureMode exposureMode () const
FlashModes flashMode () const
bool isAvailable () const
bool isExposureModeSupported ( ExposureMode mode ) const
bool isFlashModeSupported ( FlashModes mode ) const
bool isFlashReady () const
bool isMeteringModeSupported ( MeteringMode mode ) const
int isoSensitivity () const
MeteringMode meteringMode () const
qreal shutterSpeed () const
QList<qreal> supportedApertures ( bool * continuous = 0 ) const
QList<int> supportedIsoSensitivities ( bool * continuous = 0 ) const
QList<qreal> supportedShutterSpeeds ( bool * continuous = 0 ) const
  • 29 public functions inherited from QObject

Public Slots

void setAutoAperture ()
void setAutoIsoSensitivity ()
void setAutoShutterSpeed ()
void setExposureCompensation ( qreal ev )
void setExposureMode ( ExposureMode mode )
void setFlashMode ( FlashModes mode )
void setManualAperture ( qreal aperture )
void setManualIsoSensitivity ( int iso )
void setManualShutterSpeed ( qreal seconds )
void setMeteringMode ( MeteringMode mode )
  • 1 public slot inherited from QObject

Signals

void apertureChanged ( qreal value )
void apertureRangeChanged ()
void exposureCompensationChanged ( qreal value )
void flashReady ( bool ready )
void isoSensitivityChanged ( int value )
void shutterSpeedChanged ( qreal speed )
void shutterSpeedRangeChanged ()

Additional Inherited Members

  • 1 public variable inherited from QObject
  • 4 static public members inherited from QObject
  • 7 protected functions inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

The QCameraExposure class provides interface for exposure related camera settings.

Member Type Documentation

enum QCameraExposure::ExposureMode

Constant Value Description
QCameraExposure::ExposureManual 1 Manual mode.
QCameraExposure::ExposureAuto 0 Automatic mode.
QCameraExposure::ExposureNight 3 Night mode.
QCameraExposure::ExposureBacklight 4 Backlight exposure mode.
QCameraExposure::ExposureSpotlight 5 Spotlight exposure mode.
QCameraExposure::ExposureSports 6 Spots exposure mode.
QCameraExposure::ExposureSnow 7 Snow exposure mode.
QCameraExposure::ExposureBeach 8 Beach exposure mode.
QCameraExposure::ExposureLargeAperture 9 Use larger aperture with small depth of field.
QCameraExposure::ExposureSmallAperture 10 Use smaller aperture.
QCameraExposure::ExposurePortrait 2 Portrait exposure mode.
QCameraExposure::ExposureModeVendor 1000 The base value for device specific exposure modes.

enum QCameraExposure::FlashMode
flags QCameraExposure::FlashModes

Constant Value Description
QCameraExposure::FlashOff 0x2 Flash is Off.
QCameraExposure::FlashOn 0x4 Flash is On.
QCameraExposure::FlashAuto 0x1 Automatic flash.
QCameraExposure::FlashRedEyeReduction 0x8 Red eye reduction flash.
QCameraExposure::FlashFill 0x10 Use flash to fillin shadows.
QCameraExposure::FlashTorch 0x20 Constant light source, useful for focusing and video capture.
QCameraExposure::FlashSlowSyncFrontCurtain 0x40 Use the flash in conjunction with a slow shutter speed. This mode allows better exposure of distant objects and/or motion blur effect.
QCameraExposure::FlashSlowSyncRearCurtain 0x80 The similar mode to FlashSlowSyncFrontCurtain but flash is fired at the end of exposure.
QCameraExposure::FlashManual 0x100 Flash power is manualy set.

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

enum QCameraExposure::MeteringMode

Constant Value Description
QCameraExposure::MeteringAverage 2 Center weighted average metering mode.
QCameraExposure::MeteringSpot 3 Spot metering mode.
QCameraExposure::MeteringMatrix 1 Matrix metering mode.

Property Documentation

aperture : const qreal

This property holds lens aperture is specified as an F number, the ratio of the focal length to effective aperture diameter.

This property was introduced in Qt Mobility 1.1.

Access functions:

qreal aperture () const

Notifier signal:

void apertureChanged ( qreal value )

See also supportedApertures(), setAutoAperture(), and setManualAperture().

exposureCompensation : qreal

This property holds exposure compensation in EV units.

Exposure compensation property allows to adjust the automatically calculated exposure.

This property was introduced in Qt Mobility 1.1.

Access functions:

qreal exposureCompensation () const
void setExposureCompensation ( qreal ev )

Notifier signal:

void exposureCompensationChanged ( qreal value )

exposureMode : QCameraExposure::ExposureMode

This property holds the exposure mode being used.

This property was introduced in Qt Mobility 1.1.

Access functions:

ExposureMode exposureMode () const
void setExposureMode ( ExposureMode mode )

See also QCameraExposure::isExposureModeSupported().

flashMode : QCameraExposure::FlashModes

This property holds the flash mode being used.

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

This property was introduced in Qt Mobility 1.1.

Access functions:

FlashModes flashMode () const
void setFlashMode ( FlashModes mode )

See also QCameraExposure::isFlashModeSupported() and QCameraExposure::isFlashReady().

flashReady : const bool

This property holds indicates if the flash is charged and ready to use.

This property was introduced in Qt Mobility 1.1.

Access functions:

bool isFlashReady () const

Notifier signal:

void flashReady ( bool ready )

isoSensitivity : const int

This property holds the sensor ISO sensitivity.

This property was introduced in Qt Mobility 1.1.

Access functions:

int isoSensitivity () const

Notifier signal:

void isoSensitivityChanged ( int value )

See also supportedIsoSensitivities(), setAutoIsoSensitivity(), and setManualIsoSensitivity().

meteringMode : QCameraExposure::MeteringMode

This property holds the metering mode being used.

This property was introduced in Qt Mobility 1.1.

Access functions:

MeteringMode meteringMode () const
void setMeteringMode ( MeteringMode mode )

See also QCameraExposure::isMeteringModeSupported().

shutterSpeed : const qreal

This property holds camera's shutter speed in seconds.

This property was introduced in Qt Mobility 1.1.

Access functions:

qreal shutterSpeed () const

Notifier signal:

void shutterSpeedChanged ( qreal speed )

See also supportedShutterSpeeds(), setAutoShutterSpeed(), and setManualShutterSpeed().

Member Function Documentation

void QCameraExposure::apertureChanged ( qreal value ) [signal]

Signal emitted when aperature changes to value.

This function was introduced in Qt Mobility 1.1.

void QCameraExposure::apertureRangeChanged () [signal]

Signal emitted when aperature range has changed.

This function was introduced in Qt Mobility 1.1.

void QCameraExposure::exposureCompensationChanged ( qreal value ) [signal]

Signal emitted when the exposure compensation changes to value.

This function was introduced in Qt Mobility 1.1.

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

Signal the flash ready status has changed.

This function was introduced in Qt Mobility 1.1.

bool QCameraExposure::isAvailable () const

Returns true if exposure settings are supported by this camera.

This function was introduced in Qt Mobility 1.1.

bool QCameraExposure::isExposureModeSupported ( ExposureMode mode ) const

Returns true if the exposure mode is supported.

This function was introduced in Qt Mobility 1.1.

bool QCameraExposure::isFlashModeSupported ( FlashModes mode ) const

Returns true if the flash mode is supported.

This function was introduced in Qt Mobility 1.1.

bool QCameraExposure::isMeteringModeSupported ( MeteringMode mode ) const

Returns true if the metering mode is supported.

This function was introduced in Qt Mobility 1.1.

void QCameraExposure::isoSensitivityChanged ( int value ) [signal]

Signal emitted when sensitivity changes to value.

This function was introduced in Qt Mobility 1.1.

void QCameraExposure::setAutoAperture () [slot]

Turn on auto aperture

This function was introduced in Qt Mobility 1.1.

void QCameraExposure::setAutoIsoSensitivity () [slot]

Turn on auto sensitivity

This function was introduced in Qt Mobility 1.1.

void QCameraExposure::setAutoShutterSpeed () [slot]

Turn on auto shutter speed

This function was introduced in Qt Mobility 1.1.

void QCameraExposure::setManualAperture ( qreal aperture ) [slot]

Sets the manual camera aperture value.

This function was introduced in Qt Mobility 1.1.

void QCameraExposure::setManualIsoSensitivity ( int iso ) [slot]

Sets the manual sensitivity to iso

This function was introduced in Qt Mobility 1.1.

void QCameraExposure::setManualShutterSpeed ( qreal seconds ) [slot]

Set the manual shutter speed to seconds

This function was introduced in Qt Mobility 1.1.

void QCameraExposure::shutterSpeedChanged ( qreal speed ) [signal]

Signals that a camera's shutter speed has changed.

This function was introduced in Qt Mobility 1.1.

void QCameraExposure::shutterSpeedRangeChanged () [signal]

Signal emitted when the shutter speed range has changed.

This function was introduced in Qt Mobility 1.1.

QList<qreal> QCameraExposure::supportedApertures ( bool * continuous = 0 ) const

Returns the list of aperture values camera supports. The apertures list can change depending on the focal length, in such a case the apertureRangeChanged() signal is emitted.

If the camera supports arbitrary aperture values within the supported range, *continuous is set to true, otherwise *continuous is set to false.

This function was introduced in Qt Mobility 1.1.

QList<int> QCameraExposure::supportedIsoSensitivities ( bool * continuous = 0 ) const

Returns the list of ISO senitivities camera supports.

If the camera supports arbitrary ISO sensitivities within the supported range, *continuous is set to true, otherwise *continuous is set to false.

This function was introduced in Qt Mobility 1.1.

QList<qreal> QCameraExposure::supportedShutterSpeeds ( bool * continuous = 0 ) const

Returns the list of shutter speed values in seconds camera supports.

If the camera supports arbitrary shutter speed values within the supported range, *continuous is set to true, otherwise *continuous is set to false.

This function was introduced in Qt Mobility 1.1.