MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QVideoWidget Class Reference

The QVideoWidget class provides a widget which presents video produced by a media object. More...

 #include <QVideoWidget>

Inherits: QWidget and QMediaBindableInterface.

Inherited by: QCameraViewfinder.

This class was introduced in Qt Mobility 1.0.

Properties

  • 58 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
int saturation () const

Reimplemented Public Functions

virtual QMediaObject * mediaObject () const
virtual 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 )
  • 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 )

Additional Inherited Members

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;

 videoWidget = new QVideoWidget;

 player->setVideoOutput(videoWidget);
 player->setMedia(QUrl("http://example.com/movie.mp4"));

 videoWidget->show();
 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.

This property was introduced in Qt Mobility 1.0.

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.

This property was introduced in Qt Mobility 1.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.

This property was introduced in Qt Mobility 1.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.

This property was introduced in Qt Mobility 1.0.

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.

This property was introduced in Qt Mobility 1.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.

This property was introduced in Qt Mobility 1.0.

Access functions:

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

This property was introduced in Qt Mobility 1.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.

void QVideoWidget::brightnessChanged ( int brightness ) [signal]

Signals that a video widgets's brightness adjustment has changed.

This function was introduced in Qt Mobility 1.0.

See also brightness.

void QVideoWidget::contrastChanged ( int contrast ) [signal]

Signals that a video widgets's contrast adjustment has changed.

This function was introduced in Qt Mobility 1.0.

See also contrast.

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

Reimplemented from QObject::event().

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

This function was introduced in Qt Mobility 1.0.

void QVideoWidget::fullScreenChanged ( bool fullScreen ) [signal]

Signals that the fullScreen mode of a video widget has changed.

This function was introduced in Qt Mobility 1.0.

See also fullScreen.

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

Reimplemented from QWidget::hideEvent().

Handles the hide event.

This function was introduced in Qt Mobility 1.0.

void QVideoWidget::hueChanged ( int hue ) [signal]

Signals that a video widgets's hue has changed.

This function was introduced in Qt Mobility 1.0.

See also hue.

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

Reimplemented from QWidget::moveEvent().

Handles the move event.

This function was introduced in Qt Mobility 1.0.

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

Reimplemented from QWidget::paintEvent().

Handles the paint event.

This function was introduced in Qt Mobility 1.0.

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

Reimplemented from QWidget::resizeEvent().

Handles the resize event.

This function was introduced in Qt Mobility 1.0.

void QVideoWidget::saturationChanged ( int saturation ) [signal]

Signals that a video widgets's saturation has changed.

This function was introduced in Qt Mobility 1.0.

See also saturation.

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

Reimplemented from QWidget::showEvent().

Handles the show event.

This function was introduced in Qt Mobility 1.0.

QSize QVideoWidget::sizeHint () const [virtual]

Reimplemented from QWidget::sizeHint().

Returns the size hint for the current back end, if there is one, or else the size hint from QWidget.

This function was introduced in Qt Mobility 1.0.