1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
|
// Copyright (C) 2016 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
#ifndef QCAMERA_H
#define QCAMERA_H
#include <QtCore/qstringlist.h>
#include <QtCore/qpair.h>
#include <QtCore/qsize.h>
#include <QtCore/qpoint.h>
#include <QtCore/qrect.h>
#include <QtCore/qobject.h>
#include <QtMultimedia/qcameradevice.h>
#include <QtMultimedia/qmediaenumdebug.h>
QT_BEGIN_NAMESPACE
class QCameraDevice;
class QPlatformMediaCaptureSession;
class QMediaCaptureSession;
class QCameraPrivate;
class Q_MULTIMEDIA_EXPORT QCamera : public QObject
{
Q_OBJECT
Q_PROPERTY(bool active READ isActive WRITE setActive NOTIFY activeChanged)
// Qt 7: rename to device
Q_PROPERTY(QCameraDevice cameraDevice READ cameraDevice WRITE setCameraDevice NOTIFY cameraDeviceChanged)
Q_PROPERTY(Error error READ error NOTIFY errorChanged)
Q_PROPERTY(QString errorString READ errorString NOTIFY errorChanged)
Q_PROPERTY(QCameraFormat cameraFormat READ cameraFormat WRITE setCameraFormat NOTIFY cameraFormatChanged)
Q_PROPERTY(FocusMode focusMode READ focusMode WRITE setFocusMode NOTIFY focusModeChanged)
Q_PROPERTY(QPointF focusPoint READ focusPoint NOTIFY focusPointChanged)
Q_PROPERTY(QPointF customFocusPoint READ customFocusPoint WRITE setCustomFocusPoint NOTIFY customFocusPointChanged)
Q_PROPERTY(float focusDistance READ focusDistance WRITE setFocusDistance NOTIFY focusDistanceChanged)
Q_PROPERTY(float minimumZoomFactor READ minimumZoomFactor NOTIFY minimumZoomFactorChanged)
Q_PROPERTY(float maximumZoomFactor READ maximumZoomFactor NOTIFY maximumZoomFactorChanged)
Q_PROPERTY(float zoomFactor READ zoomFactor WRITE setZoomFactor NOTIFY zoomFactorChanged)
Q_PROPERTY(float exposureTime READ exposureTime NOTIFY exposureTimeChanged)
Q_PROPERTY(int manualExposureTime READ manualExposureTime WRITE setManualExposureTime NOTIFY manualExposureTimeChanged)
Q_PROPERTY(int isoSensitivity READ isoSensitivity NOTIFY isoSensitivityChanged)
Q_PROPERTY(int manualIsoSensitivity READ manualIsoSensitivity WRITE setManualIsoSensitivity NOTIFY manualIsoSensitivityChanged)
Q_PROPERTY(float exposureCompensation READ exposureCompensation WRITE setExposureCompensation NOTIFY exposureCompensationChanged)
Q_PROPERTY(QCamera::ExposureMode exposureMode READ exposureMode WRITE setExposureMode NOTIFY exposureModeChanged)
Q_PROPERTY(bool flashReady READ isFlashReady NOTIFY flashReady)
Q_PROPERTY(QCamera::FlashMode flashMode READ flashMode WRITE setFlashMode NOTIFY flashModeChanged)
Q_PROPERTY(QCamera::TorchMode torchMode READ torchMode WRITE setTorchMode NOTIFY torchModeChanged)
Q_PROPERTY(WhiteBalanceMode whiteBalanceMode READ whiteBalanceMode WRITE setWhiteBalanceMode NOTIFY whiteBalanceModeChanged)
Q_PROPERTY(int colorTemperature READ colorTemperature WRITE setColorTemperature NOTIFY colorTemperatureChanged)
Q_PROPERTY(Features supportedFeatures READ supportedFeatures NOTIFY supportedFeaturesChanged)
public:
enum Error
{
NoError,
CameraError
};
Q_ENUM(Error)
enum FocusMode {
FocusModeAuto,
FocusModeAutoNear,
FocusModeAutoFar,
FocusModeHyperfocal,
FocusModeInfinity,
FocusModeManual
};
Q_ENUM(FocusMode)
enum FlashMode {
FlashOff,
FlashOn,
FlashAuto
};
Q_ENUM(FlashMode)
enum TorchMode {
TorchOff,
TorchOn,
TorchAuto
};
Q_ENUM(TorchMode)
enum ExposureMode {
ExposureAuto,
ExposureManual,
ExposurePortrait,
ExposureNight,
ExposureSports,
ExposureSnow,
ExposureBeach,
ExposureAction,
ExposureLandscape,
ExposureNightPortrait,
ExposureTheatre,
ExposureSunset,
ExposureSteadyPhoto,
ExposureFireworks,
ExposureParty,
ExposureCandlelight,
ExposureBarcode
};
Q_ENUM(ExposureMode)
enum WhiteBalanceMode {
WhiteBalanceAuto = 0,
WhiteBalanceManual = 1,
WhiteBalanceSunlight = 2,
WhiteBalanceCloudy = 3,
WhiteBalanceShade = 4,
WhiteBalanceTungsten = 5,
WhiteBalanceFluorescent = 6,
WhiteBalanceFlash = 7,
WhiteBalanceSunset = 8
};
Q_ENUM(WhiteBalanceMode)
enum class Feature {
ColorTemperature = 0x1,
ExposureCompensation = 0x2,
IsoSensitivity = 0x4,
ManualExposureTime = 0x8,
CustomFocusPoint = 0x10,
FocusDistance = 0x20
};
Q_DECLARE_FLAGS(Features, Feature)
explicit QCamera(QObject *parent = nullptr);
explicit QCamera(const QCameraDevice& cameraDevice, QObject *parent = nullptr);
explicit QCamera(QCameraDevice::Position position, QObject *parent = nullptr);
~QCamera();
bool isAvailable() const;
bool isActive() const;
QMediaCaptureSession *captureSession() const;
QCameraDevice cameraDevice() const;
void setCameraDevice(const QCameraDevice &cameraDevice);
QCameraFormat cameraFormat() const;
void setCameraFormat(const QCameraFormat &format);
Error error() const;
QString errorString() const;
Features supportedFeatures() const;
FocusMode focusMode() const;
void setFocusMode(FocusMode mode);
Q_INVOKABLE bool isFocusModeSupported(FocusMode mode) const;
QPointF focusPoint() const;
QPointF customFocusPoint() const;
void setCustomFocusPoint(const QPointF &point);
void setFocusDistance(float d);
float focusDistance() const;
float minimumZoomFactor() const;
float maximumZoomFactor() const;
float zoomFactor() const;
void setZoomFactor(float factor);
FlashMode flashMode() const;
Q_INVOKABLE bool isFlashModeSupported(FlashMode mode) const;
Q_INVOKABLE bool isFlashReady() const;
TorchMode torchMode() const;
Q_INVOKABLE bool isTorchModeSupported(TorchMode mode) const;
ExposureMode exposureMode() const;
Q_INVOKABLE bool isExposureModeSupported(ExposureMode mode) const;
float exposureCompensation() const;
int isoSensitivity() const;
int manualIsoSensitivity() const;
float exposureTime() const;
float manualExposureTime() const;
int minimumIsoSensitivity() const;
int maximumIsoSensitivity() const;
float minimumExposureTime() const;
float maximumExposureTime() const;
WhiteBalanceMode whiteBalanceMode() const;
Q_INVOKABLE bool isWhiteBalanceModeSupported(WhiteBalanceMode mode) const;
int colorTemperature() const;
public Q_SLOTS:
void setActive(bool active);
void start() { setActive(true); }
void stop() { setActive(false); }
void zoomTo(float zoom, float rate);
void setFlashMode(FlashMode mode);
void setTorchMode(TorchMode mode);
void setExposureMode(ExposureMode mode);
void setExposureCompensation(float ev);
void setManualIsoSensitivity(int iso);
void setAutoIsoSensitivity();
void setManualExposureTime(float seconds);
void setAutoExposureTime();
void setWhiteBalanceMode(WhiteBalanceMode mode);
void setColorTemperature(int colorTemperature);
Q_SIGNALS:
void activeChanged(bool);
void errorChanged();
void errorOccurred(QCamera::Error error, const QString &errorString);
void cameraDeviceChanged();
void cameraFormatChanged();
void supportedFeaturesChanged();
void focusModeChanged();
void zoomFactorChanged(float);
void minimumZoomFactorChanged(float);
void maximumZoomFactorChanged(float);
void focusDistanceChanged(float);
void focusPointChanged();
void customFocusPointChanged();
void flashReady(bool);
void flashModeChanged();
void torchModeChanged();
void exposureTimeChanged(float speed);
void manualExposureTimeChanged(float speed);
void isoSensitivityChanged(int);
void manualIsoSensitivityChanged(int);
void exposureCompensationChanged(float);
void exposureModeChanged();
void whiteBalanceModeChanged() QT6_ONLY(const);
void colorTemperatureChanged() QT6_ONLY(const);
void brightnessChanged();
void contrastChanged();
void saturationChanged();
void hueChanged();
private:
class QPlatformCamera *platformCamera();
void setCaptureSession(QMediaCaptureSession *session);
friend class QMediaCaptureSession;
Q_DISABLE_COPY(QCamera)
Q_DECLARE_PRIVATE(QCamera)
Q_PRIVATE_SLOT(d_func(), void _q_error(int, const QString &))
friend class QCameraDevice;
};
Q_DECLARE_OPERATORS_FOR_FLAGS(QCamera::Features)
QT_END_NAMESPACE
Q_MEDIA_ENUM_DEBUG(QCamera, Error)
#endif // QCAMERA_H
|
