# qtiqmmfsrc Source: [https://docs.qualcomm.com/doc/80-70022-50SC/topic/qtiqmmfsrc.html](https://docs.qualcomm.com/doc/80-70022-50SC/topic/qtiqmmfsrc.html) qtiqmmfsrc 插件通过 Qualcomm Camera Service 采集视频帧。 该插件包含 GstQtiQmmfSrc 主类，此主类作为 Qualcomm 多媒体框架 (QMMF) 录制器客户端的包装器，为视频流和图像流提供独立的端口。 - 这些端口存储了特定流的创建时间参数（在 pipeline 创建期间作为 GstCap 传递）。 - GstQtiQmmfSrc 获取该信息，将其转换为 QMMF 录制器客户端参数，并在元素的每个状态转换时调用必要的 API。 - 对于视频和图像端口，通过 `camera`属性来设置摄像头设备 ID。默认 ID 为 0。 以下是插件的转换状态： - 在 NULL 和 READY 状态之间的转换期间，插件会打开并使用指定的 ID 初始化摄像头设备。 - 从 READY 转换到 PAUSED 状态时，插件会转换设置的端口参数并调用 QMMF 服务，来为每个端口创建源码流。 - 当转换到 PLAYING 状态时，会话流启动。 当插件在主类中收到一帧时，就会创建一个 GstBuffer 并将其发送到相关的端口缓存队列。端口将缓存从下一个插件推送到其链接的接收端。 QMMF 服务执行以下操作： - 该插件会分配缓存。当缓存不再使用时，插件会将其返回给服务。 - 对于视频，QMMF 服务在插件状态为 PLAYING 时发送存。 - 对于图像端口，必须发送 *capture-image* 信号。对于每一张采集的图像，QMMF 服务都会发送一个缓存。 ## 继承链 [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) → GstQmmfSrc 下表提供了有关 qtiqmmfsrc 的端口模板和元素属性的信息。有关用例信息，请参见[摄像头](https://docs.qualcomm.com/doc/80-70022-50SC/topic/camera.html)。 ## 端口配置 | 端口名称 | 功能 | 功能 | 功能 | | --- | --- | --- | --- | | SRC 模板：'image\_%u'
| image/jpeg | | [ 16, 4096 ]



[ 16, 4096 ]



[ 0/1, 30/1 ] | | SRC 模板：'image\_%u'
| video/x-raw | format：



width:



height:



framerate： | { (string)NV12, (string)NV21 }



[ 16, 4096 ]



[ 16, 4096 ]



[ 0/1, 30/1 ] | | SRC 模板：'image\_%u'
| video/x-raw (memory:GBM) | format：



width:



height:



framerate： | { (string)NV12, (string)NV21 }



[ 16, 4096 ]



[ 16, 4096 ]



[ 0/1, 30/1 ] | | SRC 模板：'image\_%u'
| video/X-Bayer | format：



bpp：



width:



height:



framerate： | { (string)bggr, (string)rggb, (string)gbrg, (string)grbg, (string)mono }



{ (string)8, (string)10, (string)12, (string)16 }



[ 16, 4096 ]



[ 16, 4096 ]



[ 0/1, 30/1 ] | | SRC 模板：'video\_%u'
| image/jpeg | width:



height:



framerate： | [ 16, 4096 ]



[ 16, 4096 ]



[ 0/1, 120/1 ] | | SRC 模板：'video\_%u'
| video/x-raw | format：



width:



height:



framerate： | { (string)NV12, (string)NV16, (string)YUY2 }



[ 16, 4096 ]



[ 16, 4096 ]



[ 0/1, 120/1 ] | | SRC 模板：'video\_%u'
| video/x-raw (memory:GBM) | format：



width:



height:



framerate： | { (string)NV12, (string)YUY2 }



[ 16, 4096 ]



[ 16, 4096 ]



[ 0/1, 120/1 ] | | SRC 模板：'video\_%u'
| video/X-Bayer | format：



bpp：



width:



height:



framerate： | (string)bggr, (string)rggb, (string)gbrg, (string)grbg, (string)mono }



{ (string)8, (string)10, (string)12, (string)16 }



[ 16, 4096 ]



[ 16, 4096 ]



[ 0/1, 120/1 ] | | | | | | | | | | | | | | | | | 端口 | 属性 | 说明 | | --- | --- | --- | | 'image\_%u' | mode | 不同的图像模式 | | 'video\_%u' | source-index | 此端口所链接到的源视频端口的索引 | | 'video\_%u' | framerate | 显示的目标帧率（以每秒帧数为单位） | | 'video\_%u' | crop | 裁剪矩形 ('<X, Y, WIDTH, HEIGHT>')。仅适用于 JPEG 和 YUY2 格式。 | | 'video\_%u' | extra-buffers | 分配的额外缓存数量。 | | 'video\_%u' | type | 流类型 | | | | | | | | | | | | | | | | | ## 元素配置 Table : qtiqmmfsrc 的元素属性 | 属性 | 说明 | | --- | --- | | name | 对象名称 | | parent | 对象的父级 | | camera | 视频/图像端口要使用的摄像头设备 ID | | slave | 将摄像头设置为辅助设备。 | | ldc | 镜头失真校正 | | lcac | 横向色差校正 | | eis | 电子图像稳定功能，减少摄像头抖动带来的影响。 | | shdr | 超高动态范围成像 | | adrc | 自动动态范围压缩 | | control-mode | 自动曝光、自动白平衡、自动对焦（也称为 3A）控制例程的整体模式。
这是一款顶级 3A 控制开关。设置为 OFF 时，摄像头设备所控制的 3A 被禁用。
| | effect | 应用于摄像头帧的效果 | | scene | 根据场景进行摄像头优化 | | antibanding | 当前照明条件下的摄像头防明暗条纹例程 | | sharpness | 图像清晰度强度 | | contrast | 图像对比度强度 | | saturation | 图像饱和度强度 | | iso-mode | ISO 曝光模式
| | manual-iso-value | 手动曝光 ISO 值。当 ISO 模式设置为 “manual” 时使用 | | exposure-mode | 摄像头曝光例程所需的模式。 | | exposure-lock | 锁定当前摄像头曝光例程的值，以防更改 | | exposure-metering | 摄像头曝光测光例程所需的模式 | | exposure-compensation | 调整（补偿）摄像头图像目标亮度。调整量以步进数来衡量。 | | manual-exposure-time | 手动曝光时间（以纳秒为单位）。当曝光模式设置为 “off” 时使用 | | custom-exposure-table | 描述自定义曝光表的 GstStructure。 | | white-balance-mode | 摄像头白平衡例程的模式。
| | white-balance-lock | 锁定当前白平衡值，以防止更改。仅影响非手动白平衡模式。 | | manual-wb-settings | 手动白平衡设置，例如色温校正和 R/G/B 增益。用于手动白平衡模式 | | focus-mode | 指示是否启用自动对焦及其模式。 | | noise-reduction | 降噪滤波模式 | | noise-reduction-tuning | 描述降噪调整的 GstStructure。 | | zoom | 传感器有源像素阵列坐标中的摄像头缩放矩形 ('<X, Y, WIDTH, HEIGHT >') | | defog-table | 描述除雾表的 GstStructure | | ltm-data | 描述本地色调映射数据的 GstStructure | | infrared-mode | 红外模式 | | active-sensor-size | 摄像头传感器的活动像素阵列 ('<X, Y, WIDTH, HEIGHT >')，仅当插件处于 READY 或更高状态时才会填充 | | sensor-mode | 强制设置传感器模式索引 (0-15)。-1 用于自动选择。 | | capture-metadata | 公开用于摄像头控制的摄像头元数据对象。如果使用 get 属性，调用者必须释放元数据对象。 | | camera-characteristics | 作为摄像头元数据对象返回摄像头参数支持的值。调用方应获取所有权并释放元数据对象
| Table : qtiqmmfsrc 的元素信号 | 信号 | 功能 | | --- | --- | | result-metadata | `void user_function (GstElement* object, gpointer arg0,
gpointer user_data);` | | urgent-metadata | `void user_function (GstElement* object, gpointer arg0,
gpointer user_data);` | **Parent Topic:** [配置显示器、摄像头、编码和解码插件](https://docs.qualcomm.com/doc/80-70022-50SC/topic/display-plugins.html) Last Published: Nov 05, 2025 [Previous Topic 配置显示器、摄像头、编码和解码插件](https://docs.qualcomm.com/bundle/publicresource/80-70022-50SC/topics/display-plugins.md) [Next Topic qtivcomposer](https://docs.qualcomm.com/bundle/publicresource/80-70022-50SC/topics/qtivcomposer.md)