# qtimlvclassification
Source: [https://docs.qualcomm.com/doc/80-70014-50Y/topic/qtimlvclassification.html](https://docs.qualcomm.com/doc/80-70014-50Y/topic/qtimlvclassification.html)
qtimlvclassification 插件处理将图像分类模型的张量从 ML 推理插件（如 qtimltflite、qtimlsnpe 和 qtimlqnn）输出到预测结果中。
协商的 [GstCaps](https://gstreamer.freedesktop.org/documentation/gstreamer/gstcaps.html) 确定插件输出上的已处理输出。它可以是以下任一项：
- 图像掩码（GstCaps：video/x-raw），可以使用 qtivcomposer 将其应用于原始图像。
- 包含预测结果的 GStreamer 格式文本（GstCaps：text/x-raw）。
qtimlvclassification 插件使用基于 CPU 的 [Cairo](https://www.cairographics.org) 2D 图形库作为图像叠加蒙版。图像叠加掩码使其能够在 ION/DMA 缓冲区中绘制预测结果。GstImageBufferPool 自定义缓冲池类通过 IOCTL 命令将 ION/DMA 缓冲区分配给内核。
在通用文本格式中，预测结果在使用常规系统内存分配的缓冲区内解析为 GStreamer 格式的字符串。
插件的模块和标签属性决定了用于后处理操作的方法。
- module 属性指定后处理模块，该模块在 runtime 使用包含前缀的可用库 `in /usr/lib/gstreamer-1.0/ml/modules/` 进行填充和动态运行 `ml-vclassification-`
- labels 属性是一个自定义文本文件，对于需要为预测标签提供的每个机器学习检测模型都不同。
可选属性可用于调整预测结果。使用结果控制显示的结果数，使用阈值设置预测的置信度阈值，不显示置信度低于阈值的结果。
Figure : 目标检测架构的后处理
Figure : pipeline 中的 QTimlv 分类
## 继承链
[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) → GstMLVideoClassification
下表提供了有关 qtimlsnpe 的设备接插口模板和组件属性的信息。有关用例信息，请参见在 [Qualcomm Neural Processing SDK 用例](https://docs.qualcomm.com/doc/80-70014-50Y/topic/qualcomm-neural-processing-sdk-use-cases.html) 和 [TensorFlow Lite 用例](https://docs.qualcomm.com/doc/80-70014-50Y/topic/tensorflow-lite-use-cases.html) 中的分类使用案例。
## 接插口配置
| 接插口名称 | 处理能力 | 处理能力 | 处理能力 |
| --- | --- | --- | --- |
| SINK 模板： 'sink'
*可用性：*根据要求
*方向：接收设备* | 神经网络/张量 | – | – |
| SRC 模板："src"
*可用性：*总是
*方向：源* | video/x-RAW | 格式： | { (string)BGRA, (string)BGRx, (string)BGR16 } |
| SRC 模板："src"
*可用性：*总是
*方向：源* | video/x-raw(memory:GBM) | 格式： | { (string)BGRA, (string)BGRx, (string)BGR16 } |
| SRC 模板："src"
*可用性：*总是
*方向：源* | text/x-raw | 格式： | { (string)utf8 } |
| | | | |
| | | | |
## 组件配置
Table : qtimlvclassification 的组件属性
| 属性 | 说明 |
| --- | --- |
| name |
- 对象名称
- 标志：可读、可写
- 字符串。默认值："mlvideoclassification0"
|
| parent |
- 对象的父级
- 标志：可读、可写
- "GstObject" 类型的对象
|
| qos |
- 处理服务质量事件
- 标志：可读、可写
- Boolean。默认值：false
|
| module | 将用于处理张量的模块名称
标志：可读、可写
枚举 "GstMLVideoClassificationModules" 默认值：0, "none"
- （0）：none - 无模块，默认无效模式
- (1): MobileNet - ml-vclassification-MobileNet
|
| labels |
- 标签文件名
- 标志：可读、可写
- 字符串。默认值：null
|
| results |
- 要显示的结果数
- 标志：可读、可写
- 无符号整型。范围：0 - 10 默认值：5
|
| threshold |
- 置信度阈值（%）
- 标志：可读、可写
- 双精度浮点型。范围：10.0 - 100.0 默认值：10.0
|
**Parent Topic:** [Qualcomm GST 插件](https://docs.qualcomm.com/doc/80-70014-50Y/topic/qim-sdk-plugins.html)
Last Published: Nov 11, 2025
[Previous Topic
qtimlqnn](https://docs.qualcomm.com/bundle/publicresource/80-70014-50Y/topics/qtimlqnn.md) [Next Topic
qtimlvconverter](https://docs.qualcomm.com/bundle/publicresource/80-70014-50Y/topics/qtimlvconverter.md)