QCameraExposureControl Class
The QCameraExposureControl class allows controlling camera exposure parameters. More...
| Header: | #include <QCameraExposureControl> |
| qmake: | QT += multimedia |
| Inherits: | QMediaControl |
Public Types
| enum | ExposureParameter { ISO, Aperture, ShutterSpeed, ExposureCompensation, ..., ExtendedExposureParameter } |
Public Functions
| virtual | ~QCameraExposureControl() |
| virtual QVariant | actualValue(QCameraExposureControl::ExposureParameter parameter) const = 0 |
| virtual bool | isParameterSupported(QCameraExposureControl::ExposureParameter parameter) const = 0 |
| virtual QVariant | requestedValue(QCameraExposureControl::ExposureParameter parameter) const = 0 |
| virtual bool | setValue(QCameraExposureControl::ExposureParameter parameter, const QVariant &value) = 0 |
| virtual QVariantList | supportedParameterRange(QCameraExposureControl::ExposureParameter parameter, bool *continuous) const = 0 |
Signals
| void | actualValueChanged(int parameter) |
| void | parameterRangeChanged(int parameter) |
| void | requestedValueChanged(int parameter) |
Protected Functions
| QCameraExposureControl(QObject *parent = nullptr) |
Macros
Detailed Description
The QCameraExposureControl class allows controlling camera exposure parameters.
The QCameraExposure class is the usual method of adjusting exposure related parameters when using camera functionality. This class provides a more complete but less easy to use interface, and also forms the interface to implement when writing a new implementation of QCamera functionality.
You can adjust a number of parameters that will affect images and video taken with the corresponding QCamera object - see the ExposureParameter enumeration.
The interface name of QCameraExposureControl is org.qt-project.qt.cameraexposurecontrol/5.0 as defined in QCameraExposureControl_iid.
See also QCameraExposure and QCamera.
Member Type Documentation
enum QCameraExposureControl::ExposureParameter
| Constant | Value | Description |
|---|---|---|
QCameraExposureControl::ISO | 0 | Camera ISO sensitivity, specified as integer value. |
QCameraExposureControl::Aperture | 1 | Lens aperture is specified as an qreal F number. The supported apertures list can change depending on the focal length, in such a case the exposureParameterRangeChanged() signal is emitted. |
QCameraExposureControl::ShutterSpeed | 2 | Shutter speed in seconds, specified as qreal. |
QCameraExposureControl::ExposureCompensation | 3 | Exposure compensation, specified as qreal EV value. |
QCameraExposureControl::FlashPower | 4 | Manual flash power, specified as qreal value. Accepted power range is [0..1.0], with 0 value means no flash and 1.0 corresponds to full flash power. |
This value is only used in the manual flash mode.
| Constant | Value | Description |
|---|---|---|
QCameraExposureControl::TorchPower | 6 | Manual torch power, specified as qreal value. Accepted power range is [0..1.0], with 0 value means no light and 1.0 corresponds to full torch power. |
This value is only used in the torch flash mode.
| Constant | Value | Description |
|---|---|---|
QCameraExposureControl::FlashCompensation | 5 | Flash compensation, specified as qreal EV value. |
QCameraExposureControl::SpotMeteringPoint | 7 | The relative frame coordinate of the point to use for exposure metering in spot metering mode, specified as a QPointF. |
QCameraExposureControl::ExposureMode | 8 | Camera exposure mode. |
QCameraExposureControl::MeteringMode | 9 | Camera metering mode. |
QCameraExposureControl::ExtendedExposureParameter | 1000 | The base value for platform specific extended parameters. For such parameters the sequential values starting from ExtendedExposureParameter should be used. |
Member Function Documentation
[protected] QCameraExposureControl::QCameraExposureControl(QObject *parent = nullptr)
Constructs a camera exposure control object with parent.
[virtual] QCameraExposureControl::~QCameraExposureControl()
Destroys the camera exposure control object.
[pure virtual] QVariant QCameraExposureControl::actualValue(QCameraExposureControl::ExposureParameter parameter) const
[signal] void QCameraExposureControl::actualValueChanged(int parameter)
[pure virtual] bool QCameraExposureControl::isParameterSupported(QCameraExposureControl::ExposureParameter parameter) const
[signal] void QCameraExposureControl::parameterRangeChanged(int parameter)
[pure virtual] QVariant QCameraExposureControl::requestedValue(QCameraExposureControl::ExposureParameter parameter) const
[signal] void QCameraExposureControl::requestedValueChanged(int parameter)
[pure virtual] bool QCameraExposureControl::setValue(QCameraExposureControl::ExposureParameter parameter, const QVariant &value)
[pure virtual] QVariantList QCameraExposureControl::supportedParameterRange(QCameraExposureControl::ExposureParameter parameter, bool *continuous) const
Macro Documentation
QCameraExposureControl_iid
org.qt-project.qt.cameraexposurecontrol/5.0
Defines the interface name of the QCameraExposureControl class.