# qtiqmmfsrc Source: [https://docs.qualcomm.com/doc/80-70015-50SC/topic/qtiqmmfsrc.html](https://docs.qualcomm.com/doc/80-70015-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* 信号。对于每个 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-70015-50SC/topic/camera.html)。 ## 接插口配置 | 接插口名称 | 处理能力 | 处理能力 | 处理能力 | | --- | --- | --- | --- | | SRC 模板：'image\_%u'
| image/jpeg | | [ 16, 4096 ]



[ 16, 4096 ]



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



宽度：



高度：



帧率： | { (string)NV12, (string)NV21 }



[ 16, 4096 ]



[ 16, 4096 ]



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



宽度：



高度：



帧率： | { (string)NV12, (string)NV21 }



[ 16, 4096 ]



[ 16, 4096 ]



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



bpp：



宽度：



高度：



帧率： | { (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 | 宽度：



高度：



帧率： | [ 16, 4096 ]



[ 16, 4096 ]



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



宽度：



高度：



帧率： | { (string)NV12, (string)NV16, (string)YUY2 }



[ 16, 4096 ]



[ 16, 4096 ]



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



宽度：



高度：



帧率： | { (string)NV12, (string)YUY2 }



[ 16, 4096 ]



[ 16, 4096 ]



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



bpp：



宽度：



高度：



帧率： | (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-70015-50SC/topic/display-plugins.html) Last Published: Nov 11, 2025 [Previous Topic 显示、摄像头、编码和解码插件](https://docs.qualcomm.com/bundle/publicresource/80-70015-50SC/topics/display-plugins.md) [Next Topic qtivcomposer](https://docs.qualcomm.com/bundle/publicresource/80-70015-50SC/topics/qtivcomposer.md)