ColorMatch 色彩迁移与电影级色调匹配节点

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

ColorMatch 节点利用多种先进的统计与几何色彩分布迁移算法，将参考基准图（Reference Image）的色彩特征、影调色板与环境光感精准移植迁移至目标图像（Target Image）中。它是实现自动化电影级调色（Color Grading）、跨镜头光影风格统一、定格动画逐帧闪烁校正以及多图视觉色调统一的核心工业级算子。

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

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

将经典电影剧照的标志性色调无缝迁移至个人摄影作品中；
统一同一项目下由不同模型或不同环境生成的图像素材色板；
消除定格动画（Stop-motion）或连续视频帧因环境光抖动产生的明暗闪烁；
快速试验不同的艺术色调与情绪风格（Mood/Atmosphere Transfer）；
批量处理一组素材使其符合品牌视觉指导手册（Style Guide）的色调要求。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

在画布中添加 ColorMatch 节点。
将提供理想色板的参考图片接入 reference_image 输入插槽。
将待修改色彩的目标图像接入 target_image 输入插槽。
从 method 算法下拉菜单中选择适用的色彩迁移模型。
微调色彩转移强度系数（strength）。
在 output 引脚即可提取色彩重映射后的全新图像。

参数输入插槽 (Parameters)

图像源输入 (Image Inputs)

reference_image：作为色彩调色板提取源的参考图像工件。
target_image：待施加色彩迁移的目标受体图像（尺寸规格由该图完全决定）。

算法与强度设置 (Color Match Settings)

method：底层的色彩分布迁移数学算法模型：
- mkl（Monge-Kantorovich 线性化，默认）：基于最优传输理论（Optimal Transport Theory）匹配全局色彩分布，速度极快且画质均衡自然；
- hm（直方图匹配 Histogram Matching）：独立匹配每个色彩通道的累积直方图，计算极快，适合处理反差适中的图像；
- reinhard（Reinhard 色彩空间迁移）：基于非相关 Lab 色彩空间的经典统计算法，对肤色与自然风光过渡极其平滑自然；
- mvgd（多元高斯分布匹配 Multi-Variate Gaussian Distribution）：匹配色彩分布的均值与协方差矩阵，质感高级；
- hm-mvgd-hm（复合串联算法）：结合直方图与多元高斯分布，画质极佳，运算耗时略长；
- hm-mkl-hm（复合串联替代算法）：结合直方图与 MKL，影视级顶级画质，适合单帧终审级离线渲染。
strength（0.0–10.0，默认 1.0）：色彩迁移应用强度系数。
- 0.0：无任何变化（完全保留原目标图）；
- 1.0：100% 完全色彩迁移；
- > 1.0：超饱和夸张强调迁移风格。

输出引脚 (Outputs)

output：完成了色彩特征迁移注入后的全新图像资产（ImageArtifact）。

典型工作流示例 (Example)

电影级胶片调色迁移

使用 LoadImage 导入待修饰的目标图和一张电影剧照（参考图）。
将剧照连入 reference_image，将目标图连入 target_image。
算法选择 reinhard 或 mkl。
将 strength 设为 0.85（保持主体适度真实感的同时融入电影氛围）。
将 output 接入 DisplayImage，画面将瞬间披上好莱坞大片的光影质感。

批量素材风格统调

固定连接一张品牌色板主视觉图至 reference_image。
批量图流循环接入 target_image。
选择 hm-mvgd-hm 顶级画质算法，统一输出一组色调严格受控的产品图集。

关键技术特性 (Important Notes)

目标尺寸严格不变 (Preserves Dimensions)：输出图像物理像素宽高严格锁定为 target_image 的原始尺寸，参考图仅贡献色彩统计数据，绝不会影响目标图的画面构图与分辨率。
线性混合插值逻辑：strength 采用精确的线性插值公式计算：$\text{result} = \text{target} + \text{strength} \times (\text{matched} - \text{target})$。
色彩空间严谨转换：图像在底层转换至适合通道解耦的特定色彩空间（如 Lab 或 LMS）进行统计矩对齐，杜绝通道交叉溢出。

常见问题与排查 (Common Issues)

调色后画面出现色偏或斑驳杂色：切换算法模型（例如由 hm 切换为对自然过渡更友好的 reinhard）。
色彩变化过猛产生伪影：适当调低 strength 至 0.6–0.8 区间。
超大画幅处理速度慢：复合算法（hm-mvgd-hm）包含多遍迭代，处理 4K 大图时建议切换为轻量高速的 mkl 或 reinhard。