Gaussian Edge Fade 高斯边缘柔化与 Alpha 渐变羽化节点

节点核心功能 (Overview)

Gaussian Edge Fade 节点通过在图像外围边缘生成基于高斯模糊的 Alpha 透明度渐变羽化带，消除生硬的物理切边。它能够让图像四周极其平滑自然地融入底层背景或其他素材中，是制作电影级暗角（Vignette）、多图层无缝柔化合成以及 UI 卡片圆角渐隐的专业级合成算子。

典型适用场景 (Use Cases)

• 图像平滑合成 (Image Compositing)：通过柔和的边缘羽化无痕消除多图重叠处的生硬拼缝；
• 暗角唯美特效 (Vignette Effects)：制作柔和压暗或柔和淡出至透明的高级镜头晕影；
• 画中画多图层贴图：为复杂背景之上的前景素材准备无痕贴合的半透明边界；
• Logo 与水印处理：在保留透明镂空切口的同时，为外框施加平滑外沿淡出；
• 现代 UI 视觉卡片：结合符号距离场算法生成极其有机、平滑的圆角透光边缘。

配置与参数规范 (Parameters)

输入插槽 (Input Parameters)

参数名称 (Parameter)	数据类型 (Type)	语义说明与取值范围 (Description)
input_image	ImageArtifact / ImageUrlArtifact	待施加边缘羽化淡出的源图像。
fade_mode	String	距离度量单位："percentage"（百分比，相对于图像尺寸等比缩放）或 "pixels"（绝对像素）。默认 "percentage"。
fade_distance	Integer	边缘羽化过渡带宽。百分比模式下 5 代表图像短边的 5%；像素模式下 5 代表 5 像素。默认 5。
blur_radius	Integer	用于柔化渐变的高斯模糊卷积核半径（0–100）。数值越大边缘越朦胧柔顺。默认 10。
fade_curve	Float	衰减幂律曲线（0.5–4.0）。1.0 = 纯线性；>1.0 = 边缘更透明侵略性更强（默认 2.0）；<1.0 = 边缘保留更多不透明度（平缓）。
edge_shape	String	渐变几何轮廓："square"（矩形直边独立淡出）或 "rounded"（基于 SDF 距离场的圆角圆润轮廓）。默认 "square"。
replace_mask	Boolean	是否覆写原有蒙版。false（默认）将羽化通道与原图 Alpha 相乘复合；true 彻底抹除原 Alpha 并完全替换为当前边缘淡出蒙版。
apply_top	Boolean	是否在顶端边缘施加羽化淡出。默认 true。
apply_bottom	Boolean	是否在底端边缘施加羽化淡出。默认 true。
apply_left	Boolean	是否在左侧边缘施加羽化淡出。默认 true。
apply_right	Boolean	是否在右侧边缘施加羽化淡出。默认 true。

输出引脚 (Output Parameters)

输出名称 (Parameter)	数据类型 (Type)	语义说明 (Description)
output_image	ImageUrlArtifact	处理完成、携带全新 Alpha 渐变羽化通道的无损 RGBA 图像工件。

核心特性解析 (Key Features)

距离度量模式 (Fade Modes)

• Percentage 模式：与分辨率完全解耦。设定 5% 在 1080p 与 4K 图像上呈现完全一致的相对视觉比例。
• Pixels 模式：绝对像素控制。设定 50 像素即精确羽化 50 物理像素宽度。

衰减幂律曲线 (Fade Curve)

通过幂函数精确调控透明度向中心演进的过渡速率：

• 0.5–0.9（平缓型）：边缘快速过渡至完全不透明，外沿保留较多实色；
• 1.0（线性均匀）：透明度呈匀速线性渐变；
• 2.0（默认自然型）：边缘大范围维持半透明，向中心极其平顺柔和淡入；
• 3.0–4.0（强侵略型）：边缘极端透明，淡入范围深远。

轮廓形状 (Edge Shapes)

• Square（矩形直边）：四个边缘独立线性衰减，适合传统上下遮幅（Letterbox）或标准矩形相框。
• Rounded（圆润倒角）：基于符号距离场（Signed Distance Field，SDF）推导计算，四角呈现极其自然流畅的椭圆圆角过渡。

典型工作流示例 (Example Usage)

宽屏遮幅水平柔化 (Letterbox Effect)

1. 接入源图至 input_image。
2. 设定 fade_mode 为 "pixels"，fade_distance 设为 50，blur_radius 设为 20。
3. 将 apply_top 与 apply_bottom 置为 true，将 apply_left 与 apply_right 设为 false。
4. 运行节点，图像仅在上下两端产生平滑电影级淡出黑边。

圆角现代 UI 柔化卡片

1. 设定 edge_shape 为 "rounded"。
2. 设定 fade_mode 为 "percentage"，fade_distance 为 8，blur_radius 为 12，fade_curve 为 2.5。
3. 节点产出拥有优美圆润半透明边缘的现代设计卡片。

技术规格 (Technical Notes)

• 输出格式为支持全透明通道的 RGBA PNG。
• 底层采用 NumPy 实施高并行度梯度矩阵推导与距离场运算。
• 采用乘法正片叠底机制（Multiplicative Blending）与原有透明图层融合，对已有抠像资产零破坏。