Qt Mobility Reference Documentation

QCameraExposure Class Reference

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

 #include <QCameraExposure>

This class is under development and is subject to change.


Public Types

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

Properties


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

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 )

Signals

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

Detailed Description

The QCameraExposure class provides interface for exposure related camera settings.

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.


Member Type Documentation

enum QCameraExposure::ExposureMode

ConstantValueDescription
QCameraExposure::ExposureManual1Manual mode.
QCameraExposure::ExposureAuto0Automatic mode.
QCameraExposure::ExposureNight3Night mode.
QCameraExposure::ExposureBacklight4Backlight exposure mode.
QCameraExposure::ExposureSpotlight5Spotlight exposure mode.
QCameraExposure::ExposureSports6Spots exposure mode.
QCameraExposure::ExposureSnow7Snow exposure mode.
QCameraExposure::ExposureBeach8Beach exposure mode.
QCameraExposure::ExposureLargeAperture9Use larger aperture with small depth of field.
QCameraExposure::ExposureSmallAperture10Use smaller aperture.
QCameraExposure::ExposurePortrait2Portrait exposure mode.
QCameraExposure::ExposureModeVendor1000The base value for device specific exposure modes.

enum QCameraExposure::FlashMode
flags QCameraExposure::FlashModes

ConstantValueDescription
QCameraExposure::FlashOff0x2Flash is Off.
QCameraExposure::FlashOn0x4Flash is On.
QCameraExposure::FlashAuto0x1Automatic flash.
QCameraExposure::FlashRedEyeReduction0x8Red eye reduction flash.
QCameraExposure::FlashFill0x10Use flash to fillin shadows.
QCameraExposure::FlashTorch0x20Constant light source, useful for focusing and video capture.
QCameraExposure::FlashSlowSyncFrontCurtain0x40Use the flash in conjunction with a slow shutter speed. This mode allows better exposure of distant objects and/or motion blur effect.
QCameraExposure::FlashSlowSyncRearCurtain0x80The similar mode to FlashSlowSyncFrontCurtain but flash is fired at the end of exposure.
QCameraExposure::FlashManual0x100Flash power is manualy set.

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

enum QCameraExposure::MeteringMode

ConstantValueDescription
QCameraExposure::MeteringAverage2Center weighted average metering mode.
QCameraExposure::MeteringSpot3Spot metering mode.
QCameraExposure::MeteringMatrix1Matrix metering mode.

Property Documentation

aperture : qreal

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

Access functions:

qreal aperture () const
void setManualAperture ( qreal aperture )

Notifier signal:

void apertureChanged ( qreal value )

exposureCompensation : qreal

This property holds exposure compensation in EV units.

Exposure compensation property allows to adjust the automatically calculated exposure.

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.

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.

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.

Access functions:

bool isFlashReady () const

Notifier signal:

void flashReady ( bool )

isoSensitivity : int

This property holds the sensor ISO sensitivity.

Access functions:

int isoSensitivity () const
void setManualIsoSensitivity ( int iso )

Notifier signal:

void isoSensitivityChanged ( int value )

See also QCameraExposure::supportedIsoSensitivities() and QCameraExposure::setAutoIsoSensitivity().

meteringMode : QCameraExposure::MeteringMode

This property holds the metering mode being used.

Access functions:

MeteringMode meteringMode () const
void setMeteringMode ( MeteringMode mode )

See also QCameraExposure::isMeteringModeSupported().

shutterSpeed : qreal

This property holds the effective length of time the shutter is open in seconds.

Access functions:

qreal shutterSpeed () const
void setManualShutterSpeed ( qreal seconds )

Notifier signal:

void shutterSpeedChanged ( qreal speed )

Member Function Documentation

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

Signal emitted when aperature changes to value.

void QCameraExposure::apertureRangeChanged () [signal]

Signal emitted when aperature range has changed.

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

Signal emitted when the exposure compensation changes to value.

void QCameraExposure::flashReady ( bool ) [signal]

bool QCameraExposure::isAvailable () const

Returns true if exposure settings are supported by this camera.

bool QCameraExposure::isExposureModeSupported ( ExposureMode mode ) const

Returns true if the exposure mode is supported.

bool QCameraExposure::isFlashModeSupported ( FlashModes mode ) const

Returns true if the flash mode is supported.

bool QCameraExposure::isMeteringModeSupported ( MeteringMode mode ) const

Returns true if the metering mode is supported.

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

Signal emitted when sensitivity changes to value.

void QCameraExposure::setAutoAperture () [slot]

Turn on auto aperture

void QCameraExposure::setAutoIsoSensitivity () [slot]

Turn on auto sensitivity

void QCameraExposure::setAutoShutterSpeed () [slot]

Turn on auto shutter speed

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

Signals that a camera's shutter speed has changed.

void QCameraExposure::shutterSpeedRangeChanged () [signal]

Signal emitted when the shutter speed range has changed.

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

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

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.

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.

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.