AddColorCurves 视频色彩曲线调色与胶片滤镜节点
节点核心功能 (What is it?)
AddColorCurves 节点依托底层高精度多媒体框架 FFmpeg 的 curves 滤镜，为视频流应用专业的色彩曲线分级（Color Grading）调色效果。通过对视频的 RGB 各通道色调响应曲线（Tonal Curves）进行精细化映射，该节点既内置了丰富的电影工业级色彩预设，也支持深度色彩风格化定制。
典型适用场景 (When would I use it?)
在以下情况下使用 AddColorCurves 节点：
- 为视频片段赋予电影质感（Cinematic Look）的高级色彩分级效果；
- 统一多路不同拍摄机位或不同批次 AI 生成视频之间的色调风格；
- 打造特定年代感或艺术审美氛围（如复古胶片、正片负冲）；
- 增强视频画面的情绪张力与视觉戏剧性；
- 执行广播级的色彩校正（Color Correction）与色调映射。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 AddColorCurves 节点。
- 将视频输入源连接至
video输入插槽。 - 在
curve_preset下拉菜单中选择预置的色彩曲线滤镜。 - 按需在
processing_speed中权衡导出速度与画质。 - 执行工作流，调色完成的视频将即刻生成并可向后传递。
参数输入插槽 (Parameters)
- video：待应用色彩曲线的目标视频流（原生支持
VideoArtifact与VideoUrlArtifact）。 - curve_preset：内置的经典色彩分级曲线预设（默认值：
"none"）：none：不应用任何曲线调整，保持原色；color_negative：彩色负片胶片质感；cross_process：正片负冲（Cross-processed）反转色彩风格；darker：压暗整体影调；increase_contrast：中等幅度增强对比度；lighter：整体提亮影调；linear_contrast：线性对比度调整；medium_contrast：中度对比度增强；negative：经典黑白底片反转负像；strong_contrast：强对比度戏剧化视觉风格；vintage：经典复古老胶片色调。
- processing_speed：转码编码速度与导出画质之间的平衡模式（默认值：
"balanced"）：fast：极致极速处理，画质轻微压缩（FFmpegultrafast预设，CRF 30）；balanced：画质与速度的最佳平衡点（FFmpegmedium预设，CRF 23）；quality：极致广播级无损画质，编码耗时相对较长（FFmpegslow预设，CRF 18）。
输出引脚 (Outputs)
- video：完成色彩曲线分级调色后的全新视频工件。
典型示例 (Examples)
1. 打造复古电影胶片质感
- 将
LoadVideo节点的输出连入 AddColorCurves 的video输入插槽。 - 将
curve_preset设置为"vintage"。 - 运行工作流，输出视频将呈现经典温暖且带有一丝胶片颗粒感的复古老电影色调。
- 导出的工件文件名将自动规范化附加后缀：
{original_filename}_curves_vintage.{format}。
2. 赋予画面高对比度戏剧感
- 将视频源接入 AddColorCurves 节点。
- 将
curve_preset设为"strong_contrast"。 - 导出视频的暗部更加沉稳，高光更加通透，视觉冲击力显著增强。
3. 应用正片负冲艺术色调
- 接入视频流并将
curve_preset切换至"cross_process"。 - 呈现色彩饱和度浓烈、青色与品红通道交织的经典 Lomo 胶片风。
关键技术特性 (Important Notes)
- 底层直接调度硬件加速/高度优化的 FFmpeg curves 算法，确保高保真像素级转换；
- 预设已针对主流 Rec.709 与 sRGB 伽马曲线完成专业校准；
- 整体渲染耗时与输入视频的分辨率、帧率（FPS）及总时长正相关；
- 流水线调色最佳实践：建议将色彩曲线节点置于基础几何裁剪、旋转或画面降噪之后执行。
参数调优专家建议 (Parameter Recommendations)
- 追求电影艺术质感：首选
"vintage"或"cross_process"预设；尝试"color_negative"获得别具一格的独立电影视觉。 - 追求清透通透感与高动态：首选
"increase_contrast"进行轻微增强，或使用"strong_contrast"营造暗调悬疑风。