MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

Contents

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.

© 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide.

All other trademarks are property of their respective owners. Privacy Policy


Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia.

Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.