En esta página

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.