gstbuffer_workflow

# qtimlvconverter Source: [https://docs.qualcomm.com/doc/80-70022-50SC/topic/qtimlvconverter.html](https://docs.qualcomm.com/doc/80-70022-50SC/topic/qtimlvconverter.html) qtimlvconverter 插件将传入的视频缓存转换为神经网络张量，同时在此过程中执行必要的格式转换和调整大小。为了实现这些操作，该插件使用 GPU 硬件和 ION/DMA 分配的缓存。关于浮点张量，需要使用平均值和西格玛属性来使用公式：变换来自视频源的 8 位无符号整数镜像 (channel - mean) × sigma其中通道是颜色转换输入的红色、绿色、蓝色或 Alpha 通道的值。例如，下表列出了影响图像通道变换的平均值和西格玛属性： | 属性 | 带通道变换的 RGB 图像 | | --- | --- | | R=255，G=127，B=0 | R=(255 - 128.0) x 0.75, G=(127 - 156.0)
x 0.34, B=(0 - 124.0) x 0.02 | | mean=“<128.0, 156.0, 124.0, 58.0>” | R=(255 - 128.0) x 0.75, G=(127 - 156.0)
x 0.34, B=(0 - 124.0) x 0.02 | | sigma="<0.75, 0.34, 0.02, 0.07>" | R=(255 - 128.0) x 0.75, G=(127 - 156.0)
x 0.34, B=(0 - 124.0) x 0.02 | | | | | | | subpixel-layout 属性指定输出张量中图像像素的排列。该插件使用 Qualcomm IB2C 库进行所有转换操作。该库与 API 封装在自定义 GstGlesVideoConverter 抽象层中，用于创建、配置和处理传入和传出缓存。 GstMLBufferPool，一个自定义缓存类，可以执行以下操作： - 分配输出缓存。 - 通过 IOCTL 命令向内核分配 ION 缓存。 Figure : 使用 qtimlvconverter 的 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) → GstMLVideoConverter 下表提供了有关 qtimlvconverter 的端口模板和元素属性的信息。有关用例信息，请参见 [LiteRT 用例](https://docs.qualcomm.com/doc/80-70022-50SC/topic/tensorflow-lite-use-cases.html)和 [Qualcomm Neural Processing SDK 用例](https://docs.qualcomm.com/doc/80-70022-50SC/topic/qualcomm-neural-processing-sdk-use-cases.html)。 ## 端口配置 | 端口名称 | 功能 | 功能 | 功能 | | --- | --- | --- | --- | | SINK 模板：'sink'

*可用性：* 始终可用

*方向：* 接收 | video/x-raw | format： | { (string)RGBA, (string)BGRA, (string)ABGR, (string)ARGB, (string)RGBx, (string)BGRx, (string)xRGB, (string)xBGR, (string)BGR, (string)RGB, (string)GRAY8, (string)NV12, (string)NV21, (string)YUY2, (string)UYVY } | | SINK 模板：'sink'

*可用性：* 始终可用

*方向：* 接收 | video/x-raw (memory:GBM) | format： | { (string)RGBA, (string)BGRA, (string)ABGR, (string)ARGB, (string)RGBx, (string)BGRx, (string)xRGB, (string)xBGR, (string)BGR, (string)RGB, (string)GRAY8, (string)NV12, (string)NV21, (string)YUY2, (string)UYVY } | | SRC 模板：'src'

*可用性：* 始终可用

*方向：* 发送 | neural-network/tensors | type： | { (string)UINT8, (string)INT32, (string)FLOAT16, (string)FLOAT32 } | | | | | | ## 元素配置 Table : qtimlvconverter 的元素属性 | 属性 | 说明 | | --- | --- | | name | 对象名称

标志：可读、可写

字符串。默认："mlvideoconverter0"

| | parent | 对象的父级

标志：可读、可写

"GstObject" 类型的对象

| | qos | 处理服务质量事件。

标志：可读、可写

Boolean。默认值：false

| | subpixel-layout | 输出张量中图像像素的排列。

标志：可读、可写

枚举 “GstMLVideoPixelLayout” 默认：0，“regular”
- (0)：regular - 常规子像素布局。例如，RGB、RGBA 或 RGBx。
- (1)：reverse – 反向子像素布局。例如，BGR、BGRA 或 BGRx。

| | mean | 通道均值 FLOAT 张量的减法值 ('<R, G, B>', '<R, G, B, A>', '<G>')

标志：可读、可写

"gdouble" 类型 GValue 的 GstValueArray

| | sigma | FLOAT 张量的通道除数值（'<R, G, B>', '<R, G, B, A>', '<G>'）

标志：可读、可写

"gdouble" 类型 GValue 的 GstValueArray

| | engine | 选择 Qualcomm® Computer Vision SDK 或 GLES 作为 qtimlvconverter 的后端

值可以是 "fcv" 或 "gles"

对于非 GPU 设备，默认值为 fcv。对于 GPU 设备，默认值为 gles

Note: 目前不支持 Qualcomm Computer Vision SDK（fcv）引擎。 | **Parent Topic:** [配置 ML 插件](https://docs.qualcomm.com/doc/80-70022-50SC/topic/inferencing-plugins.html) Last Published: Nov 05, 2025 [Previous Topic 配置 ML 插件](https://docs.qualcomm.com/bundle/publicresource/80-70022-50SC/topics/inferencing-plugins.md) [Next Topic qtimlaconverter](https://docs.qualcomm.com/bundle/publicresource/80-70022-50SC/topics/qtimlaconverter.md)