# qtimlvdetection
Source: [https://docs.qualcomm.com/doc/80-70022-50SC/topic/qtimlvdetection.html](https://docs.qualcomm.com/doc/80-70022-50SC/topic/qtimlvdetection.html)
qtimlvdetection 插件将来自 ML 推理插件（例如 qtimltflite、qtimlsnpe 和 qtimlqnn）的目标检测模型的输出张量处理为预测结果。
Note: 此插件将被弃用。
Figure : 使用 qtimlvdetection 的 GstBuffer 工作流
## 后处理
Figure : 目标检测架构的后处理
协商的 [GstCaps](https://gstreamer.freedesktop.org/documentation/gstreamer/gstcaps.html) 决定了处理后的输出。输出可以是以下任一值：
- 图像遮罩（GstCaps：video/x-raw），可通过 qtivcomposer 将其叠加在原始图像上。
- 该元素使用基于 CPU 的 [Cairo](https://www.cairographics.org) 2D 图形库在 ION/DMA 缓存中绘制预测结果。
- GstImageBufferPool 自定义缓存池类通过 IOCTL 命令将 ION/DMA 缓存分配给内核。
- 包含预测结果的 GStreamer 格式文本（GstCaps：text/x-raw）。
预测结果被解析为使用常规系统内存分配的缓存内的 GStreamer 格式的字符串。
插件的模块和标签属性决定了后处理操作的方法。
- module 属性指定了后处理模块。该属性在运行中使用包含前缀 "`ml-vdetection`-" 的 `/usr/lib/gstreamer-1.0/ml/modules/` 中的可用库动态填充。
- labels 属性是一个自定义文本文件，对于必须为预测标签提供的每个机器学习检测模型都不同。
可选属性可用于调整预测结果。
- 使用 results 属性控制显示的结果数
- 使用阈值属性设置预测的置信度阈值。不显示置信度低的结果。
## 继承链
[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) → GstMLVideoDetection
下表提供了有关 qtimlvdetection 的端口模板和元素属性的信息。有关用例信息，请参见在 [Qualcomm Neural Processing SDK 用例](https://docs.qualcomm.com/doc/80-70022-50SC/topic/qualcomm-neural-processing-sdk-use-cases.html) 和 [LiteRT 用例](https://docs.qualcomm.com/doc/80-70022-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'
| video/x-raw | format： | { (string)BGRA, (string)BGRx, (string)BGR16 } |
| SRC 模板：'src'
| text/x-raw | format： | { (string)utf8 } |
| | | | |
| | | | |
## 元素配置
Table : qtimlvdetection 的元素属性
| 属性 | 说明 |
| --- | --- |
| name | 对象名称
- 标志：可读、可写
- 字符串。默认："mlvideodetection0"
|
| parent | 对象的父级
- 标志：可读、可写
- "GstObject" 类型的对象
|
| qos | 处理服务质量事件。
- 标志：可读、可写
- Boolean。默认值：false
|
| module | 用于处理张量的模块名称。
- 标志：可读、可写
- 枚举 "GstMLVideoDetectionModules"（0)：none - 无模块，默认无效模式
- (1)：face-detect - ml-vdetection-face-detect
- (2)：ssd-mobilenet - ml-vdetection-ssd-MobileNet
- (3)：YOLOv5m - ml-vdetection-yolov5m
- (4)： YOLOv5s - ml-vdetection-yolov5s
|
| labels | 标签的文件名。 |
| results | 要显示的结果数
- 标志：可读、可写
- 无符号整型。范围： 0~10 默认： 5
|
| threshold | 置信度阈值 (%)
- 标志：可读、可写
- 双范围：10.0 - 100.0 默认：10.0
|
**Parent Topic:** [配置 ML 插件](https://docs.qualcomm.com/doc/80-70022-50SC/topic/inferencing-plugins.html)
Last Published: Nov 05, 2025
[Previous Topic
qtimlaclassification](https://docs.qualcomm.com/bundle/publicresource/80-70022-50SC/topics/qtimlaclassification.md) [Next Topic
qtimlvsegmentation](https://docs.qualcomm.com/bundle/publicresource/80-70022-50SC/topics/qtimlvsegmentation.md)