Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

QGraphicsVideoItem Class

La classe QGraphicsVideoItem fournit un élément graphique qui affiche une vidéo produite par QMediaPlayer ou QCamera. Plus....

En-tête : #include <QGraphicsVideoItem>
CMake : find_package(Qt6 REQUIRED COMPONENTS MultimediaWidgets)
target_link_libraries(mytarget PRIVATE Qt6::MultimediaWidgets)
qmake : QT += multimediawidgets
Héritages : QGraphicsObject

Propriétés

Fonctions publiques

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

Fonctions publiques réimplémentées

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

Signaux

void nativeSizeChanged(const QSizeF &size)

Description détaillée

L'association d'un élément QGraphicsVideoItem à une page QMediaPlayer ou QCamera permet d'afficher la sortie vidéo ou image de cet objet multimédia.

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();

Remarque: une seule sortie d'affichage peut être attachée à un objet multimédia à la fois.

Voir également QMediaPlayer, QVideoWidget, et QCamera.

Documentation sur les propriétés

aspectRatioMode : Qt::AspectRatioMode

comment une vidéo est mise à l'échelle pour s'adapter à la taille de l'élément graphique.

Fonctions d'accès :

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

[read-only] nativeSize : QSizeF

Cette propriété indique la taille native de la vidéo.

Fonctions d'accès :

QSizeF nativeSize() const

Signal de notification :

void nativeSizeChanged(const QSizeF &size)

offset : QPointF

Cette propriété contient le décalage de l'élément vidéo.

QGraphicsVideoItem Cette propriété permet de dessiner la vidéo en utilisant le décalage de son coin supérieur gauche.

Fonctions d'accès :

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

size : QSizeF

Cette propriété définit la taille de l'élément vidéo.

QGraphicsVideoItem La propriété fillMode permet de dessiner une vidéo dont la taille est adaptée à celle de l'élément vidéo, en fonction de son fillMode.

Fonctions d'accès :

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

[read-only] videoSink : QVideoSink* const

Renvoie le puits vidéo sous-jacent qui peut rendre les images vidéo dans l'élément actuel. Cette propriété n'est jamais nullptr. Exemple de rendu d'images vidéo sur 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));

Fonctions d'accès :

QVideoSink *videoSink() const[see note below]

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

Voir également QMediaPlayer::setVideoOutput.

Documentation sur les fonctions membres

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

Construit un élément graphique qui affiche une vidéo.

L'adresse parent est transmise à QGraphicsItem.

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

Détruit un élément graphique vidéo.

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

Réimplémente : QGraphicsItem::boundingRect() const.

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

Réimplémente : QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget).

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

Réimplémente : QGraphicsItem::type() const.

Renvoie un int représentant le type de l'élément vidéo.

© 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.