# 视频叠加用例 Source: [https://docs.qualcomm.com/doc/80-70020-50SC/topic/overlay-use-cases.html](https://docs.qualcomm.com/doc/80-70020-50SC/topic/overlay-use-cases.html) 该 pipeline 展示了视频叠加的用例。这些用例使用 [qtivoverlay](https://docs.qualcomm.com/doc/80-70020-50SC/topic/qtioverlay.html) 插件的 *overlay-mask* 属性中的 `dest-rect` 属性坐标。在运行用例之前，请确保完成[运行多媒体用例](https://docs.qualcomm.com/doc/80-70020-50SC/topic/multimedia-use-cases.html)中提到的先决条件。 Note: 以下用例中的命令使用 720p 分辨率。要更改分辨率，请在该分辨率的命令中更新相应的 `dest-rect`属性坐标。关于更多详细信息，请参阅[qtivoverlay](https://docs.qualcomm.com/doc/80-70020-50SC/topic/qtioverlay.html)。 ## 用户文本叠加 Source: [https://docs.qualcomm.com/doc/80-70020-50SC/topic/overlay-use-cases.html](https://docs.qualcomm.com/doc/80-70020-50SC/topic/overlay-use-cases.html) 该用例展示了如何在视频流上叠加文本。 - 叠加在视频上： setprop persist.overlay.use_c2d_blit 2Copy to clipboard gst-launch-1.0 filesrc location=/opt/Animals_000_720p_180s_30FPS.mp4 ! qtdemux ! queue ! h264parse ! v4l2h264dec capture-io-mode=4 output-io-mode=4 ! qtioverlay overlay-text="text0, text=\"Qualcomm\ Intelligence\", color=(uint)0xFFFF00FF, dest-rect=<160, 624, 944, 50>;" ! waylandsink fullscreen=trueCopy to clipboard Figure : 在视频上叠加文本的 pipeline – 文件源 - 覆盖来自摄像头的实时流： setprop persist.overlay.use_c2d_blit 2Copy to clipboard gst-launch-1.0 -e qtiqmmfsrc name=camsrc video_0::type=video video_1::type=preview ! video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1 ! qtioverlay overlay-text="text0, text=\"Qualcomm\ Intelligence\", color=(uint)0xFFFF00FF, dest-rect=<160, 624, 944, 50>;" ! waylandsink fullscreen=trueCopy to clipboard Figure : 在视频上叠加文本的 pipeline – 摄像头源 ## 日期和时间叠加 Source: [https://docs.qualcomm.com/doc/80-70020-50SC/topic/overlay-use-cases.html](https://docs.qualcomm.com/doc/80-70020-50SC/topic/overlay-use-cases.html) 该用例展示了将日期（以 MMDDYYYY 为格式）和时间（以 HHMMSS 为格式）叠加到视频流的过程。 - 叠加在视频上： setprop persist.overlay.use_c2d_blit 2Copy to clipboard gst-launch-1.0 filesrc location=/opt/.mp4 ! qtdemux ! queue ! h264parse ! v4l2h264dec capture-io-mode=4 output-io-mode=4 ! qtioverlay overlay-date="date0, date-format=\"MMDDYYYY\", time-format=\"HHMMSS_24HR\", color=(uint)0xFF00FFFF, dest-rect=<400, 400, 256, 80>;" ! waylandsink fullscreen=trueCopy to clipboard Figure : 在视频上叠加文本日期和时间的 pipeline - 文件源 - 覆盖来自摄像头的实时流： setprop persist.overlay.use_c2d_blit 2Copy to clipboard gst-launch-1.0 -e qtiqmmfsrc name=camsrc video_0::type=video video_1::type=preview ! video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1 ! qtioverlay overlay-date="date0, date-format=\"MMDDYYYY\", time-format= \"HHMMSS_24HR\", color=(uint)0xFF00FFFF, dest-rect=<400, 400, 256, 80>;" ! waylandsink fullscreen=trueCopy to clipboard Figure : 在视频上叠加文本日期和时间的 pipeline - 摄像头源 ## 静态图像叠加 Source: [https://docs.qualcomm.com/doc/80-70020-50SC/topic/overlay-use-cases.html](https://docs.qualcomm.com/doc/80-70020-50SC/topic/overlay-use-cases.html) 该用例展示了如何在视频流上叠加静态图像。 1. 将静态图像推送到设备： scp -r .rgba root@[DEVICE IP-ADDR]:/optCopy to clipboard 2. 运行用例： - 叠加在视频上： setprop persist.overlay.use_c2d_blit 2Copy to clipboard gst-launch-1.0 filesrc location=/opt/.mp4 ! qtdemux ! queue ! h264parse ! v4l2h264dec capture-io-mode=4 output-io-mode=4 ! qtioverlay overlay-simg="image0, image=\"/opt/overlay_test_464_109.rgba\", resolution=<464, 109>, dest-rect=<140, 130, 464, 109>;" ! waylandsink fullscreen=trueCopy to clipboard Figure : 在视频上叠加静态图像的 pipeline - 文件源 - 覆盖来自摄像头的实时流： setprop persist.overlay.use_c2d_blit 2Copy to clipboard gst-launch-1.0 -e qtiqmmfsrc name=camsrc video_0::type=video video_1::type=preview ! video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1 ! qtioverlay overlay-simg="image0, image=\"/opt/overlay_test_464_109.rgba\", resolution=<464, 109>, dest-rect=<140, 130, 464, 109>;" ! waylandsink fullscreen=trueCopy to clipboard Figure : 在视频上叠加静态图像的 pipeline - 摄像头源 ## 边界框叠加 Source: [https://docs.qualcomm.com/doc/80-70020-50SC/topic/overlay-use-cases.html](https://docs.qualcomm.com/doc/80-70020-50SC/topic/overlay-use-cases.html) 该用例展示了如何在视频流上叠加带标签的边界框。 - 叠加在视频上： setprop persist.overlay.use_c2d_blit 2Copy to clipboard gst-launch-1.0 -e qtiqmmfsrc name=camsrc video_0::type=video video_1::type=preview ! video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1 ! qtioverlay overlay-simg="image0, image=\"/opt/overlay_test_464_109.rgba\", resolution=<464, 109>, dest-rect=<140, 130, 464, 109>;" ! waylandsink fullscreen=trueCopy to clipboard Figure : 在视频上叠加边界框的 pipeline - 文件源 - 覆盖来自摄像头的实时流： setprop persist.overlay.use_c2d_blit 2Copy to clipboard gst-launch-1.0 -e qtiqmmfsrc name=camsrc video_0::type=video video_1::type=preview ! video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1 ! qtioverlay overlay-simg="image0, image=\"/opt/overlay_test_464_109.rgba\", resolution=<464, 109>, dest-rect=<140, 130, 464, 109>;" ! waylandsink fullscreen=trueCopy to clipboard Figure : 在视频上叠加边界框的 pipeline - 摄像头源 ## 反向隐私遮罩 Source: [https://docs.qualcomm.com/doc/80-70020-50SC/topic/overlay-use-cases.html](https://docs.qualcomm.com/doc/80-70020-50SC/topic/overlay-use-cases.html) 该用例展示了如何在视频流上叠加反向隐私遮罩。反向隐私遮罩应用于除 *overlay-mask* 属性中的 *circle* 之外的所有其他区域。 - 叠加在视频上： setprop persist.overlay.use_c2d_blit 2Copy to clipboard gst-launch-1.0 -e qtiqmmfsrc name=camsrc video_0::type=video video_1::type=preview ! video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1 ! qtioverlay overlay-simg="image0, image=\"/opt/overlay_test_464_109.rgba\", resolution=<464, 109>, dest-rect=<140, 130, 464, 109>;" ! waylandsink fullscreen=trueCopy to clipboard Figure : 在视频上叠加反向隐私遮罩的 pipeline - 文件源 - 覆盖来自摄像头的实时流： setprop persist.overlay.use_c2d_blit 2Copy to clipboard gst-launch-1.0 -e qtiqmmfsrc ! video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1 ! qtioverlay overlay-mask="mask0, circle=<960, 540, 400>, inverse=true, dest-rect=<0, 0, 1920, 1080>, color=0x202020FF" ! waylandsink fullscreen=trueCopy to clipboard Figure : 在视频上叠加反向隐私遮罩的 pipeline - 摄像头源 ## 非反向隐私遮罩 Source: [https://docs.qualcomm.com/doc/80-70020-50SC/topic/overlay-use-cases.html](https://docs.qualcomm.com/doc/80-70020-50SC/topic/overlay-use-cases.html) 该用例展示了如何在视频流上叠加非反向隐私遮罩。 - 叠加在视频上： setprop persist.overlay.use_c2d_blit 2Copy to clipboard gst-launch-1.0 filesrc location=/opt/.mp4 ! qtdemux ! queue ! h264parse ! v4l2h264dec capture-io-mode=4 output-io-mode=4 ! qtioverlay overlay-mask="mask0, circle=<640, 360, 200>, dest-rect=<0, 0, 1280, 720>, color=0x202020FF" ! waylandsink fullscreen=trueCopy to clipboard Figure : 在视频上叠加非反向隐私遮罩的 pipeline - 文件源 - 覆盖来自摄像头的实时流： setprop persist.overlay.use_c2d_blit 2Copy to clipboard gst-launch-1.0 -e qtiqmmfsrc ! video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1 ! qtioverlay overlay-mask="mask0, circle=<960, 540, 400>, dest-rect=<0, 0, 1920, 1080>, color=0x202020FF" ! waylandsink fullscreen=trueCopy to clipboard Figure : 在视频上叠加非反向隐私遮罩的 pipeline - 摄像头源 ## 多边形隐私遮罩 Source: [https://docs.qualcomm.com/doc/80-70020-50SC/topic/overlay-use-cases.html](https://docs.qualcomm.com/doc/80-70020-50SC/topic/overlay-use-cases.html) 多边形隐私遮罩允许您使用多边形形状在图像上创建隐私区域。使用多边形可使遮罩效果更平滑、更精确。 - 多边形隐私遮罩应用于多边形内封闭的区域。 - 逆多边形隐私遮罩应用于除多边形内封闭区域之外的所有区域。在开始之前，请配置显示： export XDG_RUNTIME_DIR=/dev/socket/weston && export WAYLAND_DISPLAY=wayland-1Copy to clipboard setprop persist.overlay.use_c2d_blit 2Copy to clipboard ### 启用多边形隐私遮罩 - 文件源： gst-launch-1.0 filesrc location=/opt/.mp4 ! qtdemux ! queue ! h264parse ! v4l2h264dec capture-io-mode=4 output-io-mode=4 ! qtioverlay overlay-mask="mask0, polygon=<5, <360, 640, 780, 500, 300>, <360, 540, 180, 180, 100>>, dest-rect=<0, 0, 1280, 720>, color=0x202020FF" ! waylandsink fullscreen=trueCopy to clipboard - 摄像头： gst-launch-1.0 -e qtiqmmfsrc ! video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1 ! qtioverlay overlay-mask="mask0, polygon=<5, <360, 640, 780, 500, 300>, <360, 540, 180, 180, 100>>, dest-rect=<0, 0, 1920, 1080>, color=0x202020FF" ! waylandsink fullscreen=trueCopy to clipboard ### 启用反多边形隐私遮罩 - 文件源： gst-launch-1.0 filesrc location=/opt/.mp4 ! qtdemux ! queue ! h264parse ! v4l2h264dec capture-io-mode=4 output-io-mode=4 ! qtioverlay overlay-mask="mask0, polygon=<3, <360, 640, 780>, <360, 540, 180>>, inverse=true, dest-rect=<0, 0, 1280, 720>, color=0x202020FF" ! waylandsink fullscreen=trueCopy to clipboard - 摄像头： gst-launch-1.0 -e qtiqmmfsrc ! video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1 ! qtioverlay overlay-mask="mask0, polygon=<3, <360, 640, 780>, <360, 540, 180>>, inverse=true, dest-rect=<0, 0, 1920, 1080>, color=0x202020FF" ! waylandsink fullscreen=trueCopy to clipboard ### 在 runtime 更新多边形隐私遮罩属性 1. 设置隐私遮罩： gst-pipeline-app -e qtiqmmfsrc ! video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1 ! qtioverlay overlay-mask="mask0, polygon=<7, <360, 640, 780, 640, 500, 360, 180>, <360, 360, 180, 120, 200, 120, 180>>, inverse=true, dest-rect=<0, 0, 1920, 1080>, color=0x202020FF" ! waylandsink fullscreen=trueCopy to clipboard 2. 在 pipeline 控件中，选择 `Playing mode - 3`。 3. 要更改 pipeline 控件中的属性，请选择 `Plugin mode - p`。 4. 从插件中选择 `overlay - 2`。 5. 在插件属性中，选择 `overlay-mask - 4`。 6. 添加以下值： mask0, polygon=<5, <360, 640, 780, 500, 300>, <360, 540, 180, 180, 100>>, inverse=true, dest-rect=<0, 0, 1920, 1080>, color=0x202020FFCopy to clipboard Last Published: Jul 23, 2025 [Previous Topic 视频合成用例](https://docs.qualcomm.com/bundle/publicresource/80-70020-50SC/topics/video-composition.md) [Next Topic 视频分割用例](https://docs.qualcomm.com/bundle/publicresource/80-70020-50SC/topics/video-split-use-cases.md)