QGraphicsVideoItem Class
Die Klasse „QGraphicsVideoItem“ stellt ein Grafikelement bereit, das Videos anzeigt, die von einem „ QMediaPlayer “ oder „ QCamera “ erzeugt werden. Mehr dazu...
| Header: | #include <qgraphicsvideoitem.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS MultimediaWidgets) target_link_libraries(mytarget PRIVATE Qt6::MultimediaWidgets) |
| qmake: | QT += multimediawidgets |
| Erbt von: | 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 |
Neu implementierte ö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) |
Ausführliche Beschreibung
Durch das Anfügen eines `QGraphicsVideoItem` an ein ` QMediaPlayer ` oder ` QCamera ` kann dieses die Video- oder Bildausgabe des jeweiligen Medienobjekts anzeigen.
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: An ein Medienobjekt kann jeweils nur eine einzige Anzeigeausgabe angehängt werden.
Siehe auch „ QMediaPlayer “, „ QVideoWidget “ und „ QCamera “.
Eigenschaftsdokumentation
aspectRatioMode : Qt::AspectRatioMode
Wie ein Video an die Größe des Grafikelements angepasst wird.
Zugriffsfunktionen:
| Qt::AspectRatioMode | aspectRatioMode() const |
| void | setAspectRatioMode(Qt::AspectRatioMode mode) |
[read-only] nativeSize : 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 Das Video wird unter Verwendung des Offsets für seine obere linke Ecke gezeichnet.
Zugriffsfunktionen:
| QPointF | offset() const |
| void | setOffset(const QPointF &offset) |
size : QSizeF
Diese Eigenschaft enthält die Größe des Videoelements.
QGraphicsVideoItem Das Video wird entsprechend dem „fillMode“ skaliert und an die Größe angepasst.
Zugriffsfunktionen:
| QSizeF | size() const |
| void | setSize(const QSizeF &size) |
[read-only] videoSink : QVideoSink* const
Gibt den zugrunde liegenden Video-Sink zurück, der Videobilder im aktuellen Element rendern kann. Diese Eigenschaft ist niemals „ nullptr “. Beispiel für das Rendern von Videobildern in „ 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 Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch QMediaPlayer::setVideoOutput.
Dokumentation der Mitgliedsfunktionen
[explicit] QGraphicsVideoItem::QGraphicsVideoItem(QGraphicsItem *parent = nullptr)
Erstellt ein Grafikelement, das ein Video anzeigt.
Das „ parent “ wird an „ QGraphicsItem “ übergeben.
[override virtual noexcept] QGraphicsVideoItem::~QGraphicsVideoItem()
Löscht ein Grafikobjekt.
[override virtual] QRectF QGraphicsVideoItem::boundingRect() const
Implementiert: ` QGraphicsItem::boundingRect()` const.
[override virtual] void QGraphicsVideoItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)
Implementiert: QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget).
[override virtual] int QGraphicsVideoItem::type() const
Implementiert neu: ` QGraphicsItem::type()` const.
Gibt einen int zurück, der den Typ des Videoelements angibt.
© 2026 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.
