Create Fade Mask (CreateFadeMask) - ComfyUI-KJNodes

Create Fade Mask 节点生成一个动态的、可自定义的渐变遮罩序列。其核心功能是创建一个由多帧图像组成的批次，其中每帧图像的灰度值根据设定的关键点平滑过渡，从而形成一个随时间（帧序列）变化的遮罩。这个遮罩可以直接用于控制其他图像处理节点的透明度或影响区域。

节点功能

该节点通过设定起始、中点和结束三个关键帧的灰度值（0.0到1.0之间），并选择不同的插值算法（如线性、缓入、缓出、缓入缓出）来计算中间每一帧的像素值。它生成一个形状为 (帧数, 高度, 宽度) 的 NumPy 数组，数据类型为 float32，最终输出为 ComfyUI 的标准 MASK 格式。当 midpoint_frame 设为 0 时，中点会自动设置为总帧数的一半。

节点参数说明 - Create Fade Mask

控件参数 (Parameters)

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`interpolation`	COMBO	是	linear	"linear", "ease_in", "ease_out", "ease_in_out"	选择插值曲线：linear、ease_in、ease_out 或 ease_in_out，影响渐变的速度曲线。
`invert`	BOOLEAN	是	False	-	布尔值开关。当设置为 True 时，将对生成的整个遮罩序列进行反相处理（即 1.0 变为 0.0，0.5 变为 0.5，以此类推）。
`frames`	INT	是	2	2 - 10000 (步长: 1)	指定要生成的遮罩总帧数，范围从 2 到 10000，步长为 1。这决定了输出序列的长度。
`width`	INT	是	256	16 - 4096 (步长: 1)	设置生成遮罩的宽度像素值，范围从 16 到 4096，步长为 1。
`height`	INT	是	256	16 - 4096 (步长: 1)	设置生成遮罩的高度像素值，范围从 16 到 4096，步长为 1。
`start_level`	FLOAT	是	1.0	0.0 - 1.0 (步长: 0.01)	定义序列第一帧的全局灰度值，范围 0.0（黑色）到 1.0（白色），步长 0.01。
`midpoint_level`	FLOAT	是	0.5	0.0 - 1.0 (步长: 0.01)	定义在 `midpoint_frame` 指定帧的灰度值，范围 0.0 到 1.0，步长 0.01。
`end_level`	FLOAT	是	0.0	0.0 - 1.0 (步长: 0.01)	定义序列最后一帧的全局灰度值，范围 0.0 到 1.0，步长 0.01。
`midpoint_frame`	INT	是	0	0 - 4096 (步长: 1)	指定作为渐变中点的帧索引，范围 0 到 4096，步长为 1。值为 0 时自动取总帧数的一半。

输出

参数名称	数据类型	说明
MASK	MASK	输出的渐变遮罩序列，为多帧灰度图像的集合，可用于控制透明度或混合效果。

使用场景

在视频过渡或图像混合工作流中，此节点非常有用。例如，你可以将生成的遮罩序列连接到 VAEEncode 或 ImageComposite 类节点，利用遮罩的渐变值来控制两段视频剪辑之间的淡入淡出效果，或者让一张图片逐渐融入另一张图片，创造出平滑的转场。

注意事项

请注意，此节点位于“弃用”类别中，意味着可能有更新或更优的替代方案。其输出的遮罩分辨率受宽度和高度参数限制，最大为 4096x4096，且帧数上限为 10000。

Create Fade Mask 节点源码链接

Create Fade Mask 节点来自 ComfyUI-KJNodes 节点包。

Create Fade Mask(CreateFadeMask)

Create Fade Mask