Back to Qt.io
Contact Us Blog Download Qt
En esta página

QGraphicsVideoItem Class

La clase QGraphicsVideoItem proporciona un elemento gráfico que muestra vídeo producido por un QMediaPlayer o QCamera. Más...

Cabecera: #include <QGraphicsVideoItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS MultimediaWidgets)
target_link_libraries(mytarget PRIVATE Qt6::MultimediaWidgets)
qmake: QT += multimediawidgets
Hereda: 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

Adjuntar un QGraphicsVideoItem a un QMediaPlayer o QCamera permite mostrar 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: Sólo puede adjuntarse una única 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 escala un vídeo para ajustarlo al tamaño del elemento gráfico.

Funciones de acceso:

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

[read-only] nativeSize : QSizeF

Esta propiedad contiene el tamaño nativo del vídeo.

Funciones de acceso:

QSizeF nativeSize() const

Señal del 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 para 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 Dibujará 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 sumidero de vídeo subyacente que puede renderizar fotogramas de vídeo en el elemento actual. Esta propiedad nunca es nullptr. Ejemplo de renderización de 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 puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también QMediaPlayer::setVideoOutput.

Documentación de funciones miembro

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

Construye un elemento gráfico que muestra vídeo.

El parent se pasa a QGraphicsItem.

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

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