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
Inherited By:

QCameraViewfinder

Properties

  • 59 properties inherited from QWidget
  • 1 property inherited from QObject

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

Reimplemented Public Functions

virtual QSize sizeHint() const
  • 213 public functions inherited from QWidget
  • 31 public functions inherited from QObject

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)
  • 19 public slots inherited from QWidget
  • 1 public slot inherited from QObject

Signals

void brightnessChanged(int brightness)
void contrastChanged(int contrast)
void fullScreenChanged(bool fullScreen)
void hueChanged(int hue)
void saturationChanged(int saturation)

Reimplemented Protected Functions

virtual bool event(QEvent * event)
virtual void hideEvent(QHideEvent * event)
virtual void moveEvent(QMoveEvent * event)
virtual void paintEvent(QPaintEvent * event)
virtual void resizeEvent(QResizeEvent * event)
virtual void showEvent(QShowEvent * event)
  • 35 protected functions inherited from QWidget
  • 9 protected functions inherited from QObject

Additional Inherited Members

  • 1 public variable inherited from QObject
  • 5 static public members inherited from QWidget
  • 10 static public members inherited from QObject
  • 35 protected functions inherited from QWidget
  • 9 protected functions inherited from QObject
  • 1 protected slot inherited from QWidget
  • 2 protected variables inherited from QObject

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.

[virtual protected] bool QVideoWidget::event(QEvent * event)

Reimplemented from QObject::event().

Current event event. Returns the value of the baseclass QWidget::event(QEvent *event) function.

[virtual protected] void QVideoWidget::hideEvent(QHideEvent * event)

Reimplemented from QWidget::hideEvent().

Handles the hide event.

[virtual protected] void QVideoWidget::moveEvent(QMoveEvent * event)

Reimplemented from QWidget::moveEvent().

Handles the move event.

[virtual protected] void QVideoWidget::paintEvent(QPaintEvent * event)

Reimplemented from QWidget::paintEvent().

Handles the paint event.

[virtual protected] void QVideoWidget::resizeEvent(QResizeEvent * event)

Reimplemented from QWidget::resizeEvent().

Handles the resize event.

[virtual protected] void QVideoWidget::showEvent(QShowEvent * event)

Reimplemented from QWidget::showEvent().

Handles the show event.

[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.