#include <Phonon/VideoWidget>

Class Description

Widget to display video.

This widget shows the video signal.

MediaObject *media = new MediaObject(parent);
VideoWidget *vwidget = new VideoWidget(parent);
Phonon::createPath(media, vwidget);

Author: Matthias Kretz kretz.nosp@m.@kde.nosp@m..org

Definition at line 56 of file videowidget.h.

Inheritance diagram for VideoWidget:

Public Types
enum	AspectRatio { AspectRatioAuto = 0, AspectRatioWidget = 1, AspectRatio4_3 = 2, AspectRatio16_9 = 3 }
	Defines the width:height to be used for the video. More...

enum	ScaleMode { FitInView = 0, ScaleAndCrop = 1 }

Public Types inherited from QWidget
enum	RenderFlag { DrawWindowBackground = 0x1, DrawChildren = 0x2, IgnoreMask = 0x4 }

Public Types inherited from QPaintDevice
enum	PaintDeviceMetric { PdmWidth = 1, PdmHeight, PdmWidthMM, PdmHeightMM, PdmNumColors, PdmDepth, PdmDpiX, PdmDpiY, PdmPhysicalDpiX, PdmPhysicalDpiY }

Public Slots
void	setFullScreen (bool fullscreen)

void	exitFullScreen ()
	Convenience slot, calling setFullScreen(false) More...

void	enterFullScreen ()
	Convenience slot, calling setFullScreen(true) More...

void	setAspectRatio (AspectRatio)

void	setScaleMode (ScaleMode)

void	setBrightness (qreal value)

void	setContrast (qreal value)

void	setHue (qreal value)

void	setSaturation (qreal value)

Public Slots inherited from QWidget
void	setEnabled (bool)

void	setDisabled (bool)

void	setWindowModified (bool)

void	setWindowTitle (const QString &)

void	setStyleSheet (const QString &styleSheet)

void	setFocus ()

void	update ()

void	repaint ()

virtual void	setVisible (bool visible)

void	setHidden (bool hidden)

void	show ()

void	hide ()

QT_MOC_COMPAT void	setShown (bool shown)

void	showMinimized ()

void	showMaximized ()

void	showFullScreen ()

void	showNormal ()

bool	close ()

void	raise ()

void	lower ()

Public Slots inherited from QObject
void	deleteLater ()

Public Member Functions
	VideoWidget (QWidget *parent=0)
	Constructs a new video widget with a `parent`. More...

AspectRatio	aspectRatio () const

ScaleMode	scaleMode () const

qreal	brightness () const

qreal	contrast () const

qreal	hue () const

qreal	saturation () const

QImage	snapshot () const

Public Member Functions inherited from QWidget
	QWidget (QWidget *parent=0, Qt::WindowFlags f=0)

	~QWidget ()

int	devType () const

WId	winId () const

void	createWinId ()

WId	internalWinId () const

WId	effectiveWinId () const

QStyle *	style () const

void	setStyle (QStyle *)

bool	isTopLevel () const

bool	isWindow () const

bool	isModal () const

Qt::WindowModality	windowModality () const

void	setWindowModality (Qt::WindowModality windowModality)

bool	isEnabled () const

bool	isEnabledTo (QWidget *) const

bool	isEnabledToTLW () const

QRect	frameGeometry () const

const QRect &	geometry () const

QRect	normalGeometry () const

int	x () const

int	y () const

QPoint	pos () const

QSize	frameSize () const

QSize	size () const

int	width () const

int	height () const

QRect	rect () const

QRect	childrenRect () const

QRegion	childrenRegion () const

QSize	minimumSize () const

QSize	maximumSize () const

int	minimumWidth () const

int	minimumHeight () const

int	maximumWidth () const

int	maximumHeight () const

void	setMinimumSize (const QSize &)

void	setMinimumSize (int minw, int minh)

void	setMaximumSize (const QSize &)

void	setMaximumSize (int maxw, int maxh)

void	setMinimumWidth (int minw)

void	setMinimumHeight (int minh)

void	setMaximumWidth (int maxw)

void	setMaximumHeight (int maxh)

QSize	sizeIncrement () const

void	setSizeIncrement (const QSize &)

void	setSizeIncrement (int w, int h)

QSize	baseSize () const

void	setBaseSize (const QSize &)

void	setBaseSize (int basew, int baseh)

void	setFixedSize (const QSize &)

void	setFixedSize (int w, int h)

void	setFixedWidth (int w)

void	setFixedHeight (int h)

QPoint	mapToGlobal (const QPoint &) const

QPoint	mapFromGlobal (const QPoint &) const

QPoint	mapToParent (const QPoint &) const

QPoint	mapFromParent (const QPoint &) const

QPoint	mapTo (QWidget *, const QPoint &) const

QPoint	mapFrom (QWidget *, const QPoint &) const

QWidget *	window () const

QWidget *	nativeParentWidget () const

QWidget *	topLevelWidget () const

const QPalette &	palette () const

void	setPalette (const QPalette &)

void	setBackgroundRole (QPalette::ColorRole)

QPalette::ColorRole	backgroundRole () const

void	setForegroundRole (QPalette::ColorRole)

QPalette::ColorRole	foregroundRole () const

const QFont &	font () const

void	setFont (const QFont &)

QFontMetrics	fontMetrics () const

QFontInfo	fontInfo () const

QCursor	cursor () const

void	setCursor (const QCursor &)

void	unsetCursor ()

void	setMouseTracking (bool enable)

bool	hasMouseTracking () const

bool	underMouse () const

void	setMask (const QBitmap &)

void	setMask (const QRegion &)

QRegion	mask () const

void	clearMask ()

void	render (QPaintDevice *target, const QPoint &targetOffset=QPoint(), const QRegion &sourceRegion=QRegion(), RenderFlags renderFlags=RenderFlags(DrawWindowBackground\|DrawChildren))

void	render (QPainter *painter, const QPoint &targetOffset=QPoint(), const QRegion &sourceRegion=QRegion(), RenderFlags renderFlags=RenderFlags(DrawWindowBackground\|DrawChildren))

QGraphicsEffect *	graphicsEffect () const

void	setGraphicsEffect (QGraphicsEffect *effect)

void	grabGesture (Qt::GestureType type, Qt::GestureFlags flags=Qt::GestureFlags())

void	ungrabGesture (Qt::GestureType type)

QString	styleSheet () const

QString	windowTitle () const

void	setWindowIcon (const QIcon &icon)

QIcon	windowIcon () const

void	setWindowIconText (const QString &)

QString	windowIconText () const

void	setWindowRole (const QString &)

QString	windowRole () const

void	setWindowFilePath (const QString &filePath)

QString	windowFilePath () const

void	setWindowOpacity (qreal level)

qreal	windowOpacity () const

bool	isWindowModified () const

void	setToolTip (const QString &)

QString	toolTip () const

void	setStatusTip (const QString &)

QString	statusTip () const

void	setWhatsThis (const QString &)

QString	whatsThis () const

QString	accessibleName () const

void	setAccessibleName (const QString &name)

QString	accessibleDescription () const

void	setAccessibleDescription (const QString &description)

void	setLayoutDirection (Qt::LayoutDirection direction)

Qt::LayoutDirection	layoutDirection () const

void	unsetLayoutDirection ()

void	setLocale (const QLocale &locale)

QLocale	locale () const

void	unsetLocale ()

bool	isRightToLeft () const

bool	isLeftToRight () const

bool	isActiveWindow () const

void	activateWindow ()

void	clearFocus ()

void	setFocus (Qt::FocusReason reason)

Qt::FocusPolicy	focusPolicy () const

void	setFocusPolicy (Qt::FocusPolicy policy)

bool	hasFocus () const

void	setFocusProxy (QWidget *)

QWidget *	focusProxy () const

Qt::ContextMenuPolicy	contextMenuPolicy () const

void	setContextMenuPolicy (Qt::ContextMenuPolicy policy)

void	grabMouse ()

void	grabMouse (const QCursor &)

void	releaseMouse ()

void	grabKeyboard ()

void	releaseKeyboard ()

int	grabShortcut (const QKeySequence &key, Qt::ShortcutContext context=Qt::WindowShortcut)

void	releaseShortcut (int id)

void	setShortcutEnabled (int id, bool enable=true)

void	setShortcutAutoRepeat (int id, bool enable=true)

bool	updatesEnabled () const

void	setUpdatesEnabled (bool enable)

QGraphicsProxyWidget *	graphicsProxyWidget () const

void	update (int x, int y, int w, int h)

void	update (const QRect &)

void	update (const QRegion &)

void	repaint (int x, int y, int w, int h)

void	repaint (const QRect &)

void	repaint (const QRegion &)

void	stackUnder (QWidget *)

void	move (int x, int y)

void	move (const QPoint &)

void	resize (int w, int h)

void	resize (const QSize &)

void	setGeometry (int x, int y, int w, int h)

void	setGeometry (const QRect &)

QByteArray	saveGeometry () const

bool	restoreGeometry (const QByteArray &geometry)

void	adjustSize ()

bool	isVisible () const

bool	isVisibleTo (QWidget *) const

bool	isHidden () const

bool	isMinimized () const

bool	isMaximized () const

bool	isFullScreen () const

Qt::WindowStates	windowState () const

void	setWindowState (Qt::WindowStates state)

void	overrideWindowState (Qt::WindowStates state)

virtual QSize	sizeHint () const

virtual QSize	minimumSizeHint () const

QSizePolicy	sizePolicy () const

void	setSizePolicy (QSizePolicy)

void	setSizePolicy (QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical)

virtual int	heightForWidth (int) const

QRegion	visibleRegion () const

void	setContentsMargins (int left, int top, int right, int bottom)

void	setContentsMargins (const QMargins &margins)

void	getContentsMargins (int left, int top, int right, int bottom) const

QMargins	contentsMargins () const

QRect	contentsRect () const

QLayout *	layout () const

void	setLayout (QLayout *)

void	updateGeometry ()

void	setParent (QWidget *parent)

void	setParent (QWidget *parent, Qt::WindowFlags f)

void	scroll (int dx, int dy)

void	scroll (int dx, int dy, const QRect &)

QWidget *	focusWidget () const

QWidget *	nextInFocusChain () const

QWidget *	previousInFocusChain () const

bool	acceptDrops () const

void	setAcceptDrops (bool on)

void	addAction (QAction *action)

void	addActions (QList< QAction * > actions)

void	insertAction (QAction before, QAction action)

void	insertActions (QAction before, QList< QAction > actions)

void	removeAction (QAction *action)

QList< QAction * >	actions () const

QWidget *	parentWidget () const

void	setWindowFlags (Qt::WindowFlags type)

Qt::WindowFlags	windowFlags () const

void	overrideWindowFlags (Qt::WindowFlags type)

Qt::WindowType	windowType () const

QWidget *	childAt (int x, int y) const

QWidget *	childAt (const QPoint &p) const

const QX11Info &	x11Info () const

Qt::HANDLE	x11PictureHandle () const

Qt::HANDLE	handle () const

void	setAttribute (Qt::WidgetAttribute, bool on=true)

bool	testAttribute (Qt::WidgetAttribute) const

QPaintEngine *	paintEngine () const

void	ensurePolished () const

QInputContext *	inputContext ()

void	setInputContext (QInputContext *)

bool	isAncestorOf (const QWidget *child) const

bool	autoFillBackground () const

void	setAutoFillBackground (bool enabled)

void	setWindowSurface (QWindowSurface *surface)

QWindowSurface *	windowSurface () const

virtual QVariant	inputMethodQuery (Qt::InputMethodQuery) const

Qt::InputMethodHints	inputMethodHints () const

void	setInputMethodHints (Qt::InputMethodHints hints)

Public Member Functions inherited from QObject
Q_INVOKABLE	QObject (QObject *parent=0)

virtual	~QObject ()

virtual bool	eventFilter (QObject , QEvent )

QString	objectName () const

void	setObjectName (const QString &name)

bool	isWidgetType () const

bool	signalsBlocked () const

bool	blockSignals (bool b)

QThread *	thread () const

void	moveToThread (QThread *thread)

int	startTimer (int interval)

void	killTimer (int id)

template<typename T >
T	findChild (const QString &aName=QString()) const

template<typename T >
QList< T >	findChildren (const QString &aName=QString()) const

template<typename T >
QList< T >	findChildren (const QRegExp &re) const

const QObjectList &	children () const

void	setParent (QObject *)

void	installEventFilter (QObject *)

void	removeEventFilter (QObject *)

bool	connect (const QObject sender, const char signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const

bool	disconnect (const char signal=0, const QObject receiver=0, const char *member=0)

bool	disconnect (const QObject receiver, const char member=0)

void	dumpObjectTree ()

void	dumpObjectInfo ()

bool	setProperty (const char *name, const QVariant &value)

QVariant	property (const char *name) const

QList< QByteArray >	dynamicPropertyNames () const

void	setUserData (uint id, QObjectUserData *data)

QObjectUserData *	userData (uint id) const

QObject *	parent () const

bool	inherits (const char *classname) const

Public Member Functions inherited from QPaintDevice
virtual	~QPaintDevice ()

bool	paintingActive () const

int	width () const

int	height () const

int	widthMM () const

int	heightMM () const

int	logicalDpiX () const

int	logicalDpiY () const

int	physicalDpiX () const

int	physicalDpiY () const

int	colorCount () const

int	depth () const

Public Member Functions inherited from MediaNode
virtual	~MediaNode ()

bool	isValid () const
	Tells whether the backend provides an implementation of this class. More...

QList< Path >	inputPaths () const

QList< Path >	outputPaths () const

Protected Member Functions
	VideoWidget (VideoWidgetPrivate &d, QWidget *parent)

void	mouseMoveEvent (QMouseEvent *)

bool	event (QEvent *)

Protected Member Functions inherited from QWidget
bool	event (QEvent *)

virtual void	mousePressEvent (QMouseEvent *)

virtual void	mouseReleaseEvent (QMouseEvent *)

virtual void	mouseDoubleClickEvent (QMouseEvent *)

virtual void	wheelEvent (QWheelEvent *)

virtual void	keyPressEvent (QKeyEvent *)

virtual void	keyReleaseEvent (QKeyEvent *)

virtual void	focusInEvent (QFocusEvent *)

virtual void	focusOutEvent (QFocusEvent *)

virtual void	enterEvent (QEvent *)

virtual void	leaveEvent (QEvent *)

virtual void	paintEvent (QPaintEvent *)

virtual void	moveEvent (QMoveEvent *)

virtual void	resizeEvent (QResizeEvent *)

virtual void	closeEvent (QCloseEvent *)

virtual void	contextMenuEvent (QContextMenuEvent *)

virtual void	tabletEvent (QTabletEvent *)

virtual void	actionEvent (QActionEvent *)

virtual void	dragEnterEvent (QDragEnterEvent *)

virtual void	dragMoveEvent (QDragMoveEvent *)

virtual void	dragLeaveEvent (QDragLeaveEvent *)

virtual void	dropEvent (QDropEvent *)

virtual void	showEvent (QShowEvent *)

virtual void	hideEvent (QHideEvent *)

virtual bool	x11Event (XEvent *)

virtual void	changeEvent (QEvent *)

int	metric (PaintDeviceMetric) const

virtual void	inputMethodEvent (QInputMethodEvent *)

void	resetInputContext ()

void	create (WId=0, bool initializeWindow=true, bool destroyOldWindow=true)

void	destroy (bool destroyWindow=true, bool destroySubWindows=true)

virtual bool	focusNextPrevChild (bool next)

bool	focusNextChild ()

bool	focusPreviousChild ()

	QWidget (QWidgetPrivate &d, QWidget *parent, Qt::WindowFlags f)

virtual void	styleChange (QStyle &)

virtual void	enabledChange (bool)

virtual void	paletteChange (const QPalette &)

virtual void	fontChange (const QFont &)

virtual void	windowActivationChange (bool)

virtual void	languageChange ()

Protected Member Functions inherited from QObject
QObject *	sender () const

int	senderSignalIndex () const

int	receivers (const char *signal) const

virtual void	timerEvent (QTimerEvent *)

virtual void	childEvent (QChildEvent *)

virtual void	customEvent (QEvent *)

virtual void	connectNotify (const char *signal)

virtual void	disconnectNotify (const char *signal)

	QObject (QObjectPrivate &dd, QObject *parent=0)

Protected Member Functions inherited from QPaintDevice
	QPaintDevice ()

Protected Member Functions inherited from AbstractVideoOutput
	AbstractVideoOutput (AbstractVideoOutputPrivate &d)

Protected Member Functions inherited from MediaNode
	MediaNode (MediaNodePrivate &dd)

Properties
bool	fullScreen
	This property holds whether the video is shown using the complete screen. More...

AspectRatio	aspectRatio
	Defaults to AspectRatioAuto. More...

ScaleMode	scaleMode
	If the size of the widget and the size of the video are not equal. More...

qreal	brightness
	This property holds brightness of the video. More...

qreal	contrast
	This property holds the contrast of the video. More...

qreal	hue
	This property holds the hue of the video. More...

qreal	saturation
	This property holds saturation of the video. More...

Properties inherited from QWidget
bool	modal

Qt::WindowModality	windowModality

bool	enabled

QRect	geometry

QRect	frameGeometry

QRect	normalGeometry

int	x

int	y

QPoint	pos

QSize	frameSize

QSize	size

int	width

int	height

QRect	rect

QRect	childrenRect

QRegion	childrenRegion

QSizePolicy	sizePolicy

QSize	minimumSize

QSize	maximumSize

int	minimumWidth

int	minimumHeight

int	maximumWidth

int	maximumHeight

QSize	sizeIncrement

QSize	baseSize

QPalette	palette

QFont	font

QCursor	cursor

bool	mouseTracking

bool	isActiveWindow

Qt::FocusPolicy	focusPolicy

bool	focus

Qt::ContextMenuPolicy	contextMenuPolicy

bool	updatesEnabled

bool	visible

bool	minimized

bool	maximized

bool	fullScreen

QSize	sizeHint

QSize	minimumSizeHint

bool	acceptDrops

QString	windowTitle

QIcon	windowIcon

QString	windowIconText

double	windowOpacity

bool	windowModified

QString	toolTip

QString	statusTip

QString	whatsThis

QString	accessibleName

QString	accessibleDescription

Qt::LayoutDirection	layoutDirection

bool	autoFillBackground

QString	styleSheet

QLocale	locale

QString	windowFilePath

Qt::InputMethodHints	inputMethodHints

Properties inherited from QObject
QString	objectName

Additional Inherited Members
Signals inherited from QWidget
void	customContextMenuRequested (const QPoint &pos)

Signals inherited from QObject
void	destroyed (QObject *=0)

Static Public Member Functions inherited from QWidget
static void	setTabOrder (QWidget , QWidget )

static QWidget *	mouseGrabber ()

static QWidget *	keyboardGrabber ()

static QWidget *	find (WId)

Static Public Member Functions inherited from QObject
static bool	connect (const QObject sender, const char signal, const QObject receiver, const char member, Qt::ConnectionType=Qt::AutoConnection)

static bool	connect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection)

static bool	disconnect (const QObject sender, const char signal, const QObject receiver, const char member)

static bool	disconnect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &member)

static uint	registerUserData ()

Protected Slots inherited from QWidget
void	updateMicroFocus ()

Protected Attributes inherited from QObject
QScopedPointer< QObjectData >	d_ptr

Protected Attributes inherited from QPaintDevice
ushort	painters

Protected Attributes inherited from MediaNode
MediaNodePrivate *const	k_ptr

Static Protected Attributes inherited from QObject
static const QMetaObject	staticQtMetaObject

Member Enumeration Documentation

enum AspectRatio

Defines the width:height to be used for the video.

Enumerator
AspectRatioAuto	Let the decoder find the aspect ratio automatically from the media file (this is the default).
AspectRatioWidget	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.
AspectRatio4_3	Make width/height == 4/3, which is the old TV size and monitor size (1024/768 == 4/3). (4:3)
AspectRatio16_9	Make width/height == 16/9, which is the size of most current media. (16:9)

Definition at line 127 of file videowidget.h.

             {
                 AspectRatioAuto = 0,
                 AspectRatioWidget = 1,
                 AspectRatio4_3 = 2,
                 AspectRatio16_9 = 3
 //X                 /**
 //X                  * Assume that every pixel of the video image needs to be displayed with the same
 //X                  * physical width and height. (1:1 image pixels, not imagewidth
 //X                  * = imageheight)
 //X                  */
 //X                 AspectRatioSquare = 4,
             };

enum ScaleMode

Enumerator
FitInView
ScaleAndCrop

Definition at line 158 of file videowidget.h.

                            {
                 FitInView = 0,
                 ScaleAndCrop = 1
             };

Constructor & Destructor Documentation

VideoWidget ( QWidget * parent = 0 )

Constructs a new video widget with a parent.

VideoWidget	(	VideoWidgetPrivate &	d,
		QWidget *	parent
	)

protected

Constructs a new video widget with private data pointer d and a parent.

Member Function Documentation

AspectRatio aspectRatio ( ) const

ScaleMode scaleMode ( ) const

qreal brightness ( ) const

qreal contrast ( ) const

qreal hue ( ) const

qreal saturation ( ) const

QImage snapshot ( ) const

void setFullScreen ( bool fullscreen )

slot

void exitFullScreen ( )

slot

Convenience slot, calling setFullScreen(false)

void enterFullScreen ( )

slot

Convenience slot, calling setFullScreen(true)

void setAspectRatio ( AspectRatio )

slot

void setScaleMode ( ScaleMode )

slot

void setBrightness ( qreal value )

slot

void setContrast ( qreal value )

slot

void setHue ( qreal value )

slot

void setSaturation ( qreal value )

slot

void mouseMoveEvent ( QMouseEvent * )

protectedvirtual

Reimplemented from QWidget.

bool event ( QEvent * )

protectedvirtual

Reimplemented from QObject.

Property Documentation

bool fullScreen

readwrite

This property holds whether the video is shown using the complete screen.

The property differs from QWidget::fullScreen in that it is writeable.

By default the widget is not shown in fullScreen.

Warning: When switching the video to fullscreen using setFullScreen your application loses control over the widget that actually shows the video (which is then shown as a toplevel window while your application still uses this widget). If you only need to capture key events the event forwarding done internally should suffice for your needs. If you need to map mouse coordinates or add widgets (that are not overlays) you should probably handle fullscreen yourself.

Definition at line 78 of file videowidget.h.

AspectRatio aspectRatio

readwrite

Defaults to AspectRatioAuto.

See also: AspectRatio

Definition at line 85 of file videowidget.h.

ScaleMode scaleMode

readwrite

If the size of the widget and the size of the video are not equal.

The video will be zoomed to fit the widget. The smaller zoom (AddBarsScaleMode) adds black bars at the left/right or top/bottom to make all of the image visible (default). The bigger zoom (ExpandMode) fills the widget completely, keeping all information in one direction and leaving parts of the image outside of the widget in the other direction.

Definition at line 96 of file videowidget.h.

qreal brightness

readwrite

This property holds brightness of the video.

Default is 0. Acceptable values are in range of -1, 1.

Definition at line 103 of file videowidget.h.

qreal contrast

readwrite

This property holds the contrast of the video.

Default is 0. Acceptable values are in range of -1, 1.

Definition at line 109 of file videowidget.h.

qreal hue

readwrite

This property holds the hue of the video.

Default is 0. Acceptable values are in range of -1, 1.

Definition at line 115 of file videowidget.h.

qreal saturation

readwrite

This property holds saturation of the video.

Default is 0. Acceptable values are in range of -1, 1.

Definition at line 121 of file videowidget.h.

The documentation for this class was generated from the following file:

phonon/videowidget.h

VideoWidget Class Reference

Class Description

Public Types

Public Slots

Public Member Functions

Protected Member Functions

Properties

Additional Inherited Members

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Property Documentation