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 "qvideowidgetcontrol.h"
41#include "private/qmediacontrol_p.h"
42
43QT_BEGIN_NAMESPACE
44
45/*!
46 \class QVideoWidgetControl
47
48
49 \brief The QVideoWidgetControl class provides a media control which
50 implements a video widget.
51
52 \inmodule QtMultimediaWidgets
53 \ingroup multimedia-serv
54
55 The videoWidget() property of QVideoWidgetControl provides a pointer to a
56 video widget implemented by the control's media service. This widget is
57 owned by the media service and so care should be taken not to delete it.
58
59 \snippet multimedia-snippets/video.cpp Video widget control
60
61 QVideoWidgetControl is one of number of possible video output controls.
62
63 The interface name of QVideoWidgetControl is \c org.qt-project.qt.videowidgetcontrol/5.0 as
64 defined in QVideoWidgetControl_iid.
65
66 \sa QMediaService::requestControl(), QVideoWidget
67*/
68
69/*!
70 \macro QVideoWidgetControl_iid
71
72 \c org.qt-project.qt.videowidgetcontrol/5.0
73
74 Defines the interface name of the QVideoWidgetControl class.
75
76 \relates QVideoWidgetControl
77*/
78
79/*!
80 Constructs a new video widget control with the given \a parent.
81*/
82QVideoWidgetControl::QVideoWidgetControl(QObject *parent)
83 :QMediaControl(parent)
84{
85}
86
87/*!
88 Destroys a video widget control.
89*/
90QVideoWidgetControl::~QVideoWidgetControl()
91{
92}
93
94/*!
95 \fn QVideoWidgetControl::isFullScreen() const
96
97 Returns true if the video is shown using the complete screen.
98*/
99
100/*!
101 \fn QVideoWidgetControl::setFullScreen(bool fullScreen)
102
103 Sets whether a video widget is in \a fullScreen mode.
104*/
105
106/*!
107 \fn QVideoWidgetControl::fullScreenChanged(bool fullScreen)
108
109 Signals that the \a fullScreen state of a video widget has changed.
110*/
111
112/*!
113 \fn QVideoWidgetControl::aspectRatioMode() const
114
115 Returns how video is scaled to fit the widget with respect to its aspect ratio.
116*/
117
118/*!
119 \fn QVideoWidgetControl::setAspectRatioMode(Qt::AspectRatioMode mode)
120
121 Sets the aspect ratio \a mode which determines how video is scaled to the fit the widget with
122 respect to its aspect ratio.
123*/
124
125/*!
126 \fn QVideoWidgetControl::brightness() const
127
128 Returns the brightness adjustment applied to a video.
129
130 Valid brightness values range between -100 and 100, the default is 0.
131*/
132
133/*!
134 \fn QVideoWidgetControl::setBrightness(int brightness)
135
136 Sets a \a brightness adjustment for a video.
137
138 Valid brightness values range between -100 and 100, the default is 0.
139*/
140
141/*!
142 \fn QVideoWidgetControl::brightnessChanged(int brightness)
143
144 Signals that a video widget's \a brightness adjustment has changed.
145*/
146
147/*!
148 \fn QVideoWidgetControl::contrast() const
149
150 Returns the contrast adjustment applied to a video.
151
152 Valid contrast values range between -100 and 100, the default is 0.
153*/
154
155/*!
156 \fn QVideoWidgetControl::setContrast(int contrast)
157
158 Sets the contrast adjustment for a video widget to \a contrast.
159
160 Valid contrast values range between -100 and 100, the default is 0.
161*/
162
163
164/*!
165 \fn QVideoWidgetControl::contrastChanged(int contrast)
166
167 Signals that a video widget's \a contrast adjustment has changed.
168*/
169
170/*!
171 \fn QVideoWidgetControl::hue() const
172
173 Returns the hue adjustment applied to a video widget.
174
175 Value hue values range between -100 and 100, the default is 0.
176*/
177
178/*!
179 \fn QVideoWidgetControl::setHue(int hue)
180
181 Sets a \a hue adjustment for a video widget.
182
183 Valid hue values range between -100 and 100, the default is 0.
184*/
185
186
187/*!
188 \fn QVideoWidgetControl::hueChanged(int hue)
189
190 Signals that a video widget's \a hue adjustment has changed.
191*/
192
193/*!
194 \fn QVideoWidgetControl::saturation() const
195
196 Returns the saturation adjustment applied to a video widget.
197
198 Value saturation values range between -100 and 100, the default is 0.
199*/
200
201
202/*!
203 \fn QVideoWidgetControl::setSaturation(int saturation)
204
205 Sets a \a saturation adjustment for a video widget.
206
207 Valid saturation values range between -100 and 100, the default is 0.
208*/
209
210/*!
211 \fn QVideoWidgetControl::saturationChanged(int saturation)
212
213 Signals that a video widget's \a saturation adjustment has changed.
214*/
215
216/*!
217 \fn QVideoWidgetControl::videoWidget()
218
219 Returns the QWidget.
220*/
221
222QT_END_NAMESPACE
223
224#include "moc_qvideowidgetcontrol.cpp"
225

source code of qtmultimedia/src/multimediawidgets/qvideowidgetcontrol.cpp