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
|
/* This file is part of the KDE project
Copyright (C) 2005-2007 Matthias Kretz <kretz@kde.org>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) version 3, or any
later version accepted by the membership of KDE e.V. (or its
successor approved by the membership of KDE e.V.), Nokia Corporation
(or its successors, if any) and the KDE Free Qt Foundation, which shall
act as a proxy defined in Section 6 of version 3 of the license.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef Phonon_VIDEOWIDGET_H
#define Phonon_VIDEOWIDGET_H
#include "phonon_export.h"
#include "phonondefs.h"
#include "abstractvideooutput.h"
#include <QtWidgets/QWidget>
QT_BEGIN_HEADER
QT_BEGIN_NAMESPACE
class QString;
#ifndef QT_NO_PHONON_VIDEO
namespace Phonon
{
class AbstractVideoOutput;
class VideoWidgetPrivate;
/** \class VideoWidget videowidget.h Phonon/VideoWidget
* \short Widget to display video.
*
* This widget shows the video signal.
*
* \code
* MediaObject *media = new MediaObject(parent);
* VideoWidget *vwidget = new VideoWidget(parent);
* Phonon::createPath(media, vwidget);
* \endcode
*
* \ingroup PhononVideo
* \ingroup PhononWidgets
* \author Matthias Kretz <kretz@kde.org>
*/
class PHONON_EXPORT VideoWidget : public QWidget, public Phonon::AbstractVideoOutput
{
K_DECLARE_PRIVATE(VideoWidget)
Q_OBJECT
Q_ENUMS(AspectRatio ScaleMode)
/**
* This property holds whether the video is shown using the complete
* screen.
*
* The property differs from QWidget::fullScreen in that it is
* writeable.
*
* By default the widget is not shown in fullScreen.
*
* \warning When switching the video to fullscreen using setFullScreen
* your application loses control over the widget that actually shows
* the video (which is then shown as a toplevel window while your
* application still uses this widget). If you only need to capture key
* events the event forwarding done internally should suffice for your
* needs. If you need to map mouse coordinates or add widgets (that are
* not overlays) you should probably handle fullscreen yourself.
*/
Q_PROPERTY(bool fullScreen READ isFullScreen WRITE setFullScreen)
/**
*
* Defaults to AspectRatioAuto.
*
* \see AspectRatio
*/
Q_PROPERTY(AspectRatio aspectRatio READ aspectRatio WRITE setAspectRatio)
/**
* If the size of the widget and the size of the video are not equal.
* The video will be zoomed to fit the widget. The smaller zoom
* (AddBarsScaleMode) adds black bars at the left/right or top/bottom to
* make all of the image visible (default). The bigger zoom (ExpandMode)
* fills the widget completely, keeping all information in one direction
* and leaving parts of the image outside of the widget in the other
* direction.
*/
Q_PROPERTY(ScaleMode scaleMode READ scaleMode WRITE setScaleMode)
/**
* This property holds brightness of the video.
*
* Default is 0. Acceptable values are in range of -1, 1.
*/
Q_PROPERTY(qreal brightness READ brightness WRITE setBrightness)
/**
* This property holds the contrast of the video.
*
* Default is 0. Acceptable values are in range of -1, 1.
*/
Q_PROPERTY(qreal contrast READ contrast WRITE setContrast)
/**
* This property holds the hue of the video.
*
* Default is 0. Acceptable values are in range of -1, 1.
*/
Q_PROPERTY(qreal hue READ hue WRITE setHue)
/**
* This property holds saturation of the video.
*
* Default is 0. Acceptable values are in range of -1, 1.
*/
Q_PROPERTY(qreal saturation READ saturation WRITE setSaturation)
public:
/**
* Defines the width:height to be used for the video.
*/
enum AspectRatio
{
/**
* Let the decoder find the aspect ratio automatically from the
* media file (this is the default).
*/
AspectRatioAuto = 0,
/**
* Fits the video into the widget making the aspect ratio depend
* solely on the size of the widget. This way the aspect ratio
* is freely resizeable by the user.
*/
AspectRatioWidget = 1,
/**
* Make width/height == 4/3, which is the old TV size and
* monitor size (1024/768 == 4/3). (4:3)
*/
AspectRatio4_3 = 2,
/**
* Make width/height == 16/9, which is the size of most current
* media. (16:9)
*/
AspectRatio16_9 = 3
//X /**
//X * Assume that every pixel of the video image needs to be displayed with the same
//X * physical width and height. (1:1 image pixels, not imagewidth
//X * = imageheight)
//X */
//X AspectRatioSquare = 4,
};
enum ScaleMode {
FitInView = 0,
ScaleAndCrop = 1
};
/**
* Constructs a new video widget with a \p parent.
*/
VideoWidget(QWidget *parent = 0);
AspectRatio aspectRatio() const;
ScaleMode scaleMode() const;
qreal brightness() const;
qreal contrast() const;
qreal hue() const;
qreal saturation() const;
QImage snapshot() const;
//TODO: bar colors property
public Q_SLOTS:
void setFullScreen(bool fullscreen);
/**
* Convenience slot, calling setFullScreen(false)
*/
void exitFullScreen();
/**
* Convenience slot, calling setFullScreen(true)
*/
void enterFullScreen();
void setAspectRatio(AspectRatio);
void setScaleMode(ScaleMode);
void setBrightness(qreal value);
void setContrast(qreal value);
void setHue(qreal value);
void setSaturation(qreal value);
protected:
/**
* \internal
*
* Constructs a new video widget with private data pointer \p d and
* a \p parent.
*/
VideoWidget(VideoWidgetPrivate &d, QWidget *parent);
void mouseMoveEvent(QMouseEvent *);
bool event(QEvent *);
};
} //namespace Phonon
#endif //QT_NO_PHONON_VIDEO
QT_END_NAMESPACE
QT_END_HEADER
// vim: sw=4 ts=4 tw=80
#endif // Phonon_VIDEOWIDGET_H
|
