|
|
              
QCameraExposure Class ReferenceThe QCameraExposure class provides interface for exposure related camera settings. More... #include <QCameraExposure> Inherits QObject. Public Types
Properties
Public Functions
Public Slots
Signals
Additional Inherited Members
Detailed DescriptionThe QCameraExposure class provides interface for exposure related camera settings. Member Type Documentation
|
| 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
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.
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.
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 ready ) |
isoSensitivity : const int
This property holds the sensor ISO sensitivity.
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.
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.
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.
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 ready ) [signal]
Signal the flash ready status has changed.
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::setManualAperture ( qreal aperture ) [slot]
Sets the manual camera aperture value.
void QCameraExposure::setManualIsoSensitivity ( int iso ) [slot]
Sets the manual sensitivity to iso
void QCameraExposure::setManualShutterSpeed ( qreal seconds ) [slot]
Set the manual shutter speed to seconds
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 emitted.
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.