QVideoWidget Class
The QVideoWidget class provides a widget which presents video produced by a media object. More...
| Header: | #include <QVideoWidget> |
| qmake: | QT += multimediawidgets |
| Inherited By: |
Properties
|
|
Public Functions
| QVideoWidget(QWidget * parent = 0) | |
| ~QVideoWidget() | |
| Qt::AspectRatioMode | aspectRatioMode() const |
| int | brightness() const |
| int | contrast() const |
| int | hue() const |
| bool | isFullScreen() const |
| QMediaObject * | mediaObject() const |
| int | saturation() const |
| QSize | sizeHint() const |
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) |
Protected Functions
| bool | event(QEvent * event) |
| void | hideEvent(QHideEvent * event) |
| void | moveEvent(QMoveEvent * event) |
| void | paintEvent(QPaintEvent * event) |
| void | resizeEvent(QResizeEvent * event) |
| void | showEvent(QShowEvent * event) |
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
This property holds 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:
| QMediaObject * | mediaObject() const |
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 = 0)
Constructs a new video widget.
The parent is passed to QWidget.
QVideoWidget::~QVideoWidget()
Destroys a video widget.
bool QVideoWidget::event(QEvent * event) [protected]
Current event event. Returns the value of the baseclass QWidget::event(QEvent *event) function.
void QVideoWidget::hideEvent(QHideEvent * event) [protected]
Handles the hide event.
void QVideoWidget::moveEvent(QMoveEvent * event) [protected]
Handles the move event.
void QVideoWidget::paintEvent(QPaintEvent * event) [protected]
Handles the paint event.
void QVideoWidget::resizeEvent(QResizeEvent * event) [protected]
Handles the resize event.
void QVideoWidget::showEvent(QShowEvent * event) [protected]
Handles the show event.
QSize QVideoWidget::sizeHint() const
Returns the size hint for the current back end, if there is one, or else the size hint from QWidget.