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, ..., ExposurePortrait } |
enum | FlashMode { FlashOff, FlashOn, FlashAuto, FlashRedEyeReduction, ..., FlashManual } |
flags | FlashModes |
enum | MeteringMode { MeteringAverage, MeteringSpot, MeteringMatrix } |
Properties
Public Functions
Public Slots
Signals
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
|
Constant | Value | Description |
QCameraExposure::ExposureManual | 0 | Manual mode. |
QCameraExposure::ExposureAuto | 1 | Automatic mode. |
QCameraExposure::ExposureNight | 2 | Night mode. |
QCameraExposure::ExposureBacklight | 3 | Backlight exposure mode. |
QCameraExposure::ExposureSpotlight | 4 | Spotlight exposure mode. |
QCameraExposure::ExposureSports | 5 | Spots exposure mode. |
QCameraExposure::ExposureSnow | 6 | Snow exposure mode. |
QCameraExposure::ExposureBeach | 7 | Beach exposure mode. |
QCameraExposure::ExposureLargeAperture | 8 | Use larger aperture with small depth of field. |
QCameraExposure::ExposureSmallAperture | 9 | Use smaller aperture. |
QCameraExposure::ExposurePortrait | 10 | Portrait exposure mode. |
enum QCameraExposure::FlashMode
flags QCameraExposure::FlashModes
|
Constant | Value | Description |
QCameraExposure::FlashOff | 0x1 | Flash is Off. |
QCameraExposure::FlashOn | 0x2 | Flash is On. |
QCameraExposure::FlashAuto | 0x4 | 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 | 1 | Center weighted average metering mode. |
QCameraExposure::MeteringSpot | 2 | Spot metering mode. |
QCameraExposure::MeteringMatrix | 0 | Matrix 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:
exposureCompensation : qreal
This property holds camera exposure compensation, in EV.
Access functions:
qreal | exposureCompensation () const |
void | setExposureCompensation ( qreal ev ) |
isoSensitivity : int
This property holds the sensor ISO sensitivity.
Access functions:
int | isoSensitivity () const |
void | setManualIsoSensitivity ( int iso ) |
Notifier signal:
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:
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.
ExposureMode QCameraExposure::exposureMode () const
Returns the exposure mode being used.
See also setExposureMode().
FlashModes QCameraExposure::flashMode () const
Returns the flash mode being used.
See also setFlashMode().
void QCameraExposure::flashReady ( bool ready ) [signal]
Signal emitted when flash status changed, flash is ready if ready true.
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::isFlashReady () const
Returns true if flash is charged.
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.
MeteringMode QCameraExposure::meteringMode () const
Returns the metering mode being used.
See also setMeteringMode().
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::setExposureMode ( ExposureMode mode ) [slot]
Set exposure mode to mode
See also exposureMode().
void QCameraExposure::setFlashMode ( FlashModes mode ) [slot]
Set the flash mode to 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 QCameraExposure::setMeteringMode ( MeteringMode mode ) [slot]
Sets the metering mode to mode.
See also meteringMode().
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.