AdjustImageEQ 图像均衡器与四大光学属性调节节点
节点核心功能 (What is it?)
AdjustImageEQ 节点为创作者提供了对图像四项核心光学影调属性——亮度（Brightness）、对比度（Contrast）、饱和度（Saturation）以及伽马曲线（Gamma Correction）的精确微调能力。它就像在节点画布中嵌入了一款专业的摄影暗房均衡器，允许您随心所欲调优画面的视觉质感。
典型适用场景 (When would I use it?)
在以下情况下使用该节点：
- 增强或降低画面整体亮度与通透感；
- 强化明暗反差（高对比度戏剧感）或制作平顺低反差风格；
- 提升色彩鲜艳饱满度，或降低饱和度直至纯正黑白单色；
- 独立校正中间调灰阶亮度，修复逆光欠曝或强光泛白；
- 在自动化多图合成前，统一各输入素材的色彩基准。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 AdjustImageEQ 节点。
- 将图像数据源接入
input_image输入插槽。 - 拖动亮度、对比度、饱和度与伽马滑块进行交互式调优。
- 在
output引脚即可提取完成画质重塑的全新图像工件。
参数输入插槽 (Parameters)
- brightness（0.0–3.0，默认 1.0）：全局亮度增益系数：
< 1.0：画面变暗；> 1.0：画面变亮；1.0：保持原始亮度。
- contrast（0.0–3.0，默认 1.0）：明暗动态反差对比度：
< 1.0：降低对比度（画面整体趋向平淡中灰）；> 1.0：增加对比度（亮处更亮、暗处更深，视觉冲击强烈）；1.0：原始对比度。
- saturation（0.0–3.0，默认 1.0）：色彩鲜艳度与色纯度：
0.0：完全去色（转变为标准单色黑白灰度图）；< 1.0：褪色、莫兰迪低饱和高级灰效果；> 1.0：色彩饱和浓郁；1.0：原始饱和度。
- gamma（0.1–10.0，默认 1.0）：非线性中间调亮度矫正系数：
< 1.0：提亮中间调细节；> 1.0：压暗中间调；1.0：标准线性响应。
输出引脚 (Outputs)
- output：应用全部均衡器参数后生成的全新高质量图像工件（
ImageArtifact）。
典型工作流示例 (Example)
典型的摄影成片质感增强流水线：
- 使用
LoadImage导入一张微单原图。 - 将其接入
AdjustImageEQ节点。 - 调控影调参数：
- 将
brightness设为1.15，轻微提亮整体光线； - 将
contrast设为1.1，使阴影立体感更加凸显； - 将
saturation设为1.25，增强天空蓝与植被绿的生动色彩； - 将
gamma微调至0.9，让暗部阴影中的微小细节清晰浮现。
- 将
- 将
output接入DisplayImage查看精修成片。
关键技术特性 (Important Notes)
- 毫秒级实时联动 (Live Preview)：滑块调节即时触发计算，画面实时无缝重绘。
- 透明通道完美保持 (RGBA Support)：针对 RGBA 图像，Alpha 遮罩通道被完全隔离保护，四项调节仅对 RGB 色彩通道起效。
- 专业级底层算子：基于 Pillow 底层
ImageEnhance工业级矩阵算法与查表法加速，画质过渡极度平滑细腻。
常见问题与排查 (Common Issues)
- 画面没有明显变化：确保至少有一个滑块被拖离了原始默认值
1.0。 - 色彩溢出或破面：避免将参数拉到极限（如 3.0），轻量细微的增益往往能取得最自然的视觉美感。