1/****************************************************************************
2**
3** Copyright (C) 2016 The Qt Company Ltd.
4** Contact: https://www.qt.io/licensing/
5**
6** This file is part of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The Qt Company. For licensing terms
14** and conditions see https://www.qt.io/terms-conditions. For further
15** information use the contact form at https://www.qt.io/contact-us.
16**
17** GNU Lesser General Public License Usage
18** Alternatively, this file may be used under the terms of the GNU Lesser
19** General Public License version 3 as published by the Free Software
20** Foundation and appearing in the file LICENSE.LGPL3 included in the
21** packaging of this file. Please review the following information to
22** ensure the GNU Lesser General Public License version 3 requirements
23** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
24**
25** GNU General Public License Usage
26** Alternatively, this file may be used under the terms of the GNU
27** General Public License version 2.0 or (at your option) the GNU General
28** Public license version 3 or any later version approved by the KDE Free
29** Qt Foundation. The licenses are as published by the Free Software
30** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
31** included in the packaging of this file. Please review the following
32** information to ensure the GNU General Public License requirements will
33** be met: https://www.gnu.org/licenses/gpl-2.0.html and
34** https://www.gnu.org/licenses/gpl-3.0.html.
35**
36** $QT_END_LICENSE$
37**
38****************************************************************************/
39
40#include <qcamerafocuscontrol.h>
41#include "qmediacontrol_p.h"
42
43QT_BEGIN_NAMESPACE
44
45/*!
46 \class QCameraFocusControl
47 \obsolete
48
49
50 \brief The QCameraFocusControl class supplies control for
51 focusing related camera parameters.
52
53 \inmodule QtMultimedia
54
55
56 \ingroup multimedia_control
57
58 The interface name of QCameraFocusControl is \c org.qt-project.qt.camerafocuscontrol/5.0 as
59 defined in QCameraFocusControl_iid.
60
61
62 \sa QMediaService::requestControl(), QCamera
63*/
64
65/*!
66 \macro QCameraFocusControl_iid
67
68 \c org.qt-project.qt.camerafocuscontrol/5.0
69
70 Defines the interface name of the QCameraFocusControl class.
71
72 \relates QCameraFocusControl
73*/
74
75/*!
76 Constructs a camera control object with \a parent.
77*/
78
79QCameraFocusControl::QCameraFocusControl(QObject *parent):
80 QMediaControl(*new QMediaControlPrivate, parent)
81{
82}
83
84/*!
85 Destruct the camera control object.
86*/
87
88QCameraFocusControl::~QCameraFocusControl()
89{
90}
91
92
93/*!
94 \fn QCameraFocus::FocusModes QCameraFocusControl::focusMode() const
95
96 Returns the focus mode being used.
97*/
98
99
100/*!
101 \fn void QCameraFocusControl::setFocusMode(QCameraFocus::FocusModes mode)
102
103 Set the focus mode to \a mode.
104*/
105
106
107/*!
108 \fn bool QCameraFocusControl::isFocusModeSupported(QCameraFocus::FocusModes mode) const
109
110 Returns true if focus \a mode is supported.
111*/
112
113/*!
114 \fn QCameraFocusControl::focusPointMode() const
115
116 Returns the camera focus point selection mode.
117*/
118
119/*!
120 \fn QCameraFocusControl::setFocusPointMode(QCameraFocus::FocusPointMode mode)
121
122 Sets the camera focus point selection \a mode.
123*/
124
125/*!
126 \fn QCameraFocusControl::isFocusPointModeSupported(QCameraFocus::FocusPointMode mode) const
127
128 Returns true if the camera focus point \a mode is supported.
129*/
130
131/*!
132 \fn QCameraFocusControl::customFocusPoint() const
133
134 Return the position of custom focus point, in relative frame coordinates:
135 QPointF(0,0) points to the left top frame point, QPointF(0.5,0.5) points to the frame center.
136
137 Custom focus point is used only in FocusPointCustom focus mode.
138*/
139
140/*!
141 \fn QCameraFocusControl::setCustomFocusPoint(const QPointF &point)
142
143 Sets the custom focus \a point.
144
145 If camera supports fixed set of focus points,
146 it should use the nearest supported focus point,
147 and return the actual focus point with QCameraFocusControl::focusZones().
148
149 \sa QCameraFocusControl::customFocusPoint(), QCameraFocusControl::focusZones()
150*/
151
152/*!
153 \fn QCameraFocusControl::focusZones() const
154
155 Returns the list of zones, the camera is using for focusing or focused on.
156*/
157
158/*!
159 \fn QCameraFocusControl::focusZonesChanged()
160
161 Signal is emitted when the set of zones, camera focused on is changed.
162
163 Usually the zones list is changed when the camera is focused.
164
165 \sa QCameraFocusControl::focusZones()
166*/
167
168/*!
169 \fn void QCameraFocusControl::focusModeChanged(QCameraFocus::FocusModes mode)
170
171 Signal is emitted when the focus \a mode is changed,
172 usually in result of QCameraFocusControl::setFocusMode call or capture mode changes.
173
174 \sa QCameraFocusControl::focusMode(), QCameraFocusControl::setFocusMode()
175*/
176
177/*!
178 \fn void QCameraFocusControl::focusPointModeChanged(QCameraFocus::FocusPointMode mode)
179
180 Signal is emitted when the focus point \a mode is changed,
181 usually in result of QCameraFocusControl::setFocusPointMode call or capture mode changes.
182
183 \sa QCameraFocusControl::focusPointMode(), QCameraFocusControl::setFocusPointMode()
184*/
185
186/*!
187 \fn void QCameraFocusControl::customFocusPointChanged(const QPointF &point)
188
189 Signal is emitted when the custom focus \a point is changed.
190
191 \sa QCameraFocusControl::customFocusPoint(), QCameraFocusControl::setCustomFocusPoint()
192*/
193
194
195
196QT_END_NAMESPACE
197
198#include "moc_qcamerafocuscontrol.cpp"
199

source code of qtmultimedia/src/multimedia/controls/qcamerafocuscontrol.cpp