was-node-suite-comfyui
时间：2025/11/07
Image SSAO (Ambient Occlusion)
是一个模拟计算机图形学中 "环境光遮蔽" (Ambient Occlusion, AO) 或更具体地说是 "屏幕空间环境光遮蔽" (Screen-Space Ambient Occlusion, SSAO) 效果的图像滤镜节点。主要作用是根据一个深度图（Depth Map）来为一张彩色图像添加接触阴影和环境阴影，从而极大地提升图像的立体感、深度感和真实感。
Image SSAO (Ambient Occlusion)-节点参数说明
| 输入参数 | |
| images | 源图像，拟应用环境光遮蔽效果的基础彩色图像批次。 |
| depth_images | 与源图像相对应的深度图批次。深度图是灰度图像，其中亮度代表了距离摄像机的远近（通常白色表示近，黑色表示远）。如果深度图尺寸与原图不匹配，节点会自动将其缩放到匹配尺寸。 |
| 输出参数 | |
| composited_images | 合成后图像，这是将计算出的环境光遮蔽阴影（SSAO）叠加到原始图像上之后最终得到的图像。 |
| ssao_images | 环境光遮蔽图，是一张灰度图，纯粹地展示了计算出的环境光遮蔽信息。白色区域表示没有遮蔽，黑色/灰色区域表示有遮蔽。 |
| specular_mask_images | 高光蒙版图，一张基于原始图像亮度计算出的高光区域蒙版。白色区域代表原始图像中可能存在高光反射的亮部。这个蒙版用于防止在这些高光区域应用过强的遮蔽效果，从而保留材质的镜面反射感。 |
| 控件参数 | |
| strength | 遮蔽强度，为 FLOAT (浮点数)，范围 0.0 到 5.0，默认值 1.0。这个参数直接控制遮蔽效果的暗度，值越高，阴影越黑越明显；值越低，效果越微妙。 |
| radius | 遮蔽半径，为 FLOAT (浮点数)，范围 0.01 到 1024，默认值 30。这个参数定义了计算遮蔽时考虑的周围像素范围（以像素为单位）。较小的值会产生更精细、更局部的接触阴影，适合表现微小的缝隙和细节。较大的值会产生更大、更柔和的阴影，适合表现大物体之间的遮挡关系。 |
| ao_blur | 遮蔽模糊，为 FLOAT (浮点数)，范围 0.01 到 1024，默认值 2.5。这个参数控制对生成后的环境光遮蔽图（ssao_images）应用的模糊半径。增加此值可以使阴影看起来更平滑、更柔和，减少噪点和伪影，但过高可能会丢失细节。 |
| specular_threshold | 高光阈值，为 INT (整数)，范围 0 到 255，默认值 25。这个参数设定了一个亮度阈值，用于创建高光蒙版。像素亮度高于此值的区域被认为是高光区。 |
| enable_specular_masking | 启用高光蒙版，一个下拉菜单，选项为 True 或 False。设置为 True 时，节点会使用生成的高光蒙版来保护图像中的高光区域，防止遮蔽 效果应用在这些区域，从而保留镜面反射的质感。设置为 False 时， 遮蔽效果会均匀地应用在所有区域，可能会导致高光部分变“脏”。 |
| tile_size | 切片尺寸，为 INT (整数)，范围 1 到 512，默认值 1。这是一个用于性能优化的参数，当值为 1 时，节点会以单线程、逐像素的方式进行计算，质量最高但速度最慢。当值大于 1 时，节点会将图像分割成指定大小的块（Tile），并使用多线程并行处理这些块，可以显著提升处理速度，尤其是在大分辨率图像上。但是，可能会在块的边缘产生不易察觉的接缝或伪影。值被限制在最大为8。 |
