Layer_1

# qtivcomposer Source: [https://docs.qualcomm.com/doc/80-70022-50SC/topic/qtivcomposer.html](https://docs.qualcomm.com/doc/80-70022-50SC/topic/qtivcomposer.html) qtivcomposer 插件使用 GPU 硬件将多个输入视频流合并/混合为单个输出流。 Note: 在使用 qtivcomposer 的实时源设置中，长时间测试表明，如果输入缓存没有按照预期的间隔到达，则合成器可能会产生重复的输出帧。当这种重复持续存在于连续的帧中时，即使缓存是连续生成和处理的，也会产生视频冻结的视觉印象。这种行为表明，不规则的缓存计时可能会干扰正常的帧生成，从而导致误导性的播放伪影。输出缓存内的（针对每个流）的输入缓存组成由端口属性决定。下表列出了 qtivcomposer 的一些常见端口属性。关于更多详细信息，请参阅 [Table : qtivcomposer 的端口属性](https://docs.qualcomm.com/doc/80-70022-50SC/topic/qtivcomposer.html#qtivcomposer__table_hzl_mcn_myb)。 | 属性 | 用法 | | --- | --- | | Position | 设置输出中每个输入帧的 X 轴和 Y 轴位置。 | | Crop | 设置源的可选裁剪。 | | Dimensions | 放大/缩小帧。 | | Rotate | 垂直旋转帧 | |

Flip-horizontal

Flip-vertical

| 水平和垂直翻转帧。 | | Alpha | 将阿尔法混合值添加到帧中。 | | Z order | 更改帧的顺序。
默认情况下，帧会按接收设备端口的创建顺序进行排列。例如，sink\_0 和 sink\_1。 | 图中展示了使用 qtivcomposer 处理多个视频源的 GStreamer pipeline。 Figure : 使用 qtivcomposer 的 pipeline 视频合成包括但不限于以下内容： - 画中画 - 并排 - 阿尔法混合如果在 [GstCaps](https://gstreamer.freedesktop.org/documentation/gstreamer/gstcaps.html) 发送端口中没有指定合成参数和尺寸，则输出视频帧的尺寸将与最大的传入视频流相同。同样，如果未在 GstCaps 中设置帧率，则从帧率最高的流获取帧率。如果输出 GstCaps 没有明确设置的格式，则插件会根据输入流协商最通用的格式。该插件使用 Qualcomm IB2C 库或 Qualcomm Computer Vision SDK 进行所有转换操作。 - Qualcomm IB2C 库包装在自定义 GstC2dVideoConverter 或 GstGlesVideoConverter 抽象层中。 - 它包含用于创建、配置和处理传入和传出缓存的 API。 - 推荐的插件是 GstGLESVideoConverter。名为 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) → [GstAggregator](https://gstreamer.freedesktop.org/documentation/base/gstaggregator.html?gi-language=c) → GstVideoComposer 下表提供了有关 qtivcomposer 的端口模板和元素属性的信息。有关用例信息，请参见[视频合成用例](https://docs.qualcomm.com/doc/80-70022-50SC/topic/video-composition.html)。 ## 端口配置 | 端口名称 | 功能 | 功能 | 功能 | | --- | --- | --- | --- | | SINK 模板：'sink\_%u'

可用性： 按需

方向： 接收端

| 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\_%u'

可用性： 按需

方向： 接收端

可用性： 按需

方向： 接收端

可用性： 按需

方向： 接收端

可用性： 按需

方向： 接收端

| 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\_%u'

可用性： 按需

方向： 接收端

可用性： 按需

方向： 接收端

可用性： 按需

方向： 接收端

可用性： 始终可用

方向： 发送

可用性： 始终可用

方向： 发送

可用性： 始终可用

方向： 发送

可用性： 始终可用

方向： 发送

可用性： 始终可用

方向： 发送

可用性： 始终可用

方向： 发送

可用性： 始终可用

方向： 发送

可用性： 始终可用

方向： 发送

| video/x-raw (memory:GBM) | framerate： | [ 0/1, 255/1 ] | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 端口 | 属性 | 说明 | | --- | --- | --- | | 'sink\_%u' | zorder | Z 轴顺序，默认为创建顺序。

标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改、0x40000000

整型。范围：˗1 至 2147483647 默认值：˗1

| | 'sink\_%u' | crop | 裁剪矩形 ('<X, Y, WIDTH, HEIGHT >')

标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改、0x40000000

GstValueArray 类型为 "gint" 的 GValues 数组

| | 'sink\_%u' | position | 目标矩形左上角的 X 和 Y 坐标 ('<X, Y>')。

标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改、0x40000000

GstValueArray 类型为 "gint" 的 GValues 数组

| | 'sink\_%u' | dimensions | 目标矩形的宽度和高度，如果为“0”，则将与输入尺寸相同（'<WIDTH, HEIGHT>'）

标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改、0x40000000

GstValueArray 类型为 "gint" 的 GValues 数组

| | 'sink\_%u' | alpha | 阿尔法通道值。

标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改、0x40000000

双精度浮点型。范围：0.0 - 1.0 默认：1.0

| | 'sink\_%u' | flip-horizontal | 水平翻转视频图像。

标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改、0x40000000

Boolean。默认值：false

| | 'sink\_%u' | flip-vertical | 垂直翻转视频图像。

标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改、0x40000000

Boolean。默认值：false

| | 'sink\_%u' | rotate | 旋转视频图像。

标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改、0x40000000

枚举 “GstVideoComposerRotate” 默认：0，“none”
- (0)：none - 无旋转
- (1)：90CW - 顺时针旋转 90 度
- (2)：90CCW - 逆时针旋转 90 度
- (3)：180 - 旋转 180 度

| | 'sink\_%u' | emit-signals | 发送信号以消耗信号数据

标志：可读、可写

Boolean。默认值：false

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

标志：可读、可写

字符串。默认："videocomposer0"

| | parent | 对象的父级

标志：可读、可写

"GstObject" 类型的对象

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

标志：可读、可写

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

| | latency | 实时模式下的额外延迟，允许上游花费更长的时间生成当前位置的缓存（以纳秒为单位）

标志：可读、可写

64 位无符号整型。

范围：0 - 18446744073709551615

默认值：0

| | start-time-selection | 决定输出哪个开始时间。

标志：可读、可写

枚举 “GstAggregatorStartTimeSelection” 默认：0，“zero”
- (0)：zero - 从 0 运行时间开始（默认）
- (1)：first - 从第一个观察到的输入运行时间开始
- (2)：set - 使用 start-time 属性设置开始时间

| | start-time | 当 start-time-selection=set 时的开始时间

标志：可读、可写

64 位无符号整型。范围：0 - 18446744073709551615 默认：18446744073709551615

| | background | 背景颜色

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

无符号整数范围：0 - 4294967295

默认值：4286611584

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