QVideoWindowControl Class Reference

Detailed Description

The QVideoWindowControl class provides a media control for rendering video to a window.

The winId() property QVideoWindowControl allows a platform specific window ID to be set as the video render target of a QMediaService. The displayRect() property is used to set the region of the window the video should be rendered to, and the aspectRatioMode() property indicates how the video should be scaled to fit the displayRect().

    QVideoWindowControl *windowControl = mediaService->control<QVideoWindowControl *>();
    windowControl->setWinId(widget->winId());
    windowControl->setDisplayRect(widget->rect());
    windowControl->setAspectRatioMode(QVideoWidget::KeepAspectRatio);

QVideoWindowControl is one of number of possible video output controls, in order to receive video it must be made the active video output control by setting the output property of QVideoOutputControl to WindowOutput. Consequently any QMediaService that implements QVideoWindowControl must also implement QVideoOutputControl.

    QVideoOutputControl *outputControl = mediaService->control<QVideoOutputControl *>();
    outputControl->setOutput(QVideoOutputControl::WindowOutput);

The interface name of QVideoWindowControl is com.nokia.Qt.QVideoWindowControl/1.0 as defined in QVideoWindowControl_iid.

See also QMediaService::control(), QVideoOutputControl, and QVideoWidget.

Member Function Documentation