Graphics item object which displays video produced by a QMediaObject. More...

Inheritance diagram for QGraphicsVideoItem:

Public Signals
void	nativeSizeChanged (const QSizeF &size)

Public Signals inherited from QGraphicsObject
void	enabledChanged ()

void	opacityChanged ()

void	parentChanged ()

void	rotationChanged ()

void	scaleChanged ()

void	visibleChanged ()

void	xChanged ()

void	yChanged ()

void	zChanged ()

Public Signals inherited from QObject
void	destroyed (QObject *obj=nullptr)

void	objectNameChanged (const QString &objectName)

Public Methods
	QGraphicsVideoItem (QGraphicsItem *parent=nullptr)

	~QGraphicsVideoItem ()

Qt::AspectRatioMode	aspectRatioMode () const

QRectF	boundingRect () const override

QMediaObject *	mediaObject () const override

QSizeF	nativeSize () const

QPointF	offset () const

void	paint (QPainter painter, const QStyleOptionGraphicsItem option, QWidget *widget=nullptr) override

void	setAspectRatioMode (Qt::AspectRatioMode mode)

void	setOffset (const QPointF &offset)

void	setSize (const QSizeF &size)

QSizeF	size () const

Public Methods inherited from QGraphicsObject
	QGraphicsObject (QGraphicsItem *parent=nullptr)

const QList< QObject * > &	children () const

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

void	ungrabGesture (Qt::GestureType gesture)

Public Methods inherited from QObject
	QObject (QObject *parent=nullptr)

	~QObject ()

bool	blockSignals (bool block)

const QList< QObject * > &	children () const

bool	connect (const QObject *sender, const QString &signalMethod, const QString &location, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection)

bool	connect (const QObject *sender, const QString &signalMethod, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection)

bool	disconnect (const QObject *receiver, const QString &slotMethod=QString ()) const

bool	disconnect (const QString &signalMethod, const QString &location, const QObject *receiver=nullptr, const QString &slotMethod=QString ()) const

bool	disconnect (const QString &signalMethod=QString (), const QObject *receiver=nullptr, const QString &slotMethod=QString ()) const

void	dumpObjectInfo ()

void	dumpObjectTree ()

QList< QString >	dynamicPropertyNames () const

virtual bool	event (QEvent *event)

virtual bool	eventFilter (QObject watched, QEvent event)

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

template<class T >
QList< T >	findChildren (const QRegularExpression &regExp, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const

template<class T >
QList< T >	findChildren (const QString &childName=QString (), Qt::FindChildOptions options=Qt::FindChildrenRecursively) const

bool	inherits (const QString &className) const

void	installEventFilter (QObject *filterObj)

bool	isWidgetType () const

bool	isWindowType () const

void	killTimer (int id)

const QMetaObject *	metaObject () const

void	moveToThread (QThread *targetThread)

QString	objectName () const

QObject *	parent () const

template<class T = QVariant>
T	property (const QString &name) const

void	removeEventFilter (QObject *obj)

void	setObjectName (const QString &name)

void	setParent (QObject *parent)

bool	setProperty (const QString &name, const QVariant &value)

bool	signalsBlocked () const

int	startTimer (int interval, Qt::TimerType timerType=Qt::CoarseTimer)

QThread *	thread () const

Public Methods inherited from QGraphicsItem
	QGraphicsItem (QGraphicsItem *parent=nullptr)

virtual	~QGraphicsItem ()

bool	acceptDrops () const

Qt::MouseButtons	acceptedMouseButtons () const

bool	acceptHoverEvents () const

bool	acceptTouchEvents () const

virtual void	advance (int phase)

virtual QRectF	boundingRect () const = 0

QRegion	boundingRegion (const QTransform &itemToDeviceTransform) const

qreal	boundingRegionGranularity () const

CacheMode	cacheMode () const

QList< QGraphicsItem * >	childItems () const

QRectF	childrenBoundingRect () const

void	clearFocus ()

QPainterPath	clipPath () const

virtual bool	collidesWithItem (const QGraphicsItem *graphicsItem, Qt::ItemSelectionMode mode=Qt::IntersectsItemShape) const

virtual bool	collidesWithPath (const QPainterPath &path, Qt::ItemSelectionMode mode=Qt::IntersectsItemShape) const

QList< QGraphicsItem * >	collidingItems (Qt::ItemSelectionMode mode=Qt::IntersectsItemShape) const

QGraphicsItem *	commonAncestorItem (const QGraphicsItem *graphicsItem) const

virtual bool	contains (const QPointF &point) const

QCursor	cursor () const

QVariant	data (int key) const

QTransform	deviceTransform (const QTransform &viewportTransform) const

qreal	effectiveOpacity () const

void	ensureVisible (const QRectF &rectF=QRectF (), int xmargin=50, int ymargin=50)

void	ensureVisible (qreal x, qreal y, qreal width, qreal height, int xmargin=50, int ymargin=50)

bool	filtersChildEvents () const

GraphicsItemFlags	flags () const

QGraphicsItem *	focusItem () const

QGraphicsItem *	focusProxy () const

void	grabKeyboard ()

void	grabMouse ()

QGraphicsEffect *	graphicsEffect () const

QGraphicsItemGroup *	group () const

bool	handlesChildEvents () const

bool	hasCursor () const

bool	hasFocus () const

void	hide ()

Qt::InputMethodHints	inputMethodHints () const

void	installSceneEventFilter (QGraphicsItem *filterItem)

bool	isActive () const

bool	isAncestorOf (const QGraphicsItem *graphicsItem) const

bool	isBlockedByModalPanel (QGraphicsItem **blockingPanel=nullptr) const

bool	isClipped () const

bool	isEnabled () const

bool	isObscured (const QRectF &rectF=QRectF ()) const

bool	isObscured (qreal x, qreal y, qreal width, qreal height) const

virtual bool	isObscuredBy (const QGraphicsItem *graphicsItem) const

bool	isPanel () const

bool	isSelected () const

bool	isUnderMouse () const

bool	isVisible () const

bool	isVisibleTo (const QGraphicsItem *graphicsItem) const

bool	isWidget () const

bool	isWindow () const

QTransform	itemTransform (const QGraphicsItem graphicsItem, bool ok=nullptr) const

QPainterPath	mapFromItem (const QGraphicsItem *graphicsItem, const QPainterPath &path) const

QPointF	mapFromItem (const QGraphicsItem *graphicsItem, const QPointF &point) const

QPolygonF	mapFromItem (const QGraphicsItem *graphicsItem, const QPolygonF &polygon) const

QPolygonF	mapFromItem (const QGraphicsItem *graphicsItem, const QRectF &rectF) const

QPointF	mapFromItem (const QGraphicsItem *graphicsItem, qreal x, qreal y) const

QPolygonF	mapFromItem (const QGraphicsItem *graphicsItem, qreal x, qreal y, qreal width, qreal height) const

QPainterPath	mapFromParent (const QPainterPath &path) const

QPointF	mapFromParent (const QPointF &point) const

QPolygonF	mapFromParent (const QPolygonF &polygon) const

QPolygonF	mapFromParent (const QRectF &rectF) const

QPointF	mapFromParent (qreal x, qreal y) const

QPolygonF	mapFromParent (qreal x, qreal y, qreal width, qreal height) const

QPainterPath	mapFromScene (const QPainterPath &path) const

QPointF	mapFromScene (const QPointF &point) const

QPolygonF	mapFromScene (const QPolygonF &polygon) const

QPolygonF	mapFromScene (const QRectF &rectF) const

QPointF	mapFromScene (qreal x, qreal y) const

QPolygonF	mapFromScene (qreal x, qreal y, qreal width, qreal height) const

QRectF	mapRectFromItem (const QGraphicsItem *graphicsItem, const QRectF &rectF) const

QRectF	mapRectFromItem (const QGraphicsItem *graphicsItem, qreal x, qreal y, qreal width, qreal height) const

QRectF	mapRectFromParent (const QRectF &rectF) const

QRectF	mapRectFromParent (qreal x, qreal y, qreal width, qreal height) const

QRectF	mapRectFromScene (const QRectF &rectF) const

QRectF	mapRectFromScene (qreal x, qreal y, qreal width, qreal height) const

QRectF	mapRectToItem (const QGraphicsItem *graphicsItem, const QRectF &rectF) const

QRectF	mapRectToItem (const QGraphicsItem *graphicsItem, qreal x, qreal y, qreal width, qreal height) const

QRectF	mapRectToParent (const QRectF &rectF) const

QRectF	mapRectToParent (qreal x, qreal y, qreal width, qreal height) const

QRectF	mapRectToScene (const QRectF &rectF) const

QRectF	mapRectToScene (qreal x, qreal y, qreal width, qreal height) const

QPainterPath	mapToItem (const QGraphicsItem *graphicsItem, const QPainterPath &path) const

QPointF	mapToItem (const QGraphicsItem *graphicsItem, const QPointF &point) const

QPolygonF	mapToItem (const QGraphicsItem *graphicsItem, const QPolygonF &polygon) const

QPolygonF	mapToItem (const QGraphicsItem *graphicsItem, const QRectF &rectF) const

QPointF	mapToItem (const QGraphicsItem *graphicsItem, qreal x, qreal y) const

QPolygonF	mapToItem (const QGraphicsItem *graphicsItem, qreal x, qreal y, qreal width, qreal height) const

QPainterPath	mapToParent (const QPainterPath &path) const

QPointF	mapToParent (const QPointF &point) const

QPolygonF	mapToParent (const QPolygonF &polygon) const

QPolygonF	mapToParent (const QRectF &rectF) const

QPointF	mapToParent (qreal x, qreal y) const

QPolygonF	mapToParent (qreal x, qreal y, qreal width, qreal height) const

QPainterPath	mapToScene (const QPainterPath &path) const

QPointF	mapToScene (const QPointF &point) const

QPolygonF	mapToScene (const QPolygonF &polygon) const

QPolygonF	mapToScene (const QRectF &rectF) const

QPointF	mapToScene (qreal x, qreal y) const

QPolygonF	mapToScene (qreal x, qreal y, qreal width, qreal height) const

QMatrix	matrix () const

void	moveBy (qreal dx, qreal dy)

qreal	opacity () const

virtual QPainterPath	opaqueArea () const

virtual void	paint (QPainter painter, const QStyleOptionGraphicsItem option, QWidget *widget=nullptr) = 0

QGraphicsItem *	panel () const

PanelModality	panelModality () const

QGraphicsItem *	parentItem () const

QGraphicsObject *	parentObject () const

QGraphicsWidget *	parentWidget () const

QPointF	pos () const

void	removeSceneEventFilter (QGraphicsItem *filterItem)

void	resetMatrix ()

void	resetTransform ()

qreal	rotation () const

qreal	scale () const

QGraphicsScene *	scene () const

QRectF	sceneBoundingRect () const

QMatrix	sceneMatrix () const

QPointF	scenePos () const

QTransform	sceneTransform () const

void	scroll (qreal dx, qreal dy, const QRectF &rectF=QRectF ())

void	setAcceptDrops (bool on)

void	setAcceptedMouseButtons (Qt::MouseButtons buttons)

void	setAcceptHoverEvents (bool enabled)

void	setAcceptTouchEvents (bool enabled)

void	setActive (bool active)

void	setBoundingRegionGranularity (qreal granularity)

void	setCacheMode (CacheMode mode, const QSize &cacheSize=QSize ())

void	setCursor (const QCursor &cursor)

void	setData (int key, const QVariant &value)

void	setEnabled (bool enabled)

void	setFiltersChildEvents (bool enabled)

void	setFlag (GraphicsItemFlag flag, bool enabled=true)

void	setFlags (GraphicsItemFlags flags)

void	setFocus (Qt::FocusReason focusReason=Qt::OtherFocusReason)

void	setFocusProxy (QGraphicsItem *graphicsItem)

void	setGraphicsEffect (QGraphicsEffect *effect)

void	setGroup (QGraphicsItemGroup *group)

void	setHandlesChildEvents (bool enabled)

void	setInputMethodHints (Qt::InputMethodHints hints)

void	setMatrix (const QMatrix &matrix, bool combine=false)

void	setOpacity (qreal opacity)

void	setPanelModality (PanelModality panelModality)

void	setParentItem (QGraphicsItem *parent)

void	setPos (const QPointF &pos)

void	setPos (qreal x, qreal y)

void	setRotation (qreal angle)

void	setScale (qreal factor)

void	setSelected (bool selected)

void	setToolTip (const QString &toolTip)

void	setTransform (const QTransform &matrix, bool combine=false)

void	setTransformations (const QList< QGraphicsTransform * > &transformations)

void	setTransformOriginPoint (const QPointF &origin)

void	setTransformOriginPoint (qreal x, qreal y)

void	setVisible (bool visible)

void	setX (qreal x)

void	setY (qreal y)

void	setZValue (qreal z)

virtual QPainterPath	shape () const

void	show ()

void	stackBefore (const QGraphicsItem *graphicsItem)

QGraphicsObject *	toGraphicsObject ()

const QGraphicsObject *	toGraphicsObject () const

QString	toolTip () const

QGraphicsItem *	topLevelItem () const

QGraphicsWidget *	topLevelWidget () const

QTransform	transform () const

QList< QGraphicsTransform * >	transformations () const

QPointF	transformOriginPoint () const

virtual int	type () const

void	ungrabKeyboard ()

void	ungrabMouse ()

void	unsetCursor ()

void	update (const QRectF &rectF=QRectF ())

void	update (qreal x, qreal y, qreal width, qreal height)

QGraphicsWidget *	window () const

qreal	x () const

qreal	y () const

qreal	zValue () const

Public Methods inherited from QMediaBindableInterface
virtual	~QMediaBindableInterface ()

Protected Methods
QVariant	itemChange (GraphicsItemChange change, const QVariant &value) override

bool	setMediaObject (QMediaObject *object) override

void	timerEvent (QTimerEvent *event) override

Protected Methods inherited from QGraphicsObject
bool	event (QEvent *event) override

Protected Methods inherited from QObject
virtual void	childEvent (QChildEvent *event)

virtual void	connectNotify (const QMetaMethod &signalMethod) const

virtual void	customEvent (QEvent *event)

virtual void	disconnectNotify (const QMetaMethod &signalMethod) const

bool	isSignalConnected (const QMetaMethod &signalMethod) const

int	receivers (const QString &signal) const

QObject *	sender () const

int	senderSignalIndex () const

virtual void	timerEvent (QTimerEvent *event)

Protected Methods inherited from QGraphicsItem
virtual void	contextMenuEvent (QGraphicsSceneContextMenuEvent *event)

virtual void	dragEnterEvent (QGraphicsSceneDragDropEvent *event)

virtual void	dragLeaveEvent (QGraphicsSceneDragDropEvent *event)

virtual void	dragMoveEvent (QGraphicsSceneDragDropEvent *event)

virtual void	dropEvent (QGraphicsSceneDragDropEvent *event)

virtual void	focusInEvent (QFocusEvent *event)

virtual void	focusOutEvent (QFocusEvent *event)

virtual void	hoverEnterEvent (QGraphicsSceneHoverEvent *event)

virtual void	hoverLeaveEvent (QGraphicsSceneHoverEvent *event)

virtual void	hoverMoveEvent (QGraphicsSceneHoverEvent *event)

virtual void	inputMethodEvent (QInputMethodEvent *event)

virtual QVariant	inputMethodQuery (Qt::InputMethodQuery query) const

virtual QVariant	itemChange (GraphicsItemChange change, const QVariant &value)

virtual void	keyPressEvent (QKeyEvent *event)

virtual void	keyReleaseEvent (QKeyEvent *event)

virtual void	mouseDoubleClickEvent (QGraphicsSceneMouseEvent *event)

virtual void	mouseMoveEvent (QGraphicsSceneMouseEvent *event)

virtual void	mousePressEvent (QGraphicsSceneMouseEvent *event)

virtual void	mouseReleaseEvent (QGraphicsSceneMouseEvent *event)

void	prepareGeometryChange ()

virtual bool	sceneEvent (QEvent *event)

virtual bool	sceneEventFilter (QGraphicsItem watched, QEvent event)

void	updateMicroFocus ()

virtual void	wheelEvent (QGraphicsSceneWheelEvent *event)

Properties
	aspectRatioMode
	Indicates how the video is scaled. More...

	mediaObject
	Provides the video object displayed by a graphics item. More...

	nativeSize
	Native size of the video. More...

	offset
	Video item's offset. More...

	size
	Video item's size. More...

Properties inherited from QGraphicsObject
	effect

	enabled

	opacity

	parent

	pos

	rotation

	scale

	transformOriginPoint

	visible

	x

	y

	z

Properties inherited from QObject
	objectName

Additional Inherited Members
Public Typedefs inherited from QGraphicsItem
using	GraphicsItemFlags = QFlags< GraphicsItemFlag >

Public Types inherited from QGraphicsItem
enum	CacheMode

enum	GraphicsItemChange

enum	GraphicsItemFlag

enum	PanelModality

Public Slots inherited from QObject
void	deleteLater ()

Static Public Methods inherited from QObject
static bool	connect (const QObject sender, const QMetaMethod &signalMethod, const QObject receiver, const QMetaMethod &slotMethod, Qt::ConnectionType type=Qt::AutoConnection)

static bool	connect (const QObject sender, const QString &signalMethod, const QObject receiver, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection, const QString &location=QString ())

static bool	connect (const QObject sender, const QString &signalMethod, const QString &location, const QObject receiver, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection)

template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class SlotClass , class... SlotArgs, class SlotReturn >
static bool	connect (const Sender sender, void (SignalClass::signalMethod)(SignalArgs...), const Receiver receiver, SlotReturn (SlotClass::slotMethod)(SlotArgs...), Qt::ConnectionType type=Qt::AutoConnection)

template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class T >
static bool	connect (const Sender sender, void (SignalClass::signalMethod)(SignalArgs...), const Receiver *receiver, T slotLambda, Qt::ConnectionType type=Qt::AutoConnection)

static bool	disconnect (const QObject sender, const QMetaMethod &signalMethod, const QObject receiver, const QMetaMethod &slotMethod)

static bool	disconnect (const QObject sender, const QString &signalMethod, const QObject receiver, const QString &slotMethod)

static bool	disconnect (const QObject sender, const QString &signalMethod, const QString &location, const QObject receiver, const QString &slotMethod)

static bool	disconnect (const QObject sender, std::nullptr_t, const QObject receiver, std::nullptr_t)

template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class SlotClass , class... SlotArgs, class SlotReturn >
static bool	disconnect (const Sender sender, void (SignalClass::signalMethod)(SignalArgs...), const Receiver receiver, SlotReturn (SlotClass::slotMethod)(SlotArgs...))

template<class Sender , class SignalClass , class... SignalArgs, class Receiver >
static bool	disconnect (const Sender sender, void (SignalClass::signalMethod)(SignalArgs...), const Receiver *receiver, std::nullptr_t slotMethod=nullptr)

template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class T >
static bool	disconnect (const Sender sender, void (SignalClass::signalMethod)(SignalArgs...), const Receiver *receiver, T slotMethod)

static QMetaObject &	staticMetaObject ()

static QString	tr (const char text, const char comment=nullptr, std::optional< int > numArg=std::optional< int >())

Static Public Members inherited from QGraphicsItem
static constexpr const int	UserType = 65536

Protected Slots inherited from QGraphicsObject
void	updateMicroFocus ()

Related Functions inherited from QObject
T	qobject_cast (QObject *object)

	QObjectList

Related Functions inherited from QGraphicsItem
T	qgraphicsitem_cast (QGraphicsItem *item)

Detailed Description

Attaching a QGraphicsVideoItem to a QMediaObject allows it to display the video or image output of the given media object. A QGraphicsVideoItem is attached to a media object by passing a pointer to the QMediaObject to the setMediaObject() method.

Only a single display output can be attached to a media object at one time.

player = new QMediaPlayer(this);
 
QGraphicsVideoItem *item = new QGraphicsVideoItem;
player->setVideoOutput(item);
graphicsView->scene()->addItem(item);
graphicsView->show();
 
player->setMedia(QUrl("https://example.com/myclip.ogv"));
player->play();

See also: QMediaObject, QMediaPlayer, QVideoWidget

Constructor & Destructor Documentation

QGraphicsVideoItem::QGraphicsVideoItem ( QGraphicsItem * parent = nullptr )

explicit

Constructs a graphics item that displays video. The parent is passed to QGraphicsItem.

QGraphicsVideoItem::~QGraphicsVideoItem ( )

Destroys a video graphics item.

Method Documentation

Qt::AspectRatioMode QGraphicsVideoItem::aspectRatioMode ( ) const

Returns the value of the property.

QRectF QGraphicsVideoItem::boundingRect ( ) const

override

Reimplemented from QGraphicsItem::boundingRect()

QVariant QGraphicsVideoItem::itemChange	(	GraphicsItemChange	change,
		const QVariant &	value
	)

overrideprotected

Reimplemented from QGraphicsItem::itemChange()

QMediaObject* QGraphicsVideoItem::mediaObject ( ) const

overridevirtual

Return the currently attached media object.

Implements QMediaBindableInterface::mediaObject()

QSizeF QGraphicsVideoItem::nativeSize ( ) const

Returns the value of the property.

void QGraphicsVideoItem::nativeSizeChanged ( const QSizeF & size )

signal

Signals the native size of the video has changed.

QPointF QGraphicsVideoItem::offset ( ) const

Returns the value of the property.

void QGraphicsVideoItem::paint	(	QPainter *	painter,
		const QStyleOptionGraphicsItem *	option,
		QWidget *	widget = `nullptr`
	)

override

Reimplemented from QGraphicsItem::paint()

void QGraphicsVideoItem::setAspectRatioMode ( Qt::AspectRatioMode mode )

Sets the value of the property to mode.

bool QGraphicsVideoItem::setMediaObject ( QMediaObject * object )

overrideprotectedvirtual

Attaches to the media object. Returns true if attached successfully, otherwise returns false.

Implements QMediaBindableInterface::setMediaObject()

void QGraphicsVideoItem::setOffset ( const QPointF & offset )

Sets the value of the property to offset.

void QGraphicsVideoItem::setSize ( const QSizeF & size )

Sets the value of the property to size.

QSizeF QGraphicsVideoItem::size ( ) const

Returns the value of the property.

void QGraphicsVideoItem::timerEvent ( QTimerEvent * event )

overrideprotected

Reimplemented from QObject::timerEvent()

Property Documentation

QGraphicsVideoItem::aspectRatioMode

This property indicates how the video is scaled to fit the available window.

Properties	Class Methods
read	aspectRatioMode
write	setAspectRatioMode

QGraphicsVideoItem::mediaObject

This property holds the media object which provides the video displayed by a graphics item.

Properties	Class Methods
read	mediaObject
write	setMediaObject

QGraphicsVideoItem::nativeSize

This property holds the native size of the video.

Properties	Class Methods
read	nativeSize
notify	nativeSizeChanged

QGraphicsVideoItem::offset

QGraphicsVideoItem will draw video using the offset for its top left corner.

Properties	Class Methods
read	offset
write	setOffset

QGraphicsVideoItem::size

QGraphicsVideoItem will draw video scaled to fit size according to its fillMode.

Properties	Class Methods
read	size
write	setSize

Public Signals

Public Methods

Protected Methods

Properties

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Method Documentation

Property Documentation