# 视频叠加用例 Source: [https://docs.qualcomm.com/doc/80-70022-50SC/topic/overlay-use-cases.html](https://docs.qualcomm.com/doc/80-70022-50SC/topic/overlay-use-cases.html) 该 pipeline 展示了视频叠加的用例。这些用例使用 [qtivoverlay](https://docs.qualcomm.com/doc/80-70022-50SC/topic/qtioverlay.html) 插件的 *overlay-mask* 属性中的 `dest-rect` 属性坐标。 在运行用例之前，请确保完成 [GStreamer 命令行用例](https://docs.qualcomm.com/doc/80-70022-50SC/topic/gstreamer-application-use-cases.html)中提到的先决条件。 Note: 以下用例中的命令使用 720p 分辨率。要更改分辨率，请在该分辨率的命令中更新相应的 `dest-rect`属性坐标。关于更多详细信息，请参阅 [qtivoverlay](https://docs.qualcomm.com/doc/80-70022-50SC/topic/qtioverlay.html)。 ## 用户文本叠加 Source: [https://docs.qualcomm.com/doc/80-70022-50SC/topic/overlay-use-cases.html](https://docs.qualcomm.com/doc/80-70022-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 – 文件源 pipeline_textoverlay_video_file Sheet.3 GST BIN GST BIN Sheet.4 Sheet.15 h264parse h264parse Sheet.17 Sheet.18 Sheet.19 Sheet.20 Sheet.21 Sheet.22 Sheet.24 v4l2h264dec v4l2h264dec Sheet.26 Sheet.27 Sheet.28 Sheet.30 qtioverlay qtioverlay Sheet.32 Sheet.33 Sheet.34 Sheet.36 Waylandsink Waylandsink Sheet.39 filesrc filesrc Sheet.41 Sheet.42 Sheet.43 Sheet.45 qtdemux qtdemux Sheet.48 Sheet.7 Qualcomm Qualcomm Sheet.8 Sheet.10 开源 开源 Sheet.11 - 覆盖来自摄像头的实时流： 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 – 摄像头源 pipeline_textoverlay_video_cams Sheet.3 GST BIN GST BIN Sheet.4 Sheet.15 qtioverlay qtioverlay Sheet.18 Sheet.19 Sheet.21 Sheet.22 Sheet.24 Waylandsink Waylandsink Sheet.27 camsrc camsrc Sheet.32 Sheet.8 Qualcomm Qualcomm Sheet.9 Sheet.11 开源 开源 Sheet.12 ## 日期和时间叠加 Source: [https://docs.qualcomm.com/doc/80-70022-50SC/topic/overlay-use-cases.html](https://docs.qualcomm.com/doc/80-70022-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 - 文件源 pipeline_textoverlay_video_file Sheet.3 GST BIN GST BIN Sheet.4 Sheet.15 h264parse h264parse Sheet.17 Sheet.18 Sheet.19 Sheet.20 Sheet.21 Sheet.22 Sheet.24 v4l2h264dec v4l2h264dec Sheet.26 Sheet.27 Sheet.28 Sheet.30 qtioverlay qtioverlay Sheet.32 Sheet.33 Sheet.34 Sheet.36 Waylandsink Waylandsink Sheet.39 filesrc filesrc Sheet.41 Sheet.42 Sheet.43 Sheet.45 qtdemux qtdemux Sheet.48 Sheet.7 Qualcomm Qualcomm Sheet.8 Sheet.10 开源 开源 Sheet.11 - 覆盖来自摄像头的实时流： 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 - 摄像头源 pipeline_textoverlay_video_cams Sheet.3 GST BIN GST BIN Sheet.4 Sheet.15 qtioverlay qtioverlay Sheet.18 Sheet.19 Sheet.21 Sheet.22 Sheet.24 Waylandsink Waylandsink Sheet.27 camsrc camsrc Sheet.32 Sheet.8 Qualcomm Qualcomm Sheet.9 Sheet.11 开源 开源 Sheet.12 ## 静态图像叠加 Source: [https://docs.qualcomm.com/doc/80-70022-50SC/topic/overlay-use-cases.html](https://docs.qualcomm.com/doc/80-70022-50SC/topic/overlay-use-cases.html) 该用例展示了如何在视频流上叠加静态图像。 1. 在 Linux 主机的终端中，运行以下命令将静态图像推送到目标设备： 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 - 文件源 pipeline_textoverlay_video_file Sheet.3 GST BIN GST BIN Sheet.4 Sheet.15 h264parse h264parse Sheet.17 Sheet.18 Sheet.19 Sheet.20 Sheet.21 Sheet.22 Sheet.24 v4l2h264dec v4l2h264dec Sheet.26 Sheet.27 Sheet.28 Sheet.30 qtioverlay qtioverlay Sheet.32 Sheet.33 Sheet.34 Sheet.36 Waylandsink Waylandsink Sheet.39 filesrc filesrc Sheet.41 Sheet.42 Sheet.43 Sheet.45 qtdemux qtdemux Sheet.48 Sheet.7 Qualcomm Qualcomm Sheet.8 Sheet.10 开源 开源 Sheet.11 - 覆盖来自摄像头的实时流： 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 - 摄像头源 pipeline_textoverlay_video_cams Sheet.3 GST BIN GST BIN Sheet.4 Sheet.15 qtioverlay qtioverlay Sheet.18 Sheet.19 Sheet.21 Sheet.22 Sheet.24 Waylandsink Waylandsink Sheet.27 camsrc camsrc Sheet.32 Sheet.8 Qualcomm Qualcomm Sheet.9 Sheet.11 开源 开源 Sheet.12 ## 边界框叠加 Source: [https://docs.qualcomm.com/doc/80-70022-50SC/topic/overlay-use-cases.html](https://docs.qualcomm.com/doc/80-70022-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-bbox="bbox0, bbox=<140, 130, 100, 100>, label="Pet", color=0x0000FFFF;" ! waylandsink fullscreen=trueCopy to clipboard Figure : 在视频上叠加边界框的 pipeline - 文件源 pipeline_textoverlay_video_file Sheet.3 GST BIN GST BIN Sheet.4 Sheet.15 h264parse h264parse Sheet.17 Sheet.18 Sheet.19 Sheet.20 Sheet.21 Sheet.22 Sheet.24 v4l2h264dec v4l2h264dec Sheet.26 Sheet.27 Sheet.28 Sheet.30 qtioverlay qtioverlay Sheet.32 Sheet.33 Sheet.34 Sheet.36 Waylandsink Waylandsink Sheet.39 filesrc filesrc Sheet.41 Sheet.42 Sheet.43 Sheet.45 qtdemux qtdemux Sheet.48 Sheet.7 Qualcomm Qualcomm Sheet.8 Sheet.10 开源 开源 Sheet.11 - 覆盖来自摄像头的实时流： 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,compression=ubwc ! qtioverlay overlay-bbox="bbox0, bbox=<140, 130, 100, 100>, label="Pet", color=0x0000FFFF;" ! waylandsink fullscreen=trueCopy to clipboard Figure : 在视频上叠加边界框的 pipeline - 摄像头源 pipeline_textoverlay_video_cams Sheet.3 GST BIN GST BIN Sheet.4 Sheet.15 qtioverlay qtioverlay Sheet.18 Sheet.19 Sheet.21 Sheet.22 Sheet.24 Waylandsink Waylandsink Sheet.27 camsrc camsrc Sheet.32 Sheet.8 Qualcomm Qualcomm Sheet.9 Sheet.11 开源 开源 Sheet.12 ## 反向隐私遮罩 Source: [https://docs.qualcomm.com/doc/80-70022-50SC/topic/overlay-use-cases.html](https://docs.qualcomm.com/doc/80-70022-50SC/topic/overlay-use-cases.html) 该用例展示了如何在视频流上叠加反向隐私遮罩。 反向隐私遮罩应用于除 *overlay-mask* 属性中的 *circle* 之外的所有其他区域。 在目标设备上运行以下用例： - 叠加在视频上： 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=<960, 540, 400>, inverse=false, dest-rect=<0, 0, 1920, 1080>, color=0x202020FF" ! waylandsink fullscreen=trueCopy to clipboard Figure : 在视频上叠加反向隐私遮罩的 pipeline - 文件源 pipeline_textoverlay_video_file Sheet.3 GST BIN GST BIN Sheet.4 Sheet.15 h264parse h264parse Sheet.17 Sheet.18 Sheet.19 Sheet.20 Sheet.21 Sheet.22 Sheet.24 v4l2h264dec v4l2h264dec Sheet.26 Sheet.27 Sheet.28 Sheet.30 qtioverlay qtioverlay Sheet.32 Sheet.33 Sheet.34 Sheet.36 Waylandsink Waylandsink Sheet.39 filesrc filesrc Sheet.41 Sheet.42 Sheet.43 Sheet.45 qtdemux qtdemux Sheet.48 Sheet.7 Qualcomm Qualcomm Sheet.8 Sheet.10 开源 开源 Sheet.11 - 覆盖来自摄像头的实时流： 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=false, dest-rect=<0, 0, 1920, 1080>, color=0x202020FF" ! waylandsink fullscreen=trueCopy to clipboard Figure : 在视频上叠加反向隐私遮罩的 pipeline - 摄像头源 pipeline_textoverlay_video_cams Sheet.3 GST BIN GST BIN Sheet.4 Sheet.15 qtioverlay qtioverlay Sheet.18 Sheet.19 Sheet.21 Sheet.22 Sheet.24 Waylandsink Waylandsink Sheet.27 camsrc camsrc Sheet.32 Sheet.8 Qualcomm Qualcomm Sheet.9 Sheet.11 开源 开源 Sheet.12 ## 非反向隐私遮罩 Source: [https://docs.qualcomm.com/doc/80-70022-50SC/topic/overlay-use-cases.html](https://docs.qualcomm.com/doc/80-70022-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 - 文件源 pipeline_textoverlay_video_file Sheet.3 GST BIN GST BIN Sheet.4 Sheet.15 h264parse h264parse Sheet.17 Sheet.18 Sheet.19 Sheet.20 Sheet.21 Sheet.22 Sheet.24 v4l2h264dec v4l2h264dec Sheet.26 Sheet.27 Sheet.28 Sheet.30 qtioverlay qtioverlay Sheet.32 Sheet.33 Sheet.34 Sheet.36 Waylandsink Waylandsink Sheet.39 filesrc filesrc Sheet.41 Sheet.42 Sheet.43 Sheet.45 qtdemux qtdemux Sheet.48 Sheet.7 Qualcomm Qualcomm Sheet.8 Sheet.10 开源 开源 Sheet.11 - 覆盖来自摄像头的实时流： 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 - 摄像头源 pipeline_textoverlay_video_cams Sheet.3 GST BIN GST BIN Sheet.4 Sheet.15 qtioverlay qtioverlay Sheet.18 Sheet.19 Sheet.21 Sheet.22 Sheet.24 Waylandsink Waylandsink Sheet.27 camsrc camsrc Sheet.32 Sheet.8 Qualcomm Qualcomm Sheet.9 Sheet.11 开源 开源 Sheet.12 ## 多边形隐私遮罩 Source: [https://docs.qualcomm.com/doc/80-70022-50SC/topic/overlay-use-cases.html](https://docs.qualcomm.com/doc/80-70022-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: Nov 05, 2025 [Previous Topic 视频合成用例](https://docs.qualcomm.com/bundle/publicresource/80-70022-50SC/topics/video-composition.md) [Next Topic 视频分割用例](https://docs.qualcomm.com/bundle/publicresource/80-70022-50SC/topics/video-split-use-cases.md)