跳转至

ApplyMask 蒙版通道应用与 Alpha 透明度压合节点

节点核心功能 (What is it?)

ApplyMask 节点将输入的遮罩蒙版压合至目标图像上，生成具备精准透明度（Alpha 通道）的复合图层。它接收一张底图和一个蒙版对象，提取蒙版中指定的通道分量（红、绿、蓝或 Alpha），并将其直接绑定为最终图像的 Alpha 透明度遮罩，从而实现精准的局部镂空、去背与半透明合成。

典型适用场景 (When would I use it?)

在以下情况下使用该节点：

  • 利用黑白或单通道蒙版为图像赋予物理透明背景（抠图透出）；
  • 在多图层图形合成中实现选择性的半透明与渐隐过渡；
  • 将前序节点（如 DisplayMask、PaintMask、InvertMask 等）生成的选区精准作用于原图；
  • 制作广告主体贴图、游戏 UI 精灵图或透明贴片；
  • 精细控制以蒙版的哪个具体色彩通道作为透明度的物理映射源。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

  1. 在工作流画布中添加 ApplyMask 节点。
  2. 将底图数据源接入 input_image 输入插槽。
  3. 将蒙版数据源接入 input_mask 输入插槽。
  4. 在 channel 下拉菜单中选择蒙版所对应的源通道（默认为 "red"）。
  5. 在 output 引脚即可提取完成透明通道压合的全新 RGBA 图像。

参数输入插槽 (Parameters)

  • input_image：准备接受蒙版作用的源图像工件。
  • input_mask：用作透明度基准的蒙版图像工件。
  • channel：从蒙版图像中提取作为 Alpha 透明度的通道分量：
    • red（默认）：提取红色通道（完美适配 PaintMask 节点的手绘输出）；
    • green：提取绿色通道；
    • blue：提取蓝色通道；
    • alpha：提取原蒙版自带的 Alpha 通道（若蒙版图本身为 RGBA 格式）。

输出引脚 (Outputs)

  • output：原图像应用蒙版后输出的全新 RGBA 透明通道图像资产（ImageArtifact）。

典型工作流示例 (Example)

手绘微调蒙版并抠出透明主体：

  1. 使用 LoadImage 导入一张待抠图照片。
  2. 将照片接入 PaintMask 节点，使用画笔修除杂质并输出蒙版。
  3. 将原照片连接至 ApplyMask 的 input_image 参数。
  4. 将 PaintMask 的输出蒙版连接至 ApplyMask 的 input_mask 参数。
  5. 将 channel 保持为默认的 "red"（因为 PaintMask 将绘制层保存在红色通道）。
  6. ApplyMask 瞬间输出背景完全镂空透明的干净主体图，可连接至 DisplayImage 或下游合成图层。

关键技术特性 (Important Notes)

  • 通道适配最佳实践：
    • 若接收来自 PaintMask 的输出，务必选用 red 通道；
    • 若接收原生带有 Alpha 透明背景的 PNG 遮罩，选用 alpha 通道；
    • 若接收单通道纯灰度图（L 模式），节点直接提取灰度亮度，忽略通道选项。
  • 几何尺寸自适应 (Automatic Resizing)：若蒙版与原图的宽高尺寸存在微小差异，节点会在内存中自动将蒙版重采样缩放至与原图绝对吻合的物理像素。
  • 全通道 RGBA 固化：输出统一转化为支持真彩半透明的 RGBA 格式，并以无损 PNG 编码交付。

常见问题与排查 (Common Issues)

  • 透明度反了（主体变透明，背景被保留）：蒙版的明暗逻辑为“白保留、黑镂空”；若相反，只需在 input_mask 前级串接一个 InvertMask 节点进行反转。
  • 透明度没有生效：检查 channel 是否选错（例如对不包含 Alpha 通道的 RGB 蒙版误选了 "alpha"）。

底层技术执行机制 (Technical Details)

节点基于 Pillow 底层标准图形管线运行：

  1. 通道分离：从蒙版中分离出指定的 8-bit 单通道灰阶矩阵；
  2. 尺寸对齐：使用插值核将该矩阵拉伸至与输入图像宽高完全一致；
  3. Alpha 通道压制：调用底层 image.putalpha(channel) 方法，将该灰阶图直接注入原图的第 4 通道，构建无损透明 RGBA 对象。