AdjustVideoEQ 视频亮度对比度饱和度与伽马均衡调节节点
节点核心功能 (What is it?)
AdjustVideoEQ 节点依托底层 FFmpeg 工业级均衡滤镜，为视频流提供针对亮度（Brightness）、对比度（Contrast）、色彩饱和度（Saturation）以及伽马曲线（Gamma）的多维度高精度物理调校。它是视频后期调色与曝光校准的基石算子。
典型适用场景 (When would I use it?)
在以下情况下使用 AdjustVideoEQ 节点：
- 校准视频拍摄中出现的欠曝（太暗）或过曝（死白）等曝光缺陷；
- 提亮低照度或阴暗环境下拍摄的低光照视频；
- 修正画面泛白、色彩平淡灰暗的原始 Log 视频流；
- 压低饱和度打造沉稳暗调，或提升饱和度打造绚烂生动的流行短视频；
- 统一多路不同机位视频的影调基调，使其色彩与反差高度吻合。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 AdjustVideoEQ 节点。
- 将输入视频连接至
video输入插槽。 - 调整
brightness、contrast、saturation和gamma调节参数。 - 权衡并选择
processing_speed速度/画质模式。 - 执行工作流，校准后的视频即刻生成。
参数输入插槽 (Parameters)
- video：待校准的目标视频流（原生支持
VideoArtifact与VideoUrlArtifact）。 - brightness：画面亮度偏移量（取值范围：
-1.0至1.0，默认值：0.0）：-1.0：极暗（全黑）；0.0：标准原始亮度（默认）；1.0：极亮（全白）。
- contrast：画面反差对比度倍率（取值范围：
0.0至3.0，默认值：1.0）：0.0：零对比度（全灰平坦画面）；1.0：标准对比度（默认）；3.0：极限高对比度。
- saturation：色彩饱和度倍率（取值范围：
0.0至3.0，默认值：1.0）：0.0：完全去色（纯灰度黑白画面）；1.0：标准色彩饱和度（默认）；3.0：极高浓度鲜艳色彩。
- gamma：中间调伽马响应因子（取值范围：
0.1至10.0，默认值：1.0）：0.1：极高光通透中间调；1.0：标准线性伽马响应（默认）；10.0：极深沉暗调中间调。
- processing_speed：转码编码与画质平衡（
fast/balanced/quality）。
输出引脚 (Outputs)
- video：完成均衡调色校准后的全新视频工件。
典型示例 (Example)
提亮较暗的夜景视频并提升画面色彩质感：
- 将
LoadVideo的输出接入 AdjustVideoEQ 节点的video输入端。 - 将
brightness设为0.3（适度拉伸暗部曝光）。 - 将
contrast设为1.2（适度增强通透感）。 - 将
saturation设为1.5（增强色彩饱满度）。 - 保持
gamma为1.0。 - 运行工作流，导出的工件文件将命名为
{original_filename}_eq_b0.30_c1.20_s1.50_g1.00.{format}。
关键技术特性 (Important Notes)
- 底层使用基于色彩感知矩阵的高保真 FFmpeg 算法，多参数协同运算时不会产生非线性色斑；
- 视频的所有音频流原汁原味直接透传并严格帧同步；
- 支持完整的处理日志探针，便于跟踪长视频转码进度。
参数调优专家建议 (Parameter Recommendations)
- 拯救欠曝暗光画面：
brightness: 0.2–0.5，contrast: 1.1–1.3； - 修正强光过曝画面：
brightness: -0.2 至 -0.5，contrast: 0.8–0.9； - 拯救灰暗平淡画面 (Flat Footage)：
contrast: 1.2–1.5，saturation: 1.1–1.3； - 通透高级电影感：
contrast: 1.1–1.2，saturation: 0.85–0.9，gamma: 1.1–1.2； - 复古怀旧色调：
saturation: 0.7–0.8，gamma: 1.2–1.4。