ImageBlendCompositor 图层多模式混合与图像合成节点

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

ImageBlendCompositor 节点允许创作者利用专业数字图像软件（如 Photoshop 等）中经典的图层混合模式，将两张图像合成在一起。它提供了针对图像叠放次序、空间坐标偏移（X/Y Offset）、透明度（Opacity）以及高阶空间变形适配的全套控制能力。

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

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

• 使用不同的专业混合模式（Blend Modes）复合双图；
• 构建具备前景与背景深度层次的多图层合成作品；
• 应用电影级的光学与纹理混合视效；
• 对前景贴图实施亚像素级或绝对像素级的精准定位叠放；
• 制作双重曝光（Double Exposure）摄影艺术效果；
• 将光影、灰尘划痕（Grunge）、材质纹理等叠印到主画面上；
• 制作富有创意的图形排版与数字艺术设计。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

1. 在工作流画布中添加 ImageBlendCompositor 节点。
2. 将底图图像源连接至 input_image 插槽，将叠加图像源接入 blend_image 插槽。
3. 选择所需的混合模式（blend_mode）并微调不透明度（opacity）。
4. 在 output 输出引脚即可提取混合合成完毕的图像工件。

参数输入插槽 (Parameters)

图像源输入 (Image Inputs)

• input_image：基底图像（底层背景图层）。
• blend_image：叠加上层图像（顶层前景图层）。

混合属性配置 (Blend Settings)

• blend_mode：底层的色彩光栅化混合模式：
  • normal：标准 Alpha 覆盖混合；
  • multiply（正片叠底）：两图层颜色分量相乘，压暗画面；
  • screen（滤色）：反向相乘后反向，大幅提亮画面，常用于光晕叠加；
  • overlay（叠加）：复合正片叠底与滤色模式，增强画面明暗对比度；
  • soft_light（柔光）：柔和的光照加亮或变暗效果；
  • hard_light（强光）：强烈的明暗对比复合光照；
  • color_dodge（颜色减淡）：大幅增加底图亮度与对比度，营造发光感；
  • color_burn（颜色加深）：通过增加暗部对比度来压暗底图；
  • darken（变暗）：比较两图层像素，仅保留较暗的颜色分量；
  • lighten（变亮）：比较两图层像素，仅保留较亮的颜色分量；
  • difference（差值）：两图层对应像素绝对值相减，用于反差检测或迷幻视效；
  • exclusion（排除）：与差值模式原理类似但过渡对比更加柔和平缓。
• opacity（0.0–1.0，默认 1.0）：前景混合强度（不透明度）：
  • 0.0 = 前景完全透明（完全不发生混合，纯底图显示）；
  • 1.0 = 完全不透明（100% 全强度混合计算）。

空间定位与偏移 (Positioning)

• x_offset（像素，默认 0）：叠加图在基底图上的水平像素偏移量（正数向右，负数向左）。
• y_offset（像素，默认 0）：叠加图在基底图上的垂直像素偏移量（正数向下，负数向上）。

高级合成选项 (Advanced Options)

• resize_blend_to_fit（布尔值，默认 false）：强制缩放叠加图的物理尺寸以完全匹配底图规格。
• preserve_alpha（布尔值，默认 true）：在合成运算中完美保留输入源图原有的透明度通道信息。
• invert_blend（布尔值，默认 false）：在执行混合运算前，先行对叠加图像执行反相操作。

输出引脚 (Outputs)

• output：两图层经过混合模式与空间变换后输出的全新复合图像资产。

典型工作流示例 (Example)

典型的图层压暗与光效叠印流水线：

1. 使用两个 LoadImage 节点分别导入底图风景与前景纹理图。
2. 将风景原图连入 input_image（背景）。
3. 将纹理素材连入 blend_image（前景）。
4. 调优混合参数：
   • 将 blend_mode 设为 "multiply" 以营造斑驳压暗做旧效果；
   • 将 opacity 降至 0.7 实现细腻自然的半透明渗透；
   • 设定 x_offset 为 50，y_offset 为 30 实现前景纹理错位排布。
5. 将 output 接入 DisplayImage 查看胶片质感合成效果。

关键技术特性 (Important Notes)

• 实时响应 (Live Preview)：参数微调即时引发 GPU/CPU 矩阵运算，合成反馈毫秒级。
• 超范围容差定位：叠加图可以被位移超出底图边界，多余边缘会被优雅裁切。
• 全通道 RGBA 支持：完美保留带 Alpha 蒙版通道的抠像贴图，半透明边缘过渡极佳。
• 工业级混合数学公式：严格遵循专业图形软件（Adobe 等）标准的色彩通道计算矩阵。

常见问题与排查 (Common Issues)

• 看不到任何混合效果：检查 opacity 是否误设为 0，或是否在 1.0 不透明度下使用了遮挡全图的 "normal" 模式。
• 叠加图不在画面中：检查 x_offset 与 y_offset 是否设得过大导致前景图被推移到底图可视画框外。
• 合成色彩异常：不同混合模式在极亮或极暗通道下的数学表现截然不同，建议切换模式以找到最符合构图预期的效果。

混合模式数学归类 (Technical Details)

节点支持的所有混合模式底层基于严格的通道色阶计算矩阵（以归一化值 $[0, 1]$ 运算）：

• 代数复合混合 (Mathematical Blends)：multiply、screen、overlay、soft_light、hard_light
• 极端动态调色 (Color Operations)：color_dodge、color_burn、difference、exclusion
• 极值条件比较 (Selection Blends)：darken、lighten
• 经典 Alpha 光栅混合 (Standard Blending)：normal (Porter-Duff Source Over 算法)