The VideoWidget class provides a widget that is used to display video. 更多...
继承 QWidget and AbstractVideoOutput .
The VideoWidget class provides a widget that is used to display video.
The VideoWidget class renders the video of a media stream on a QWidget . It is connected to the MediaObject , of which video stream it should render. You connect the two objects using the Phonon.createPath () 函数。
The widget has some possibilities to manipulate the video stream. You can change the brightness (), hue (), saturation ()，和 contrast ().
Resizing of the video is handled automatically, but you can affect the way the video is resized with the aspectRatio and scaleMode properties. By default, the widget will use the aspect ratio of the video stream itself.
The video widget takes the size of the video when it receives a new video stream (i.e., when a new MediaSource is set on the MediaObject to which it is connected). If you need to know the size of the video, you can call sizeHint() after the video has been loaded (i.e., after the MediaObject leaves the LoadingState ).
It is also possible to go to full screen 模式。
A typical example of usage follows below:
MediaObject *media = new MediaObject(parent); VideoWidget *vwidget = new VideoWidget(parent); Phonon.createPath(media, vwidget);
Defines the width:height to be used for the video.
| 常量 | 值 | 描述 |
|---|---|---|
| Phonon.VideoWidget.AspectRatioAuto | 0 | Let the decoder find the aspect ratio automatically from the media file (this is the default). |
| Phonon.VideoWidget.AspectRatioWidget | 1 | Fits the video into the widget making the aspect ratio depend solely on the size of the widget. This way the aspect ratio is freely resizeable by the user. |
| Phonon.VideoWidget.AspectRatio4_3 | 2 | Make width/height == 4/3, which is the old TV size and monitor size (1024/768 == 4/3). (4:3) |
| Phonon.VideoWidget.AspectRatio16_9 | 3 | Make width/height == 16/9, which is the size of most current media. (16:9) |
The ScaleMode enum describes how to treat aspect ratio during resizing of video.
| 常量 | 值 | 描述 |
|---|---|---|
| Phonon.VideoWidget.FitInView | 0 | The video will be fitted to fill the view keeping aspect ratio. |
| Phonon.VideoWidget.ScaleAndCrop | 1 | The video is scaled |
parent argument, if not None, causes self to be owned by Qt instead of PyQt.
Constructs a new video widget with the specified parent .
This method is also a Qt slot with the C++ signature void enterFullScreen() .
Convenience slot, calling setFullScreen(true)
重实现自 QObject.event ().
This method is also a Qt slot with the C++ signature void exitFullScreen() .
Convenience slot, calling setFullScreen(false)
重实现自 QWidget.mouseMoveEvent ().
This method is also a Qt slot with the C++ signature void setAspectRatio(Phonon::VideoWidget::AspectRatio) .
This method is also a Qt slot with the C++ signature void setBrightness(qreal) .
This method is also a Qt slot with the C++ signature void setContrast(qreal) .
This method is also a Qt slot with the C++ signature void setFullScreen(bool) .
This method is also a Qt slot with the C++ signature void setHue(qreal) .
This method is also a Qt slot with the C++ signature void setSaturation(qreal) .
This method is also a Qt slot with the C++ signature void setScaleMode(Phonon::VideoWidget::ScaleMode) .
Returns a snapshot of the current frame shown in the widget.
该函数在 Qt 4.7 引入。
