DisplayMask 通道蒙版提取与灰度遮罩可视化节点
节点核心功能 (What is it?)
DisplayMask 节点通过从输入图像中提取特定通道（红色 Red、绿色 Green、蓝色 Blue 或透明度通道 Alpha），生成对应的可视化单通道灰度蒙版。蒙版以 8 位灰阶图像呈现——纯白区域代表完全不透明（或该色彩通道最高亮度 255），纯黑区域代表完全透明（或该通道零亮度 0）。它是分析色彩分布、提取抠图透明遮罩以及构建局部重绘选区的关键工具。
典型适用场景 (When would I use it?)
在以下情况下使用该节点：
- 从包含抠图信息的透明图层中提取纯粹的 Alpha 透明度遮罩；
- 独立提取红、绿、蓝单色通道作为选区遮罩；
- 为后续的图像局部合成与扩散模型修复（Inpainting）管线生成黑白蒙版；
- 在画布上直观分析各通道的灰阶分布；
- 排查抠图边缘噪点或色彩通道溢出等质量问题。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 DisplayMask 节点。
- 将源图像接入
input_image输入插槽。 - 从
channel下拉菜单中选择目标通道（默认为"alpha"）。 - 在
output_mask引脚即可提取抽取完成的单通道灰度蒙版工件。
参数输入插槽 (Parameters)
- input_image：用于提取通道蒙版的源图像资产。
- channel：待提取的目标通道选项：
- alpha（默认）：提取透明度通道，直观显示图像的实心与镂空区域；
- red：提取红色通道分量，用于隔离红光高亮与肤色区域；
- green：提取绿色通道分量，常用于植物与草地选区隔离；
- blue：提取蓝色通道分量，常用于天空与水体选区隔离。
输出引脚 (Outputs)
- output_mask：由所选通道数值映射生成的标准化 8 位单通道灰度蒙版工件（
ImageArtifact）。
典型工作流示例 (Example)
从抠图主体中提取蒙版并进行反向反转：
- 使用扣背节点输出一张带透明背景的角色肖像。
- 将其连入
DisplayMask节点的input_image参数。 - 将
channel保持为"alpha"。 - 节点立即提取出角色为纯白、背景为纯黑的精准单通道蒙版。
- 将
output_mask连入InvertMask即可获得背景为白、角色为黑的反选蒙版。
关键技术特性 (Important Notes)
- 单通道灰阶映射 (Grayscale Output)：选定通道的值直接线性映射为 $[0, 255]$ 灰阶空间，数值越高越亮白。
- 全格式兼容 (Image Mode Support)：全面支持 RGB、RGBA、单通道灰度（L）及带透明度的灰度（LA）格式。
- RGB 图层 Alpha 回退机制：若输入的是不包含透明通道的普通三通道 RGB 图像却选择了
"alpha"，节点会自动平滑回退至红色（Red）通道，避免计算崩溃。 - 无损 PNG 固化：蒙版统一以无损 PNG 保存，避免由于有损压缩产生噪点毛刺。
常见问题与排查 (Common Issues)
- 蒙版全黑：表明所选通道在整幅画面中数值极低或无有效信号（例如在纯绿纯蓝画面中提取红色通道）。
- 蒙版全白：表明所选通道处于饱和状态（例如对完全不透明的纯色图提取 Alpha 通道）。
- 无输出工件：检查输入插槽是否已成功建立图像数据流连线。