QVideoWidget Class
The QVideoWidget class provides a widget which presents video produced by a media object. More...
Header: | #include <QVideoWidget> |
qmake: | QT += multimediawidgets |
Inherits: | QWidget and QMediaBindableInterface |
Inherited By: |
Properties
|
|
Public Functions
QVideoWidget(QWidget *parent = nullptr) | |
virtual | ~QVideoWidget() |
Qt::AspectRatioMode | aspectRatioMode() const |
int | brightness() const |
int | contrast() const |
int | hue() const |
bool | isFullScreen() const |
int | saturation() const |
Reimplemented Public Functions
virtual QMediaObject * | mediaObject() const override |
virtual QSize | sizeHint() const override |
- 216 public functions inherited from QWidget
- 1 public function inherited from QMediaBindableInterface
- 31 public functions inherited from QObject
- 14 public functions inherited from QPaintDevice
Public Slots
void | setAspectRatioMode(Qt::AspectRatioMode mode) |
void | setBrightness(int brightness) |
void | setContrast(int contrast) |
void | setFullScreen(bool fullScreen) |
void | setHue(int hue) |
void | setSaturation(int saturation) |
Signals
void | brightnessChanged(int brightness) |
void | contrastChanged(int contrast) |
void | fullScreenChanged(bool fullScreen) |
void | hueChanged(int hue) |
void | saturationChanged(int saturation) |
Static Public Members
const QMetaObject | staticMetaObject |
Reimplemented Protected Functions
virtual bool | event(QEvent *event) override |
virtual void | hideEvent(QHideEvent *event) override |
virtual void | moveEvent(QMoveEvent *event) override |
virtual void | paintEvent(QPaintEvent *event) override |
virtual void | resizeEvent(QResizeEvent *event) override |
virtual void | showEvent(QShowEvent *event) override |
- 35 protected functions inherited from QWidget
- 1 protected function inherited from QMediaBindableInterface
- 9 protected functions inherited from QObject
- 1 protected function inherited from QPaintDevice
Protected Variables
QVideoWidgetPrivate * | d_ptr |
Additional Inherited Members
- 35 protected functions inherited from QWidget
- 1 protected function inherited from QMediaBindableInterface
- 9 protected functions inherited from QObject
- 1 protected function inherited from QPaintDevice
- 1 protected slot inherited from QWidget
Detailed Description
The QVideoWidget class provides a widget which presents video produced by a media object.
Attaching a QVideoWidget to a QMediaObject allows it to display the video or image output of that media object. A QVideoWidget is attached to media object by passing a pointer to the QMediaObject in its constructor, and detached by destroying the QVideoWidget.
player = new QMediaPlayer; playlist = new QMediaPlaylist(player); playlist->addMedia(QUrl("http://example.com/myclip1.mp4")); playlist->addMedia(QUrl("http://example.com/myclip2.mp4")); videoWidget = new QVideoWidget; player->setVideoOutput(videoWidget); videoWidget->show(); playlist->setCurrentIndex(1); player->play();
Note: Only a single display output can be attached to a media object at one time.
See also QMediaObject, QMediaPlayer, and QGraphicsVideoItem.
Property Documentation
aspectRatioMode : Qt::AspectRatioMode
how video is scaled with respect to its aspect ratio.
Access functions:
Qt::AspectRatioMode | aspectRatioMode() const |
void | setAspectRatioMode(Qt::AspectRatioMode mode) |
brightness : int
This property holds an adjustment to the brightness of displayed video.
Valid brightness values range between -100 and 100, the default is 0.
Access functions:
int | brightness() const |
void | setBrightness(int brightness) |
Notifier signal:
void | brightnessChanged(int brightness) |
contrast : int
This property holds an adjustment to the contrast of displayed video.
Valid contrast values range between -100 and 100, the default is 0.
Access functions:
int | contrast() const |
void | setContrast(int contrast) |
Notifier signal:
void | contrastChanged(int contrast) |
fullScreen : bool
This property holds whether video display is confined to a window or is fullScreen.
Access functions:
bool | isFullScreen() const |
void | setFullScreen(bool fullScreen) |
Notifier signal:
void | fullScreenChanged(bool fullScreen) |
hue : int
This property holds an adjustment to the hue of displayed video.
Valid hue values range between -100 and 100, the default is 0.
Access functions:
int | hue() const |
void | setHue(int hue) |
Notifier signal:
void | hueChanged(int hue) |
mediaObject : QMediaObject* const
This property holds the media object which provides the video displayed by a widget.
Access functions:
virtual QMediaObject * | mediaObject() const override |
saturation : int
This property holds an adjustment to the saturation of displayed video.
Valid saturation values range between -100 and 100, the default is 0.
Access functions:
int | saturation() const |
void | setSaturation(int saturation) |
Notifier signal:
void | saturationChanged(int saturation) |
Member Function Documentation
QVideoWidget::QVideoWidget(QWidget *parent = nullptr)
Constructs a new video widget.
The parent is passed to QWidget.
[virtual]
QVideoWidget::~QVideoWidget()
Destroys a video widget.
[signal]
void QVideoWidget::brightnessChanged(int brightness)
Signals that a video widgets's brightness adjustment has changed.
Note: Notifier signal for property brightness.
See also brightness().
[signal]
void QVideoWidget::contrastChanged(int contrast)
Signals that a video widgets's contrast adjustment has changed.
Note: Notifier signal for property contrast.
See also contrast().
[override virtual protected]
bool QVideoWidget::event(QEvent *event)
Reimplemented from QWidget::event().
Current event event. Returns the value of the baseclass QWidget::event(QEvent *event) function.
[signal]
void QVideoWidget::fullScreenChanged(bool fullScreen)
Signals that the fullScreen mode of a video widget has changed.
Note: Notifier signal for property fullScreen.
See also isFullScreen().
[override virtual protected]
void QVideoWidget::hideEvent(QHideEvent *event)
Reimplemented from QWidget::hideEvent().
Handles the hide event.
[signal]
void QVideoWidget::hueChanged(int hue)
Signals that a video widgets's hue has changed.
Note: Notifier signal for property hue.
See also hue().
[override virtual protected]
void QVideoWidget::moveEvent(QMoveEvent *event)
Reimplemented from QWidget::moveEvent().
Handles the move event.
[override virtual protected]
void QVideoWidget::paintEvent(QPaintEvent *event)
Reimplemented from QWidget::paintEvent().
Handles the paint event.
[override virtual protected]
void QVideoWidget::resizeEvent(QResizeEvent *event)
Reimplemented from QWidget::resizeEvent().
Handles the resize event.
[signal]
void QVideoWidget::saturationChanged(int saturation)
Signals that a video widgets's saturation has changed.
Note: Notifier signal for property saturation.
See also saturation().
[override virtual protected]
void QVideoWidget::showEvent(QShowEvent *event)
Reimplemented from QWidget::showEvent().
Handles the show event.
[override virtual]
QSize QVideoWidget::sizeHint() const
Reimplemented from QWidget::sizeHint().
Returns the size hint for the current back end, if there is one, or else the size hint from QWidget.
© 2021 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.