QGraphicsVideoItem Class
La clase `QGraphicsVideoItem` proporciona un elemento gráfico que muestra el vídeo generado por un ` QMediaPlayer ` o un ` QCamera`. Más información...
| Encabezado: | #include <qgraphicsvideoitem.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS MultimediaWidgets) target_link_libraries(mytarget PRIVATE Qt6::MultimediaWidgets) |
| qmake: | QT += multimediawidgets |
| Heredado de: | QGraphicsObject |
Propiedades
|
Funciones públicas
| 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 |
Funciones públicas reimplementadas
| virtual QRectF | boundingRect() const override |
| virtual void | paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) override |
| virtual int | type() const override |
Señales
| void | nativeSizeChanged(const QSizeF &size) |
Descripción detallada
Al asociar un `QGraphicsVideoItem` a un ` QMediaPlayer ` o a un ` QCamera `, se permite que muestre la salida de vídeo o imagen de ese objeto multimedia.
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();Nota: Solo se puede asociar una salida de visualización a un objeto multimedia a la vez.
Véase también « QMediaPlayer », « QVideoWidget » y « QCamera ».
Documentación de propiedades
aspectRatioMode : Qt::AspectRatioMode
cómo se redimensiona un vídeo para que se ajuste al tamaño del elemento gráfico.
Funciones de Access:
| Qt::AspectRatioMode | aspectRatioMode() const |
| void | setAspectRatioMode(Qt::AspectRatioMode mode) |
[read-only] nativeSize : QSizeF
Esta propiedad contiene el tamaño original del vídeo.
Funciones de acceso:
| QSizeF | nativeSize() const |
Señal de notificador:
| void | nativeSizeChanged(const QSizeF &size) |
offset : QPointF
Esta propiedad contiene el desplazamiento del elemento de vídeo.
QGraphicsVideoItem Dibujará el vídeo utilizando el desplazamiento correspondiente a su esquina superior izquierda.
Funciones de acceso:
| QPointF | offset() const |
| void | setOffset(const QPointF &offset) |
size : QSizeF
Esta propiedad contiene el tamaño del elemento de vídeo.
QGraphicsVideoItem Mostrará el vídeo escalado para ajustarse al tamaño según su «fillMode».
Funciones de acceso:
| QSizeF | size() const |
| void | setSize(const QSizeF &size) |
[read-only] videoSink : QVideoSink* const
Devuelve el destino de vídeo subyacente capaz de reproducir fotogramas de vídeo en el elemento actual. Esta propiedad nunca es de tip nullptr. Ejemplo de cómo reproducir fotogramas de vídeo en 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));Funciones de acceso:
| QVideoSink * | videoSink() const | [see note below] |
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véase también QMediaPlayer::setVideoOutput.
Documentación de las funciones de miembro
[explicit] QGraphicsVideoItem::QGraphicsVideoItem(QGraphicsItem *parent = nullptr)
Crea un elemento gráfico que muestra vídeo.
El objeto ` parent ` se pasa a ` QGraphicsItem`.
[override virtual noexcept] QGraphicsVideoItem::~QGraphicsVideoItem()
Elimina un elemento gráfico de vídeo.
[override virtual] QRectF QGraphicsVideoItem::boundingRect() const
Reimplementa: QGraphicsItem::boundingRect() const.
[override virtual] void QGraphicsVideoItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)
Reimplementa: ` QGraphicsItem::paint` (`QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)`.
[override virtual] int QGraphicsVideoItem::type() const
Reimplementa: ` QGraphicsItem::type()` const.
Devuelve un int que representa el tipo del elemento de vídeo.
© 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.