VideoColorMatch 视频全局色彩迁移与电影调色匹配节点

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

VideoColorMatch 节点依托先进的最优传输与统计分布色彩匹配算法，将一张静态参考图片（Reference Image）的色彩分布特征与调色风格完整迁移至目标视频流中。默认情况下，该节点基于创新的 HALD CLUT（三维色彩查找表）一次性投影方法，比传统逐帧处理快 10–50 倍。只需提供一张电影海报、摄影大片或艺术画作，即可在数秒内为整段视频赋予广播级的电影感色彩风格（Cinematic Color Grading）。

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

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

从经典电影剧照、海报或摄影作品中汲取调色灵感并一键迁移至视频；
统一多路不同机位、不同光照条件下拍摄的视频素材，使其保持绝对一致的调色板（Color Palette）；
为普通手机拍摄的平淡素材赋予青橙（Teal & Orange）、赛博朋克或复古胶片影调；
模拟“白昼变黑夜”（Day-to-Night）等跨时空、跨环境的色调反转与重塑；
高效替代耗时繁重的逐帧 LUT 手工调色流程。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

在工作流画布中添加 VideoColorMatch 节点。
将提供理想调色板的参考图片连接至 reference_image 输入插槽。
将待调色的视频接入 target_video 输入插槽。
选择色彩处理方式（推荐默认极速的 ffmpeg-haldclut）与数学迁移算法（如 mkl 或 hm-mvgd-hm）。
调节 strength 混合强度滑块（默认 1.0）。
执行工作流，调色完成的高清视频即刻输出。

参数输入插槽 (Parameters)

输入插槽 (Inputs)

reference_image：提供目标色彩分布的母本参考图片（支持 ImageArtifact 与 ImageUrlArtifact）。
target_video：待应用色彩迁移的目标视频（支持 VideoArtifact 与 VideoUrlArtifact）。

调色匹配核心配置 (Color Match Settings)

transfer_method：视频处理工程架构下拉菜单：
- ffmpeg-haldclut（默认，推荐）：基于 HALD 3D-CLUT 的单遍次流式加速，比传统逐帧方式快 10–50 倍。仅需在 CLUT 上执行一次色彩拟合，随后调度 FFmpeg 一次性完成整片像素级映射；
- frame-by-frame：传统逐帧分解处理模式（耗时较长、显存与内存占用偏大），适用于排查极小众的复杂色彩断层。
transfer_algorithm：底层色彩迁移核心数学算法：
- mkl（Monge-Kantorovich 线性化）：基于最优传输理论（Optimal Transport），速度极快且画质均衡，通用场景默认推荐；
- hm（直方图匹配 Histogram Matching）：对齐两者的色彩累积直方图，色调偏移明显；
- reinhard（Reinhard 统计色彩迁移）：基于感知色彩空间均值方差对齐，原片亮度结构保持最优，视觉最自然；
- mvgd（多元高斯分布 Multi-Variate Gaussian Distribution）：能够敏锐捕获细微而复杂的色彩相关性；
- hm-mvgd-hm（复合三阶算法）：直方图匹配 $\rightarrow$ MVGD $\rightarrow$ 直方图二次微调，调色品质最高、色彩细腻度顶级；
- hm-mkl-hm（复合替代算法）：以 MKL 作为中间核的高端复合算法。
strength：色彩迁移效果强度滑块（取值范围：0.0–10.0，默认值：1.0）：
- 0.0：无任何色彩改变，保留原视频原色；
- 1.0：100% 满额色彩迁移（标准推荐）；
- > 1.0：夸张色彩对比，打造极度风格化的视觉冲击。

输出引脚 (Outputs)

output：完成色彩映射后的全新视频工件（VideoUrlArtifact）。
导出的视频严格保持原片封装格式、原始分辨率、长宽比、物理帧率以及高质量音频轨（192kbps AAC 编码）。

经典调色案例 (Example)

1. 经典电影海报青橙调色

在画布中添加 VideoColorMatch 节点。
将包含青橙调色风格的电影海报接入 reference_image。
将实拍视频接入 target_video。
保持默认的 mkl 算法与 strength: 1.0。
运行工作流，视频将即刻吸收海报的冷暖互补光影层次。

2. 怀旧复古摄影影调迁移

使用一张 70 年代暖黄泛红的复古老照片作为 reference_image。
将现代数字视频接入 target_video。
选用 reinhard 算法以保持自然的亮度过渡，将 strength 设为 0.7。
导出的视频将自然弥漫着淡淡的旧时光胶片韵味。

算法性能与处理时延对照 (Performance)

在现代标准硬件环境下处理 1080p @ 30fps 视频：

视频时长	HALD CLUT 模式（默认推荐）	逐帧 Frame-by-Frame 模式	性能提速比
5 秒 (150帧)	约 2–5 秒	约 1–2 分钟	~25x
10 秒 (300帧)	约 3–8 秒	约 3–5 分钟	~35x
30 秒 (900帧)	约 10–20 秒	约 8–12 分钟	~30x
60 秒 (1800帧)	约 20–40 秒	约 20–30 分钟	~40x

参数调优与参考图选型指南 (Best Practices)

优质参考图标准：曝光充足、影调清晰且带有明确主色调的画面；参考图的光线场景与待处理视频越相近，融合效果越自然；
避坑警示：避免选用大面积严重欠曝死黑或高光死白的图片作为参考；
强度档位推荐：
- 0.3–0.5：极轻微微妙的情绪微调；
- 0.6–0.8：自然且恰到好处的影视质感；
- 0.9–1.1：全量风格重塑；
- 1.2–2.0：强烈的超现实艺术效果。