# qtivoverlay
Source: [https://docs.qualcomm.com/doc/80-70018-50SC/topic/qtioverlay.html](https://docs.qualcomm.com/doc/80-70018-50SC/topic/qtioverlay.html)
qtivoverlay 插件是一个硬件加速的就地图像绘制和位块传送插件，用于在 YUV 图像之上绘制叠加层。
您可以通过属性以及附加到输入缓存的缓存元数据来配置叠加。
- 它支持通过属性对静态图像、边框、自定义用户文本、数据/时间叠加层和隐私掩码进行位图传送。
- 它支持通过附加到输入缓存的元数据对检测（边框）、分割（语义掩码/掩码图像）、分类（标签/用户文本）和姿态图叠加层进行位图传送。
## 继承链
[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) → [GstBaseTransform](https://gstreamer.freedesktop.org/documentation/base/gstbasetransform.html?gi-language=c) → [GstVideoFliter](https://gstreamer.freedesktop.org/documentation/video/gstvideofilter.html?gi-language=c) → GstVideoOverlay
下表提供了有关 qtivoverlay 的端口模板和元素属性的信息。有关用例信息，请参见[视频叠加用例](https://docs.qualcomm.com/doc/80-70018-50SC/topic/overlay-use-cases.html)。
## 端口配置
| 端口名称 | 功能 | 功能 | 功能 |
| --- | --- | --- | --- |
| SINK 模板：'sink'
| video/x-raw | format：
width:
height:
framerate： | { (string)NV12, (string)NV21 }
[ 1, 32767 ]
[ 1, 32767 ]
[ 0/1, 2147483647/1 ] |
| SINK 模板：'sink'
| video/x-raw (ANY) | format：
width:
height:
framerate： | { (string)NV12, (string)NV21 }
[ 1, 32767 ]
[ 1, 32767 ]
[ 0/1, 2147483647/1 ] |
| SRC 模板：'src'
| video/x-raw | format：
width:
height:
framerate： | { (string)NV12, (string)NV21 }
[ 1, 32767 ]
[ 1, 32767 ]
[ 0/1, 2147483647/1 ] |
| SRC 模板：'src'
| video/x-raw (ANY) | format：
width:
height:
framerate： | { (string)NV12, (string)NV21 }
[ 1, 32767 ]
[ 1, 32767 ]
[ 0/1, 2147483647/1 ] |
| | | | |
## 元素配置
Table : qtivoverlay 的元素属性
| 属性 | 说明 |
| --- | --- |
| name | 对象名称
- 标志：可读、可写
- 字符串。默认：“overlay0”
|
| parent | 对象的父级
- 标志：可读、可写
- "GstObject" 类型的对象
|
| qos | 处理服务质量 (QoS) 事件。
- 标志：可读、可写
- Boolean。默认值：true
|
| overlay-text | 在视频流上渲染文本
- 标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改
- 字符串。默认值：""
|
| overlay-date | 在视频流上渲染日期和时间
- 标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改
- 字符串。默认值：""
|
| overlay-simg | 在视频流上渲染静态图像
- 标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改
- 字符串。默认值：""
|
| overlay-bbox | 在视频流上渲染边框和标签
- 标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改
- 字符串。默认值：""
|
| overlay-mask | 在视频流上渲染隐私掩码
- 标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改
- 字符串。默认值：""
|
| bbox-color | 边框叠加颜色
- 标志：可读、可写
- 无符号整型。范围：0 - 4294967295 默认值：52479
|
| date-color | 日期叠加颜色
- 标志：可读、可写
- 无符号整型。范围：0 - 4294967295 默认值：4278190335
|
| text-color | 文本叠加颜色
- 标志：可读、可写
- 无符号整型。范围：0 - 4294967295 默认值：4294902015
|
| pose-color | 姿态叠加颜色
- 标志：可读、可写
- 无符号整型。范围：0 - 4294967295 默认值：869007615
|
| arrows-color | 箭头叠加颜色
- 标志：可读、可写
- 无符号整型。范围：0 - 4294967295 默认值：4278190335
|
| bbox-font-size | 边框叠加字体大小
- 标志：可读、可写
- 无符号整型。范围：1 - 4294967295 默认值：25
|
| date-font-size | 日期叠加字体大小
- 标志：可读、可写
- 无符号整型。范围：1 - 4294967295 默认值：20
|
| text-font-size | 文本叠加字体大小
- 标志：可读、可写
- 无符号整型。范围：1 - 4294967295 默认值：40
|
| dest-rect-ml-text | 用于 ML 检测叠加的目标矩形参数。目标矩形格式的 Start-X、Start-Y、宽度，以及高度为 <X, Y, WIDTH, HEIGHT>
- 标志：可读、可写
- GstValueArray 类型为 "gint" 的 GValues 数组
|
| 多边形 | |
| arrows-ft-mv | ARROWS MV 滤镜
- 标志：可读、可写
- 无符号整型。范围：0 - 4294967295 默认值：0
|
| arrows-ft-sad | ARROWS SAD 滤镜
- 标志：可读、可写
- 无符号整型。范围：0 - 4294967295 默认值：0
|
| arrows-ft-var | ARROWS VAR 滤镜
- 标志：可读、可写
- 无符号整型。范围：0 - 4294967295 默认值：0
|
**Parent Topic:** [配置 ML 插件](https://docs.qualcomm.com/doc/80-70018-50SC/topic/inferencing-plugins.html)
Last Published: Nov 12, 2025
[Previous Topic
qtimlvsuperresolution](https://docs.qualcomm.com/bundle/publicresource/80-70018-50SC/topics/qtimlvsuperresolution.md) [Next Topic
qtimetamux](https://docs.qualcomm.com/bundle/publicresource/80-70018-50SC/topics/qtimetamux.md)