QGraphicsVideoItem Class
La classe `QGraphicsVideoItem` fournit un élément graphique permettant d'afficher une vidéo générée par un ` QMediaPlayer ` ou un ` QCamera`. En savoir plus...
| En-tête : | #include <qgraphicsvideoitem.h> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS MultimediaWidgets) target_link_libraries(mytarget PRIVATE Qt6::MultimediaWidgets) |
| qmake : | QT += multimediawidgets |
| Hérite de : | 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 QGraphicsVideoItem à un objet multimédia ( QMediaPlayer ) ou à une image ( QCamera ) permet d'afficher la sortie vidéo ou l'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: un seul périphérique d'affichage peut être associé à 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 redimensionnée 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é contient la taille d'origine 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 L'affichage de la vidéo s'effectuera en utilisant ce décalage pour son coin supérieur gauche.
Fonctions d'accès :
| QPointF | offset() const |
| void | setOffset(const QPointF &offset) |
size : QSizeF
Cette propriété contient la taille de l'élément vidéo.
QGraphicsVideoItem La vidéo sera affichée redimensionnée pour s'adapter à la taille définie, en fonction de son mode de remplissage (fillMode).
Fonctions d'accès :
| QSizeF | size() const |
| void | setSize(const QSizeF &size) |
[read-only] videoSink : QVideoSink* const
Renvoie le récepteur vidéo sous-jacent capable d'afficher des images vidéo dans l'élément actuel. Cette propriété n'est jamais de type « nullptr ». Exemple illustrant comment afficher des images vidéo dans « 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 appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Voir également QMediaPlayer::setVideoOutput.
Documentation des fonctions membres
[explicit] QGraphicsVideoItem::QGraphicsVideoItem(QGraphicsItem *parent = nullptr)
Crée un élément graphique permettant d'afficher une vidéo.
L'parent est transmis à la fonction QGraphicsItem.
[override virtual noexcept] QGraphicsVideoItem::~QGraphicsVideoItem()
Supprime 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 entier 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.
