# qtimlvdetection
Source: [https://docs.qualcomm.com/doc/80-70014-50/topic/qtimlvdetection.html](https://docs.qualcomm.com/doc/80-70014-50/topic/qtimlvdetection.html)
The qtimlvdetection plugin processes output tensors of an Object Detection model from
the ML inference plugin (such as qtimltflite, qtimlsnpe and qtimlqnn) into result of
predictions.
Figure : GstBuffer workflow with qtimlvdetection
## Postprocessing
Figure : Postprocessing for object detection architecture
The negotiated [GstCaps](https://gstreamer.freedesktop.org/documentation/gstreamer/gstcaps.html) determines the processed output.
The output can be either of the following:
- An image overlay mask (GstCaps: video/x-raw), which can be applied over the
original image using qtivcomposer.
- The element uses the CPU-based [Cairo](https://www.cairographics.org) 2D graphics library to draw the prediction results in
ION/DMA buffers.
- The GstImageBufferPool custom buffer pool class allocates the ION/DMA
buffers through IOCTL commands to the kernel.
- The GStreamer-formatted text (GstCaps: text/x-raw) containing the prediction
results.
The prediction results are parsed into GStreamer-formatted string
inside buffers allocated using regular system memory.
The module and labels properties of the plugin determine the method for the
postprocessing operations.
- The module property specifies the postprocess module and is populated
dynamically at run time with the libraries available in
`/usr/lib/gstreamer-1.0/ml/modules/` containing the prefix
"`ml-vdetection`-".
- The labels property is a customized text file different for each machine
learning detection model that you must provide for the prediction labels.
Optional properties are available for adjusting the prediction results.
- Use results property to control the number of results displayed
- Use threshold property to set a confidence threshold for prediction. The results
with low confidence won't be displayed.
## Inheritance chain
[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
The following tables provide information on pad templates and element properties of
qtimlvdetection. For use cases, see the detection use cases in [TensorFlow Lite use cases](https://docs.qualcomm.com/doc/80-70014-50/topic/tensorflow-lite-use-cases.html) and [Qualcomm Neural Processing SDK use cases](https://docs.qualcomm.com/doc/80-70014-50/topic/qualcomm-neural-processing-sdk-use-cases.html).
## Pad configuration
| Pad Name | Capabilities | Capabilities | Capabilities |
| --- | --- | --- | --- |
| SINK template: 'sink'
- Availability: On request
- Direction: sink
| neural-network/tensors | – | – |
| SRC template: 'src'
- Availability: Always
- Direction: source
| video/x-raw | format: | { (string)BGRA, (string)BGRx, (string)BGR16 } |
| SRC template: 'src'
- Availability: Always
- Direction: source
| video/x-raw(memory:GBM) | format: | { (string)BGRA, (string)BGRx, (string)BGR16 } |
| SRC template: 'src'
- Availability: Always
- Direction: source
| text/x-raw | format: | { (string)utf8 } |
| | | | |
| | | | |
## Element configuration
Table : Element properties for qtimlvdetection
| Property | Description |
| --- | --- |
| name | The name of the object
- flags: readable, writable
- String. Default: "mlvideodetection0"
|
| parent | The parent of the object
- flags: readable, writable
- Object of type "GstObject"
|
| qos | Handle Quality-of-Service events
- flags: readable, writable
- Boolean. Default: false
|
| module | Module name that is going to be used for processing the
tensors
- flags: readable, writable
- Enum "GstMLVideoDetectionModules" (0): none - No module,
default invalid mode
- (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 | Labels file name
- flags: readable, writable
- String. Default: null
|
| results | Number of results to display
- flags: readable, writable
- Unsigned Integer. Range: 0 - 10 Default: 5
|
| threshold | Confidence threshold in %
- flags: readable, writable
- Double Range: 10.0 - 100.0 Default: 10.0
|
**Parent Topic:** [Qualcomm GST plugins](https://docs.qualcomm.com/doc/80-70014-50/topic/qim-sdk-plugins.html)
Last Published: Oct 27, 2025
[Previous Topic
qtimlvconverter](https://docs.qualcomm.com/bundle/publicresource/80-70014-50/topics/qtimlvconverter.md) [Next Topic
qtimlvsegmentation](https://docs.qualcomm.com/bundle/publicresource/80-70014-50/topics/qtimlvsegmentation.md)