# 多边形隐私掩码

Source: [https://docs.qualcomm.com/doc/80-70015-50SC/topic/polygon-privacy-mask.html](https://docs.qualcomm.com/doc/80-70015-50SC/topic/polygon-privacy-mask.html)

多边形隐私掩码使您能够使用多边形在图像上创建隐私区域。使用多边形可以使掩码更平滑、更准确。

- 多边形隐私掩码将应用于多边形内的封闭区域。
- 反转向多边形隐私掩码将应用于除多边形内的封闭区域之外的所有区域。

在开始之前，应配置显示：

    export XDG_RUNTIME_DIR=/dev/socket/weston && export WAYLAND_DISPLAY=wayland-1Copy to clipboard

    setprop persist.overlay.use_c2d_blit 2Copy to clipboard

## 启用多边形隐私掩码

- Filesrc：

        gst-launch-1.0 filesrc location=/opt/<input_file>.mp4 ! qtdemux ! queue ! h264parse !  v4l2h264dec capture-io-mode=5 output-io-mode=5 ! 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\(memory:GBM\),format=NV12,width=1920,height=1080,framerate=30/1,compression=ubwc ! 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

## 启用反向多边形隐私掩码

- Filesrc：

        gst-launch-1.0 filesrc location=/opt/<input_file>.mp4 ! qtdemux ! queue ! h264parse ! v4l2h264dec capture-io-mode=5 output-io-mode=5 ! 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\(memory:GBM\),format=NV12,width=1920,height=1080,framerate=30/1,compression=ubwc ! 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\(memory:GBM\),format=NV12,width=1920,height=1080,framerate=30/1,compression=ubwc ! 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

**Parent Topic:** [视频叠加用例](https://docs.qualcomm.com/doc/80-70015-50SC/topic/overlay-use-cases.html)

Last Published: Nov 11, 2025

[Previous Topic
非反向隐私掩码](https://docs.qualcomm.com/bundle/publicresource/80-70015-50SC/topics/non-inverse-privacy-mask.md) [Next Topic
视频分割用例](https://docs.qualcomm.com/bundle/publicresource/80-70015-50SC/topics/video-split-use-cases.md)