# qtimlvpose
Source: [https://docs.qualcomm.com/doc/80-70017-50SC/topic/qtimlvpose.html](https://docs.qualcomm.com/doc/80-70017-50SC/topic/qtimlvpose.html)
qtimlvpose 插件将来自 ML 推理插件（如 qtimltflite、qtimlsnpe 和 qtimlqnn）的姿态估计模型的输出张量处理为预测结果。
## 后处理
Figure : 姿态估计架构的后处理
插件输出上协商的 [GstCaps](https://gstreamer.freedesktop.org/documentation/gstreamer/gstcaps.html) 决定了处理后的输出，可以是以下任一：
- 可以使用 qtivcomposer 在原始图像上应用的图像掩码（GstCaps：video/x-raw）。
- 该组件使用基于 CPU 的 [Cairo](https://www.cairographics.org) 2D 图形库在 ION/DMA 缓存中绘制预测结果。
- GstImageBufferPool 自定义缓存池类通过 IOCTL 命令将 ION/DMA 缓存分配给内核。
- 包含预测结果的 GStreamer 格式文本（GstCaps：text/x-raw）。
预测结果被解析为使用常规系统内存分配的缓存内的 GStreamer 格式的字符串。
插件的模块和标签属性决定了后处理操作的方法。
- 模块属性指定后处理模块，并在 runtime 使用包含前缀“`ml-vpose`-”的可用 `/usr/lib/gstreamer-1.0/ml/modules/` 库动态填充。
- labels 属性是一个自定义文本文件，对于必须为预测标签提供的每个机器学习检测模型都不同。
可选属性可用于调整预测结果。
- 使用 results 属性控制显示的结果数
- 使用阈值属性设置预测的置信度阈值。不显示置信度低的结果。
Figure : 使用 qtimlvpose 的 GstBuffer 工作流程
## 继承链
[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) → GstMLVideoPose
下表提供了有关 qtimlvpose 的端模板和组件属性的信息。有关用例信息，请参见 [LiteRT 用例](https://docs.qualcomm.com/doc/80-70017-50SC/topic/tensorflow-lite-use-cases.html) 中的姿态估计用例。
## 端口配置
| 端口名称 | 功能 | 功能 | 功能 |
| --- | --- | --- | --- |
| SINK 模板：'sink'
*可用性：* 按需
*方向：* 接收端 | neural-network/tensors | – | – |
| SRC 模板：'src'
*可用性：* 始终可用
*方向：* 发送 | video/x-raw | format： | { (string)BGRA, (string)BGRx, (string)BGR16 } |
| SRC 模板：'src'
*可用性：* 始终可用
*方向：* 发送 | text/x-raw | format： | { (string)utf8 } |
| | | | |
## 组件配置
Table : qtimlvpose 的组件属性
| 属性 | 说明 |
| --- | --- |
| name | 对象名称
- 标志：可读、可写
- 字符串。默认：“mlvideopose0”
|
| parent | 对象的父级
- 标志：可读、可写
- "GstObject" 类型的对象
|
| qos | 处理服务质量事件
- 标志：可读、可写
- Boolean。默认值：false
|
| module | 将用于处理张量的模块名称
- 标志：可读、可写
- 枚举 “GstMLVideoPoseModules” 默认：0，“none”
- (0): none - 无模块，默认无效模式
- (1): posenet - ml-vpose-posenet
|
| labels | 标签的文件名。 |
| results | 要显示的结果数
- 标志：可读、可写
- 无符号整型。范围： 0~10 默认： 5
|
| threshold | 置信度阈值 (%)
- 标志：可读、可写
- 双精度浮点型。范围：10.0 - 100.0 默认：50.0
|
**上一级主题：** [ML 插件](https://docs.qualcomm.com/doc/80-70017-50SC/topic/inferencing-plugins.html)
Last Published: Nov 11, 2025
[Previous Topic
qtimlvsegmentation](https://docs.qualcomm.com/bundle/publicresource/80-70017-50SC/topics/qtimlvsegmentation.md) [Next Topic
qtimlvsuperresolution](https://docs.qualcomm.com/bundle/publicresource/80-70017-50SC/topics/qtimlvsuperresolution.md)