# qtivsplit Source: [https://docs.qualcomm.com/doc/80-70020-50/topic/qtivsplit.html](https://docs.qualcomm.com/doc/80-70020-50/topic/qtivsplit.html) The qtivsplit plugin uses the GPU hardware to split a single input video stream into multiple output streams. The number of streams is a user-defined variable and is equal to the number of source pads. The mode property for each source pad determines the method for splitting the incoming stream. Table : Operational mode properties of qtivsplit | Operational mode | Description | | :--- | :--- | | none |

The incoming video frames on the sink pad are duplicated on each
of the source pads.

More color conversion and upscale/downscale are applied based on
the negotiated GstCaps on that
pad.

| | single-roi-meta |

The input video buffers are checked for GstVideoRegionOfInterestMeta.

Ensure that when the source pads are created, their number is
equal to the maximum expected count of GstVideoRegionOfInterestMeta inside a single GstBuffer.

If their source pads are fewer, the ROI meta that doesn't have a
corresponding pad is ignored.

| | batch-roi-meta | Operates the [GstVideoRegionOfInterestMeta](https://gstreamer.freedesktop.org/documentation/video/gstvideometa.html#GstVideoRegionOfInterestMeta)
entries attached to the buffer but instead of sending one such entry, it
sends all the meta entries on the pads in that mode as separate
buffers. | Each meta entry in the [GstBuffer](https://gstreamer.freedesktop.org/documentation/gstreamer/gstbuffer.html#GstBuffer) is sent to its corresponding source pad based on the ID and crop, upscale/downscale, and color conversion is performed to match the negotiated [GstCaps](https://gstreamer.freedesktop.org/documentation/gstreamer/gstcaps.html). The source pads with no corresponding ROI meta produce GAP buffers. The plugin uses the Qualcomm IB2C library or Qualcomm Computer Vision SDK for all the transformation operations. - The Qualcomm IB2C library is wrapped in the custom GstC2dVideoConverter or GstGlesVideoConverter abstraction layer. - It includes APIs to create, configure, and process the incoming and outgoing buffers. ## Buffer management Figure : GStreamer pipeline with qtivsplit Figure : qtivsplit buffer management The GstImageBufferPool custom buffer pool class allocates either GBM or ION output buffers depending on the negotiated capabilities between GstImageBufferPool and downstream plugins. - The GBM allocation is done using Qualcomm libgbm. - The ION allocation is done using the IOCTL commands to the kernel. ## Inheritance chain [GObject](https://docs.gtk.org/gobject/) → [GstObject](https://gstreamer.freedesktop.org/documentation/gstreamer/gstobject.html?gi-language=c) → [GstElement](https://gstreamer.freedesktop.org/documentation/gstreamer/gstelement.html?gi-language=c) → GstVideoSplit The following tables provide information on pad templates and element properties of qtivsplit. For use cases, see the following: - For use case on splitting video into several streams, see [Video split use cases](https://docs.qualcomm.com/doc/80-70020-50/topic/video-split-use-cases.html). - For use case on dynamic cropping, see [Daisy chain detection and classification](https://docs.qualcomm.com/doc/80-70020-50/topic/daisy-chain-detection-and-classification.html). ## Pad configuration | Pad Name | Capabilities | Capabilities | Capabilities | | --- | --- | --- | --- | | SINK template: 'sink'

Availability: Always

Direction: sink

| video/x-raw | format: | { (string)NV12, (string)NV21, (string)UYVY, (string)YUY2,
(string)RGBA, (string)BGRA, (string)ARGB, (string)ABGR,
(string)RGBx, (string)BGRx, (string)xRGB, (string)xBGR, (string)RGB,
(string)BGR, (string)GRAY8 } | | SINK template: 'sink'

Availability: Always

Direction: sink

Availability: Always

Direction: sink

Availability: Always

Direction: sink

Availability: Always

Direction: sink

| video/x-raw(memory:GBM) | format: | { (string)NV12, (string)NV21, (string)UYVY, (string)YUY2,
(string)RGBA, (string)BGRA, (string)ARGB, (string)ABGR,
(string)RGBx, (string)BGRx, (string)xRGB, (string)xBGR, (string)RGB,
(string)BGR, (string)GRAY8 } | | SINK template: 'sink'

Availability: Always

Direction: sink

Availability: Always

Direction: sink

Availability: Always

Direction: sink

Availability: On request

Direction: source

Availability: On request

Direction: source

Availability: On request

Direction: source

Availability: On request

Direction: source

Availability: On request

Direction: source

Availability: On request

Direction: source

Availability: On request

Direction: source

Availability: On request

Direction: source

| video/x-raw(memory:GBM) | framerate: | [ 0/1, 255/1 ] | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Table : Pad properties for qtivsplit | Pad | Property | Description | | --- | --- | --- | | 'src\_%u' | mode | Operational mode

flags: readable, writable, changeable only in NULL or READY
state

Enum "GstVideoSplitMode" Default: 0, "none"
- (0): none - Incoming buffer is rescaled and color
  converted to match the negotiated pad caps. If the
  input and output caps match, then the input buffer
  is moved to the output and its reference count
  increased.
- (1): force-transform - Incoming buffer is rescaled
  and color converted to match the negotiated pad
  caps. A new buffer is created even if the negotiated
  input and output caps match.
- (2): single-roi-meta - Incoming buffer is checked
  for ROI meta. If there is a meta entry that
  corresponds to this pad, the crop, rescale and color
  conversion operations are performed on the input
  buffer. The transformed buffer is sent to the next
  plugin. A pad with no corresponding ROI meta creates
  a GAP buffer.
- (3): batch-roi-meta - Incoming buffer is checked
  for ROI meta. For each meta entry a crop, rescaling
  and color conversion are done on the input buffer.
  This, for each ROI meta entry, a buffer is produced
  and sent to the next plugin downstream. In case ROI
  meta isn't present, the pad creates a GAP
  buffer.

| ## Element configuration Table : Element properties of qtivsplit | Property | Description | | --- | --- | | name | The name of the object.

flags: readable, writable

String. Default: "videosplit0"

| | parent | The parent of the object.

flags: readable, writable

Object of type "GstObject"

| | engine | Engine backend used for the conversion operations.

flags: readable, writable

Enum "GstVideoConverterBackend" Default: 1, "gles"
- (1): gles - Uses OpenGLES based video converter (2):
- fcv - Uses Qualcomm Computer Vision SDK based video
  converter
  Note: The Qualcomm Computer Vision SDK (fcv) engine is currently
  not supported.

| **Parent Topic:** [Configure display, camera, encode and decode plugins](https://docs.qualcomm.com/doc/80-70020-50/topic/display-plugins.html) Last Published: Jan 30, 2026 [Previous Topic Waylandsink](https://docs.qualcomm.com/bundle/publicresource/80-70020-50/topics/waylandsink.md) [Next Topic qtivtransform](https://docs.qualcomm.com/bundle/publicresource/80-70020-50/topics/qtivtransform.md)