Create Magic Mask (CreateMagicMask) - ComfyUI-KJNodes

Create Magic Mask 节点基于坐标网格和随机变换算法，通过控制深度、扭曲等参数，生成具有分形或噪声特征的灰度图像序列作为遮罩。

该节点是一个用于生成动态、抽象遮罩的工具。它通过算法创建一系列随时间变化的黑白遮罩图案，这些图案可以用于控制图像生成或视频处理中的特定区域。该节点特别适合需要非规则、有机形状遮罩的创意工作流。

节点功能

该节点基于坐标网格和随机变换算法，通过控制深度、扭曲等参数，生成具有分形或噪声特征的灰度图像序列作为遮罩。其核心是magictex模块，它根据种子值产生确定性的随机图案，并支持在指定的帧数内平滑过渡多个图案状态，最终输出为标准的MASK数据类型。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`frames`	INT	是	16	2 - 4096 (步长: 1)	frames（输入参数）：指定生成遮罩动画的总帧数。取值范围为2至4096，用于定义序列长度。
`depth`	INT	是	12	1 - 500 (步长: 1)	depth（输入参数）：控制生成图案的计算深度或迭代次数，影响遮罩的细节复杂程度。取值范围为1至500。
`distortion`	FLOAT	是	1.5	0.0 - 100.0 (步长: 0.01)	distortion（输入参数）：设置坐标的扭曲强度，数值越大图案变形越剧烈。取值范围为0.0至100.0，步长0.01。
`seed`	INT	是	123	0 - 99999999 (步长: 1)	seed（输入参数）：随机数生成器的种子值，用于确保每次使用相同参数可生成完全相同的遮罩序列。取值范围为0至99999999。
`transitions`	INT	是	1	1 - 20 (步长: 1)	transitions（输入参数）：定义在总帧数内，遮罩图案在不同状态之间平滑过渡的次数。取值范围为1至20。
`frame_width`	INT	是	512	16 - 4096 (步长: 1)	frame_width（输入参数）：设置生成遮罩的宽度像素值。取值范围为16至4096。
`frame_height`	INT	是	512	16 - 4096 (步长: 1)	frame_height（输入参数）：设置生成遮罩的高度像素值。取值范围为16至4096。

参数名称	数据类型	说明
mask	MASK	mask（输出参数）：输出的主要遮罩序列，白色区域表示目标区域。
mask_inverted	MASK	mask_inverted（输出参数）：输出的反转遮罩序列，黑白区域与主遮罩相反。

在视频生成或图像动画工作流中，你可以将此节点生成的遮罩连接到采样器的“mask”输入，以在动态区域引导内容生成。例如，可以创建一个逐渐扩散的光晕效果遮罩，控制新内容在视频序列中的出现范围和方式，或者结合遮罩反转输出来交替处理前景与背景。

请注意，生成的遮罩图案具有随机性，但通过固定的种子值可以复现相同结果。遮罩的精细程度和计算时间受“深度”参数影响，较高的值会产生更复杂的图案但也可能增加处理负担。