内置节点参考
MediaPipeFaceMask - ComfyUI Built-in Node Documentation
Complete documentation for the MediaPipeFaceMask node in ComfyUI. Learn its inputs, outputs, parameters and usage.
## 概述
此节点基于 MediaPipe 检测到的面部特征点创建二值掩码（黑白图像）。它会为每个检测到的面部区域绘制填充多边形，在批次中为每一帧生成一个掩码。当同一帧中检测到多张人脸时，这些掩码会被合并为单个掩码。
## 输入
| 参数 | 描述 | 数据类型 | 是否必需 | 取值范围 |
|---|---|---|---|---|
face_landmarks |
来自 MediaPipe 面部检测节点的面部特征点数据。 | FACE_LANDMARKS | 是 | - |
regions |
选择要包含在掩码中的面部区域。"all" 会从所有面部区域（面部轮廓、嘴唇、眼睛、虹膜）的并集创建掩码。"custom" 允许您单独切换每个区域。默认值："all" |
COMBO | 是 | "all" |
"custom" |
当 regions 设置为 "custom" 时，以下额外的布尔参数将变为可用：
| 参数 | 描述 | 数据类型 | 是否必需 | 取值范围 |
|---|---|---|---|---|
face_oval |
在掩码中包含面部轮廓区域。默认值：True | BOOLEAN | 否 | True/False |
lips |
在掩码中包含嘴唇区域。默认值：True | BOOLEAN | 否 | True/False |
eyes |
在掩码中包含眼睛区域。默认值：True | BOOLEAN | 否 | True/False |
irises |
在掩码中包含虹膜区域。默认值：True | BOOLEAN | 否 | True/False |
注意： 使用 "all" 模式时，掩码包含所有区域的组合。由于面部轮廓区域包含其他区域，选择 "all" 实际上会产生与仅选择面部轮廓相同的结果。
## 输出
| 输出名称 | 描述 | 数据类型 |
|---|---|---|
MASK |
一个二值掩码张量，其中面部区域为白色（值 1.0），背景为黑色（值 0.0）。该掩码具有与输入图像相同的尺寸，并且批次中每一帧对应一个掩码。 | MASK |
本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑
Source fingerprint (SHA-256): 92270002a42ed59bc75e676a6881e1899186d3c8a1bb4dd4c0d39b3762b5bb66
官方原文
本页来自 Comfy-Org 官方中文文档的固定版本，并转换为 xueai 静态页面。内容以官方持续更新的页面为准。