Back to Qt.io
Contact Us Blog Download Qt

QGraphicsVideoItem Class

Die Klasse QGraphicsVideoItem stellt ein Grafikelement zur Verfügung, das ein von QMediaPlayer oder QCamera erzeugtes Video anzeigt .

Kopfzeile: #include <QGraphicsVideoItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS MultimediaWidgets)
target_link_libraries(mytarget PRIVATE Qt6::MultimediaWidgets)
qmake: QT += multimediawidgets
Vererbungen: QGraphicsObject

Eigenschaften

Öffentliche Funktionen

QGraphicsVideoItem(QGraphicsItem *parent = nullptr)
virtual ~QGraphicsVideoItem() override
Qt::AspectRatioMode aspectRatioMode() const
QSizeF nativeSize() const
QPointF offset() const
void setAspectRatioMode(Qt::AspectRatioMode mode)
void setOffset(const QPointF &offset)
void setSize(const QSizeF &size)
QSizeF size() const
QVideoSink *videoSink() const

Reimplementierte öffentliche Funktionen

virtual QRectF boundingRect() const override
virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) override
virtual int type() const override

Signale

void nativeSizeChanged(const QSizeF &size)

Detaillierte Beschreibung

Das Anhängen eines QGraphicsVideoItem an ein QMediaPlayer oder QCamera ermöglicht die Anzeige der Video- oder Bildausgabe dieses Medienobjekts.

player = new QMediaPlayer(this);

QGraphicsVideoItem *item = new QGraphicsVideoItem;
player->setVideoOutput(item);
graphicsView->scene()->addItem(item);
graphicsView->show();

player->setSource(QUrl("http://example.com/myclip4.ogv"));
player->play();

Hinweis: Einem Medienobjekt kann immer nur eine einzige Ausgabe zugewiesen werden.

Siehe auch QMediaPlayer, QVideoWidget, und QCamera.

Dokumentation der Eigenschaft

aspectRatioMode : Qt::AspectRatioMode

wie ein Video skaliert wird, damit es in die Größe des Grafikelements passt.

Funktionen aufrufen:

Qt::AspectRatioMode aspectRatioMode() const
void setAspectRatioMode(Qt::AspectRatioMode mode)

[read-only] nativeSize : const QSizeF

Diese Eigenschaft enthält die native Größe des Videos.

Zugriffsfunktionen:

QSizeF nativeSize() const

Benachrichtigungssignal:

void nativeSizeChanged(const QSizeF &size)

offset : QPointF

Diese Eigenschaft enthält den Versatz des Videoelements.

QGraphicsVideoItem zeichnet das Video unter Verwendung des Versatzes für seine linke obere Ecke.

Zugriffsfunktionen:

QPointF offset() const
void setOffset(const QPointF &offset)

size : QSizeF

Diese Eigenschaft enthält die Größe des Videoelements.

QGraphicsVideoItem Die Eigenschaft fillMode skaliert das Video auf die Größe, die dem fillMode entspricht.

Zugriffsfunktionen:

QSizeF size() const
void setSize(const QSizeF &size)

[read-only] videoSink : QVideoSink* const

Gibt die zugrunde liegende Videosenke zurück, die Videobilder für das aktuelle Element rendern kann. Diese Eigenschaft ist niemals nullptr. Beispiel für das Rendern von Videobildern auf QGraphicsVideoItem:

QGraphicsVideoItem *item = new QGraphicsVideoItem;
graphicsView->scene()->addItem(item);
graphicsView->show();
QImage img = QImage("images/qt-logo.png").convertToFormat(QImage::Format_ARGB32);
item->videoSink()->setVideoFrame(QVideoFrame(img));

Zugriffsfunktionen:

QVideoSink *videoSink() const[see note below]

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

Siehe auch QMediaPlayer::setVideoOutput.

Dokumentation der Mitgliedsfunktionen

[explicit] QGraphicsVideoItem::QGraphicsVideoItem(QGraphicsItem *parent = nullptr)

Konstruiert ein Grafikelement, das ein Video anzeigt.

Die Adresse parent wird an QGraphicsItem übergeben.

[override virtual noexcept] QGraphicsVideoItem::~QGraphicsVideoItem()

Zerstört ein Videografikelement.

[override virtual] QRectF QGraphicsVideoItem::boundingRect() const

Reimplements: QGraphicsItem::boundingRect() const.

[override virtual] void QGraphicsVideoItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)

Reimplements: QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget).

[override virtual] int QGraphicsVideoItem::type() const

Reimplements: QGraphicsItem::type() const.

Gibt ein int zurück, das den Typ des Videoelements angibt.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.