> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# VOIDQuadmaskPreprocess - ComfyUI Built-in Node Documentation

> Complete documentation for the VOIDQuadmaskPreprocess node in ComfyUI. Learn its inputs, outputs, parameters and usage.

## 概述

VOIDQuadmaskPreprocess 节点通过将遮罩转换为特殊的四层级“四重遮罩”，为 VOID 修复任务准备遮罩。它接收输入遮罩，可选择性地对主要区域进行膨胀处理，然后将遮罩值量化为四个不同层级，分别代表不同的语义区域（主要物体、重叠区域、受影响区域和背景）。最后，它会对遮罩进行反转和归一化，使输出值落在 \[0, 1] 范围内，其中 1.0 表示要移除的区域，0.0 表示要保留的区域。

## 输入

| 参数             | 描述                                 | 数据类型 | 是否必填 | 范围           |
| -------------- | ---------------------------------- | ---- | ---- | ------------ |
| `mask`         | 待预处理的输入遮罩。                         | MASK | 是    | 不适用          |
| `dilate_width` | 主要遮罩区域的膨胀半径。值为 0 表示不进行膨胀处理。（默认值：0） | INT  | 否    | 0 到 50（步长：1） |

## 输出

| 输出名称       | 描述                                                                                               | 数据类型 |
| ---------- | ------------------------------------------------------------------------------------------------ | ---- |
| `quadmask` | 预处理后的四重遮罩，值域为 \[0, 1]，代表四个离散层级：1.0（要移除的主要物体）、约 0.75（主要物体与受影响区域的重叠部分）、约 0.50（受影响区域）和 0.0（要保留的背景）。 | MASK |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/VOIDQuadmaskPreprocess/zh.md)

***

**Source fingerprint (SHA-256):** `12dc5ab215b80d81289942457ce2ddffcb9ec41fc738a53ca5fbf1e9181ed439`