OffsetMaskByNormalizedAmplitude

OffsetMaskByNormalizedAmplitude 节点接收一个 MASK 类型的遮罩和一个 NORMALIZED_AMPLITUDE 类型的归一化振幅序列作为主要输入。它作为 AudioScheduler 节点（https://github.com/a1lazydog/ComfyUI-AudioScheduler）的桥梁。

OffsetMaskByNormalizedAmplitude 节点是一个音频驱动的遮罩变换工具。它的核心功能是根据输入的归一化振幅值，动态地平移或旋转遮罩图像，从而将音频的节奏或强度变化转化为视觉上的动态效果。

节点功能

该节点接收一个 MASK 类型的遮罩和一个 NORMALIZED_AMPLITUDE 类型的归一化振幅序列作为主要输入。在内部，它通过将振幅值乘以预设的偏移量（x, y）或角度乘数（angle_multiplier）来计算每一帧遮罩的位移或旋转角度，并使用 PyTorch 的 roll 和 rotate 函数执行变换。振幅值会被自动裁剪到 [0, 1] 的范围内，确保变换的稳定性。

节点参数说明 - OffsetMaskByNormalizedAmplitude

连接输入 (Inputs)

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`normalized_amp`	NORMALIZED_AMPLITUDE	是	-	-	: 归一化的振幅序列，值域被限制在 0.0 到 1.0 之间，用于驱动遮罩的偏移和旋转量。
`mask`	MASK	是	-	-	: 要偏移或旋转的遮罩。

控件参数 (Parameters)

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`x`	INT	是	0	-4096 - MAX_RESOLUTION (步长: 1)	: 控制遮罩在水平方向（X轴）的基准偏移强度。取值范围为 -4096 至 MAX_RESOLUTION，步长为 1。
`y`	INT	是	0	-4096 - MAX_RESOLUTION (步长: 1)	: 控制遮罩在垂直方向（Y轴）的基准偏移强度。取值范围为 -4096 至 MAX_RESOLUTION，步长为 1。
`rotate`	BOOLEAN	是	False	-	: 布尔开关。当设置为 True 时，启用基于振幅的遮罩旋转功能。
`angle_multiplier`	FLOAT	是	0.0	-1.0 - 1.0 (步长: 0.001)	: 旋转角度乘数，与振幅共同决定旋转角度。取值范围为 -1.0 至 1.0，步长为 0.001。

Output 输出

参数名称	数据类型	说明
mask	MASK	: 经过偏移或旋转变换后的新遮罩。

使用场景

在具体应用中，此节点常与 AudioScheduler 系列节点配合，用于创建音乐可视化或音频反应式动画。例如，在一个视频生成工作流中，可以将一段音乐的振幅分析结果输入此节点，来控制一个前景遮罩的位置或旋转，让遮罩的移动节奏与音乐节拍同步，从而生成富有动感的视觉效果。

注意事项

使用时需注意，遮罩的偏移和旋转是基于振幅的瞬时值计算的，过大的位移值可能导致图像在边界处出现不希望的循环缠绕效果。此外，振幅输入应确保是归一化后的数据。