MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

Contents

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.

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