Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

QMediaVideoControl Class Reference
[QtMediaModule]

The QMediaVideoControl class is an interface to videos playing through the Qt Extended Media System. More...

    #include <QMediaVideoControl>

Inherits QObject.

• List of all members, including inherited members

Public Functions

• QMediaVideoControl ( QMediaContent * mediaContent )
• ~QMediaVideoControl ()
• QWidget * createVideoWidget ( QWidget * parent = 0 ) const

• 29 public functions inherited from QObject

Public Slots

• void setVideoRotation ( QtopiaVideo::VideoRotation rotation )
• void setVideoScaleMode ( QtopiaVideo::VideoScaleMode scaleMode )

• 1 public slot inherited from QObject

Signals

• void invalid ()
• void valid ()
• void videoTargetAvailable ()
• void videoTargetRemoved ()

• 1 signal inherited from QObject

Static Public Members

• QString name ()

• 4 static public members inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 1 public type inherited from QObject
• 7 protected functions inherited from QObject
• 2 protected variables inherited from QObject

Detailed Description

The QMediaVideoControl class is an interface to videos playing through the Qt Extended Media System.

If a prepared media resource has associated video content, when that content is available to be played, this inteface can be used to contruct a QWidget which will contain the rendering of the video content.

Use the QMediaControlNotifier class to listen for when video content is available.

    QMediaControlNotifier *notifier = new QMediaControlNotifier( QMediaVideoControl::name() );
    connect( notifier, SIGNAL(valid()), this, SLOT(showVideo()) );

    QMediaContent *content = new QMediaContent( "video.3gp" );
    notifier->setMediaContent( content );

If video content is available createVideoWidget() can be used to construct a new video widget for the media content.

    QMediaVideoControl control( content );

    QWidget *video = control.createVideoWidget();
    videolayout->addWidget( video );

Simply delete video widgets when they are no longer needed or when the video control becomes invalid.

See also QMediaContent and QMediaControlNotifier.

Member Function Documentation

QMediaVideoControl::QMediaVideoControl ( QMediaContent * mediaContent )

Create a QMediaVideoControl with the handle to a prepared media resource

The QMediaControl needs to be constructed with mediaContent that represents the video to be played.

QMediaVideoControl::~QMediaVideoControl ()

Destroy a QMediaVideoControl

QWidget * QMediaVideoControl::createVideoWidget ( QWidget * parent = 0 ) const

Create a QWidget that displays the rendered video content.

This function is used to create a QWidget that will display the video content, it is parented to the widget passed in with the parent parameter. This widget can be deleted when the application is finished with it.

void QMediaVideoControl::invalid ()   [signal]

Signal that is emitted when the control is invalid and no longer available for use.

QString QMediaVideoControl::name ()   [static]

Return the name of this control.

void QMediaVideoControl::setVideoRotation ( QtopiaVideo::VideoRotation rotation )   [slot]

Set video image rotation mode.

See also QtopiaVideo::VideoRotation.

void QMediaVideoControl::setVideoScaleMode ( QtopiaVideo::VideoScaleMode scaleMode )   [slot]

Set the video using scaleMode to be scaled to fit the window size ( QtopiaVideo::FitWindow ) or stay unchanged ( QtopiaMedia::NoScale ).

See also QtopiaVideo::VideoScaleMode.

void QMediaVideoControl::valid ()   [signal]

Signal that is emitted when the control is valid and available for use.

void QMediaVideoControl::videoTargetAvailable ()   [signal]

This signal is emitted when there is a video available to be viewed. The client can call createVideoWidget() at this time.

See also createVideoWidget().

void QMediaVideoControl::videoTargetRemoved ()   [signal]

This signal is emitted when there is no longer video available to be viewed. The client should delete any QWidget obtained from createVideoWidget()

See also createVideoWidget().