BloomEffect 梦幻发光泛光与光学辉光渲染节点

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

BloomEffect 节点为图像施加唯美梦幻的辉光（Bloom / Glow）泛光特效。它通过模拟专业光学镜头在捕捉极端强光源时产生的衍射与散射物理现象，在画面明亮高光区域的外围生成一层柔和朦胧的发光光晕（Luminous Halo），瞬间为作品注入电影质感、浪漫氛围与超现实主义魔幻气息。

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

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

营造唯美空灵、梦幻朦胧的二次元或肖像艺术视效；
为霓虹灯牌、魔法技能光效、激光剑及科幻武器增强光能溢出感；
模拟大光圈镜头在逆光拍摄时的柔光辉光与镜头光晕（Lens Flare）；
为黄昏晚霞、林间丁达尔光线或夜景街灯强化温暖浪漫的光学包围感；
柔化人像边缘高光，打造柔焦电影摄影质感。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

在工作流画布中添加 BloomEffect 节点。
将图像数据源接入 input_image 输入插槽。
拖动泛光强度（bloom_amount）与漫射半径（bloom_radius）滑块。
在 output 引脚即可提取渲染完成梦幻辉光的全新图像工件。

参数输入插槽 (Parameters)

bloom_amount（0.0–2.0，默认 0.5）：辉光发光强度增益系数：
- 0.0 = 关闭泛光效果（纯原图透传）；
- 数值越大 = 光源外溢光晕越耀眼强烈；
- 2.0 = 最大辉光爆发极限。
bloom_radius（1–20，默认 5）：高斯模糊光晕的物理漫射半径：
- 较小数值 = 紧致、聚焦且轮廓清晰的硬核发光；
- 较大数值 = 辽阔、弥散且极其柔和的朦胧大雾光晕；
- 半径数值越大，底层多级高斯卷积核计算耗时相应增加。

输出引脚 (Outputs)

output：应用了多阶段高光提取与高斯叠加混合后的全新图像工件（ImageArtifact）。

典型工作流示例 (Example)

为科幻夜景插画注入霓虹辉光：

使用 LoadImage 导入一张赛博朋克夜景图。
将其接入 BloomEffect 节点的 input_image 参数。
配置发光属性：
- 将 bloom_amount 设为 0.85，让招牌与车灯产生显眼的漫射高光；
- 将 bloom_radius 设为 8，形成适中扩散的氛围光雾。
连入 DisplayImage 监看夜色光影通透的大片成果。

关键技术特性 (Important Notes)

毫秒级实时联动 (Live Preview)：滑块调节即时触发局部高光卷积，画布视图实时更新。
高光自适应感知 (Best Results)：算法自动基于亮度阈值分割（Threshold Isolation）高频高光带，仅对明亮发光体施加辉光，绝对不脏污暗部阴影。
透明通道完美保持 (RGBA Support)：针对 RGBA 图像，半透明和抠图边界完整保留，Alpha 通道不受辉光运算污染。

常见问题与排查 (Common Issues)

看不到辉光效果：确认原图中是否存在足够明亮的高光区域；若原图整体灰暗，可先串接 AdjustImageLevels 提亮高光，或调大 bloom_amount。
大图计算响应稍慢：针对 4K 以上超高清素材，适当将 bloom_radius 控制在合理范围（如 5–8）可兼顾画质与极速响应。

底层光学渲染机制 (Technical Details)

节点底层严格模拟工业影视后期的光学泛光渲染管线：

亮度阈值抽取 (Brightness Detection)：高通滤波提取高于指定亮度阈值的像素高光矩阵；
多级高斯卷积 (Gaussian Blur)：对提取出的纯高光图层施加高精度高斯平滑滤波，模拟光子在镜头玻璃中的二次散射；
加色屏幕混合 (Screen / Additive Blend)：将散射光晕图层以物理发光算法（Additive Blending）叠加回原图像上方；
强度缩放调控 (Intensity Scaling)：根据 bloom_amount 线性加权合成，输出具备物理级真实感的最终画面。