# qtivsplit Source: [https://docs.qualcomm.com/doc/80-70020-50SC/topic/qtivsplit.html](https://docs.qualcomm.com/doc/80-70020-50SC/topic/qtivsplit.html) qtivsplit 插件使用 GPU 硬件将单个输入视频流拆分为多个输出流。流的数量是由用户定义的变量，且等于发送端口的数量。每个发送端口的模式属性决定了分割传入流的方法。 Table : qtivsplit 的操作模式属性 | 操作模式 | 说明 | | :--- | :--- | | none |

接收端口上的传入视频帧复制到每个发送端口。

根据该端口上协商的 GstCaps 应用更多颜色转换和放大/缩小。

| | single-roi-meta |

检查输入视频存 GstVideoRegionOfInterestMeta。

确保创建发送端口时，其数量等于单个 GstBuffer 内 GstVideoRegionOfInterestMeta 的最大预期计数。

如果其发送端口较少，则会忽略没有相应端口的 ROI 元数据。

| | batch-roi-meta | 它处理附加到缓存的 [GstVideoRegionOfInterestMeta](https://gstreamer.freedesktop.org/documentation/video/gstvideometa.html#GstVideoRegionOfInterestMeta) 条目，但不是发送这些条目，而是将该模式下端口上的所有元条目作为单独的缓存发送。 | 该 [GstBuffer](https://gstreamer.freedesktop.org/documentation/gstreamer/gstbuffer.html#GstBuffer) 中的每个此类元条目均根据 ID 发送到其相应的发送端口，并执行裁剪、放大/缩小和颜色转换以匹配协商的 [GstCaps](https://gstreamer.freedesktop.org/documentation/gstreamer/gstcaps.html)。无相应 ROI 元数据的发送端口会生成 GAP 缓存。该插件使用 Qualcomm IB2C 库或 Qualcomm Computer Vision SDK 进行所有转换操作。 - Qualcomm IB2C 库包装在自定义 GstC2dVideoConverter 或 GstGlesVideoConverter 抽象层中。 - 它包括用于创建、配置和处理传入和传出缓存的 API。 ## 缓存管理 Figure : 使用 qtivsplit 的 GStreamer pipeline Figure : qtivsplit 缓存管理 GstImageBufferPool 自定义缓存池类根据 GstImageBufferPool 和下游插件之间的协商处理能力分配 GBM 或 ION 输出缓存。 - 通过 Qualcomm libgbm 完成 GBM 分配。 - 通过发到内核的 IOCTL 命令完成 ION 分配。 ## 继承链 [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 下表提供了有关 qtivsplit 的端口模板和元素属性的信息。有关用例信息，请参阅以下内容： - 有关将视频分割为多个流的用例，请参见[视频分割用例](https://docs.qualcomm.com/doc/80-70020-50SC/topic/video-split-use-cases.html)。 - 有关动态裁剪的用例，请参见[菊花链检测与分类](https://docs.qualcomm.com/doc/80-70020-50SC/topic/daisy-chain-detection-and-classification.html)。 ## 端口配置 | 端口名称 | 功能 | 功能 | 功能 | | --- | --- | --- | --- | | SINK 模板：'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 模板：'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 模板：'sink'

可用性： 始终可用

方向： 接收

可用性： 始终可用

方向： 接收

可用性： 始终可用

方向： 接收

可用性： 按需

方向： 发送

可用性： 按需

方向： 发送

可用性： 按需

方向： 发送

可用性： 按需

方向： 发送

可用性： 按需

方向： 发送

可用性： 按需

方向： 发送

可用性： 按需

方向： 发送

可用性： 按需

方向： 发送

| video/x-raw (memory:GBM) | framerate： | [ 0/1, 255/1 ] | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Table : qtivsplit 的端口属性 | 端口 | 属性 | 说明 | | --- | --- | --- | | 'src\_%u' | mode | 操作模式

标志：可读、可写、仅在 NULL 或 READY 状态下可更改

枚举“GstVideoSplitMode”默认：0，“none”
- (0)：none - 重新调整传入缓存并转换颜色以匹配协商的端口上限。如果输入与输出 caps 相匹配，则输入缓存将移动到输出，并且其引用计数会增加。
- (1)：force-transform - 对传入缓存重新调整大小并转换颜色以匹配协商的端口上限。即使协商的输入和输出上限匹配，也会创建新的缓存。
- (2)：single-roi-meta - 检查传入缓存的 ROI 元数据。如果存在与此端口相对应的元条目，则对输入缓存执行裁剪、重新调整和颜色转换操作。转换后的缓存将发送到下一个插件。没有相应 ROI 元的端口会创建一个 GAP 缓存。
- (3)：batch-roi-meta - 检查传入缓存的 ROI 元数据。关于每个元条目，裁剪、重新缩放和颜色转换均在输入缓存上完成。对于每个 ROI 元条目，都会生成一个缓存并将其发送到下游的下一个插件。如果 ROI 元不存在，端口会创建一个 GAP 缓存。

| ## 元素配置 Table : qtivsplit 的元素属性 | 属性 | 说明 | | --- | --- | | name | 对象名称

标志：可读、可写

字符串。默认：“videosplit0”

| | parent | 对象的父级

标志：可读、可写

"GstObject" 类型的对象

| | engine | 用于转换操作的引擎后端

标志：可读、可写

枚举“GstVideoConverterBackend”默认： 1，“gles”
- (1)：gles - 使用基于 OpenGLES 的视频转换器 (2)：
- fcv - 使用基于 Qualcomm Computer Vision SDK 的视频转换器
  Note: 目前不支持 Qualcomm Computer Vision SDK（fcv）引擎。

| **Parent Topic:** [配置显示器、摄像头、编码和解码插件](https://docs.qualcomm.com/doc/80-70020-50SC/topic/display-plugins.html) Last Published: Jul 23, 2025 [Previous Topic Waylandsink](https://docs.qualcomm.com/bundle/publicresource/80-70020-50SC/topics/waylandsink.md) [Next Topic qtivtransform](https://docs.qualcomm.com/bundle/publicresource/80-70020-50SC/topics/qtivtransform.md)