NormalizedAmplitudeToMask

NormalizedAmplitudeToMask 节点接收一个代表音频振幅的浮点数数组作为输入，其值范围被限制在 0 到 1 之间。

NormalizedAmplitudeToMask 节点是一个音频驱动工具，它能将归一化的音频振幅数据转换为图像遮罩。该节点作为连接音频处理与图像生成的桥梁，允许用户根据声音的强度动态生成或影响视觉元素。
作为连接 AudioScheduler 节点的桥梁。

节点功能

该节点接收一个代表音频振幅的浮点数数组作为输入，其值范围被限制在 0 到 1 之间。核心机制是通过一个可选的帧偏移参数来调整振幅数据的时间对齐，然后根据指定的形状、位置、大小和颜色模式，在用户定义的画布上生成对应的遮罩。它支持生成圆形、方形、三角形或不指定形状的遮罩区域。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`normalized_amp`	NORMALIZED_AMPLITUDE	是	-	-	normalized_amp（输入参数）：输入归一化的音频振幅数据，值应在0到1之间。这是生成遮罩的核心驱动数据。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`shape`	COMBO	是	none	"none", "circle", "square", "triangle"	"circle"（圆形）、"square"（方形）或"triangle"（三角形）。
`color`	COMBO	是	amplitude	"white", "amplitude"	color（输入参数）：决定遮罩区域内的值（颜色）。可选"white"（白色，值为1）或"amplitude"（使用输入的归一化振幅值作为该区域的强度）。
`width`	INT	是	512	16 - 4096 (步长: 1)	width（输入参数）：设置输出遮罩图像的宽度。取值范围为16至4096像素，步长为1。
`height`	INT	是	512	16 - 4096 (步长: 1)	height（输入参数）：设置输出遮罩图像的高度。取值范围为16至4096像素，步长为1。
`frame_offset`	INT	是	0	-255 - 255 (步长: 1)	frame_offset（输入参数）：对输入的振幅数据进行时间偏移的帧数，用于调整音频与视频的同步。取值范围为-255至255，步长为1。
`location_x`	INT	是	256	0 - 4096 (步长: 1)	location_x（输入参数）：指定所绘制形状在画布上的水平中心位置（X坐标）。取值范围为0至4096，步长为1。
`location_y`	INT	是	256	0 - 4096 (步长: 1)	location_y（输入参数）：指定所绘制形状在画布上的垂直中心位置（Y坐标）。取值范围为0至4096，步长为1。
`size`	INT	是	128	8 - 4096 (步长: 1)	size（输入参数）：控制所绘制形状的基本尺寸（如半径或边长）。取值范围为8至4096，步长为1。

参数名称	数据类型	说明
MASK	MASK	MASK（输出参数）：输出根据音频振幅生成的图像遮罩。

在视频或动画生成工作流中，此节点非常有用。例如，你可以将一段音乐的节奏（振幅）连接到节点，生成一个随着音乐鼓点跳动而大小变化的圆形遮罩，再用这个遮罩去控制另一图层的显示区域，从而创建出音乐可视化的效果。它常与 AudioScheduler 等音频节点配合使用。

使用时需注意，输入的振幅数据必须是已经归一化到 [0, 1] 范围内的数组。生成的遮罩尺寸受限于用户设置的画布宽高，且形状的位置和大小参数不应超过画布边界，否则部分遮罩区域将不可见。