# 启用多个 ROI 流

Note

本节仅适用于 QCS6490。

这是一项高级摄像头控制功能，允许用户从单个摄像头获得多个 ROI 流，每个流显示完整 FOV 中不同的 ROI。其最多支持三个裁剪的 ROI 流和一个完整的 ROI 流。

在三个 ROI 情况下，程序会发送五个要配置的流，包括一个完整的 FOV 输出流、一个输入流和三个 ROI 输出流。实时 Pipeline 生成完整的 FOV 图像。程序接收完整的 FOV 图像，并将完整的 FOV 缓冲区作为输入图像提交回摄像头再处理 Pipeline。再处理 Pipeline 从完整的 FOV 图像中生成最多三个 ROI 图像。

Note

使用 SSH 连接到设备控制台。相关说明，请参见[如何使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/how_to.html#use-ssh)。

请在设备上运行以下命令，以收集日志：

# journalctl -f > /opt/log.txt
    Copy to clipboard

要验证多重 ROI 功能，请执行以下操作：

1. 将 HDMI 显示器连接到设备。
2. 从 SSH 终端运行以下命令以设置显示器变量：

# export XDG_RUNTIME_DIR=/dev/socket/weston
        # export WAYLAND_DISPLAY=wayland-1
        Copy to clipboard
3. 运行以下 GStreamer 命令：

gst-pipeline-app -e qtiqmmfsrc input-roi-enable=true video_0::type=preview \
        video_1::type=preview video_2::type=preview video_3::type=preview video_0::reprocess-enable=true \
        name=camsrc ! video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1 ! \
        queue ! waylandsink x=0 y=0 width=959 height=540 qos=false sync=false async=true \
        camsrc. ! video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1 ! \
        queue ! waylandsink x=960 y=0 width=960 height=540 qos=false sync=false async=true \
        camsrc. ! video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1 ! \
        queue ! waylandsink x=0 y=540 width=960 height=540 qos=false sync=false async=true \
        camsrc. ! video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1 ! \
        queue ! waylandsink x=960 y=540 width=960 height=540 qos=false sync=false async=true
        Copy to clipboard
4. 选择 **(1) READY**。
5. 选择 **(3) PLAYING**。按下 **Enter**。
6. 选择 **(p) Plugin Mode**。
7. 选择 (**13) camsrc**。您应该看到四个具有完整 FOV 的预览流。
8. 选择 **(32) input-roi-info**。
9. 输入以下内容：

<1920, 0, 1920, 1080, 0, 1080, 1920, 1080, 0, 0, 1920, 1080>
        Copy to clipboard

您应该在 HDMI 上看到一个完整的 FOV 和三个 ROI 流。

要关闭摄像头，选择 **(b) BACK**，然后选择 **(q) QUIT**。

检查以下 UMD 日志，以验证该功能是否已应用于每个流：

cam-server[2810]: CamX: [ INFO]2810 2892 [PPROC ] camxipenode.cpp:2928 FillFrameZoomWindow() ZDBG IPE[3] crop Window [0, 0, 1920, 1080] full size 1920X1080 active 4056X3040, requestId 811 cropType 2 ROI count 3
    cam-server[2810]: CamX: [ INFO]2810 2895 [PPROC ] camxipenode.cpp:2928 FillFrameZoomWindow() ZDBG IPE[2] crop Window [0, 1080, 1920, 1080] full size 1920X1080 active 4056X3040, requestId 811 cropType 1 ROI count 3
    cam-server[2810]: CamX: [ INFO]2810 2891 [PPROC ] camxipenode.cpp:2928
     FillFrameZoomWindow() ZDBG IPE[1] crop Window [1920, 0, 1920, 1080] full size 1920X1080 active 4056X3040, requestId 811 cropType 0 ROI count 3
    Copy to clipboard

Note

Full FOV 流 + ROI 流的总带宽需要小于 4K，即 QCS6490 芯片组的最大能力。

Last Published: May 06, 2025

[Previous Topic
高级功能并发](https://docs.qualcomm.com/bundle/publicresource/80-70018-17SC/topics/advanced-feature-concurrences.md) [Next Topic
自动切换 Linear 与 SHDR 模式](https://docs.qualcomm.com/bundle/publicresource/80-70018-17SC/topics/auto-linear-vs-shdr-mode-switch.md)