Home · All Classes · Grouped Classes · Annotated · Functions

QMediaVideoControlServer Class Reference

The QMediaVideoControlServer class is used by Media Engines to inform clients that video is available for the associated media session. More...

    #include <QMediaVideoControlServer>

This class is under development and is subject to change.

Inherits QMediaAbstractControlServer.

Public Functions

Signals

Additional Inherited Members


Detailed Description

The QMediaVideoControlServer class is used by Media Engines to inform clients that video is available for the associated media session.

A Media Engine using the QtopiaMedia API constructs a QMediaVideoControlServer when it would like to inform and enable a client to access a QWidget based video widget in the server.

    {
        VideoWidget* videoWidget = new VideoWidget(videoSource, parent);

        QMediaVideoControlServer* videoControlServer = new QMediaVideoControlServer(id, parent);

        videoControlServer->setRenderTarget(videoWidget);
    }

See also QMediaVideoControl and QMediaAbstractControlServer.


Member Function Documentation

QMediaVideoControlServer::QMediaVideoControlServer ( QMediaHandle const & handle, QWidget * target = 0, QObject * parent = 0 )

Constructs a QMediaVideoControlServer with the session handle, and optionally the video target widget for sharing with the client and the parent QObject.

QMediaVideoControlServer::~QMediaVideoControlServer ()

Destroy the QMediaVideoControlServer object.

void QMediaVideoControlServer::setRenderTarget ( QWidget * renderTarget )

Set the video target widget to renderTarget.

The Media Engine calls this function when it has a widget that it would like to make available to a client application.

The QWidget will exist in the Media Server process, but will be made available to the session client. A session client will be able to control different widget states, for example whether the widget is hidden or visible.

void QMediaVideoControlServer::setRenderTarget ( int wid )

This is an overloaded member function, provided for convenience.

Set the video target to the window with wid.

The Media Engine calls this function when it has a widget that it would like to make available to a client application.

The QWidget will exist in the Media Server process, but will be made available to the session client. A session client will be able to control different widget states, for example whether the widget is hidden or visible.

void QMediaVideoControlServer::unsetRenderTarget ()

Remove the video target widget.

The Media Engine should call this function when it will no longer be rendering video into the QWidget set in setRenderTarget(). The Session client will be notified that the widget is no longer valid.

void QMediaVideoControlServer::videoTargetAvailable ()   [signal]

This signal is emitted when a render target has been set. It will indicate to the client QMediaVideoControl class, that a video widget is available to be displayed.

void QMediaVideoControlServer::videoTargetRemoved ()   [signal]

This signal is emitted when a render target has been removed. It will indicate to the client QMediaVideoControl class, that the Media Engine is no longer rendering video for this session.


Copyright © 2008 Nokia Trademarks
Qtopia 4.3.3