Skip to content

Qt Video Operator#

Authors: Holoscan Team (NVIDIA)
Supported platforms: x86_64, aarch64
Language: C++
Last modified: March 9, 2026
Latest version: 1.0.0
Minimum Holoscan SDK version: 0.6.0
Tested Holoscan SDK versions: 0.6.0
Contribution metric: Level 1 - Highly Reliable

The qt_video operator is used to display a video in a QtQuick application.

For more information on how to use this operator in an application see Qt video replayer example.

holoscan::ops::QtVideoOp#

Operator class.

Parameters#

  • QtHoloscanVideo: Instance of QtHoloscanVideo to be used
    • type: `QtHoloscanVideo

Inputs#

  • input: Input frame data
  • type: nvidia::gxf::Tensor or nvidia::gxf::VideoBuffer

API Reference#

C++#

OpenGLRenderer#

Inherits from: QObject, QOpenGLExtraFunctions

This class is responsible for rendering the image to the QtHoloscanVideo item.

Methods#
Method Description
OpenGLRenderer(QtHoloscanSharedData *shared_data) Construct a new OpenGLRenderer object.
OpenGLRenderer()=delete
void setGeometry(const QRectF &geometry) Set the geometry of the render area.
void setWindow(QQuickWindow *window) Set the window object the renderer should use.

QtHoloscanVideo#

Inherits from: QQuickItem

This class is a QQuickItem which displays the video frames received by QtVideoOp.

Methods#
Method Description
QtHoloscanVideo()
void processBuffer(void *pointer, const nvidia::gxf::VideoBufferInfo &video_buffer_info, cudaEvent_t cuda_event) Process a video buffer.

holoscan::ops::QtVideoOp#

Inherits from: holoscan::Operator

This operator inputs VideoBuffer or Tensor and displays it with the QtHoloscanVideo QtQuick item.

Methods#
Method Description
QtVideoOp()
void initialize() override
void start() override
void stop() override
void setup(holoscan::OperatorSpec &spec) override
void compute(holoscan::InputContext &op_input, holoscan::OutputContext &op_output, holoscan::ExecutionContext &context) override