ImageTransformByNormalizedAmplitude

ImageTransformByNormalizedAmplitude 节点在技术上接收一个 NORMALIZED_AMPLITUDE 类型的数组和一批 IMAGE 图像作为输入

ImageTransformByNormalizedAmplitude 节点是一个图像处理节点，它能够根据输入的音频振幅数据动态地变换图像。其核心功能是将音频的归一化振幅值映射为图像的缩放和位移操作，从而创建出与音频节奏同步的视觉变化效果。

节点功能

此节点在技术上接收一个 NORMALIZED_AMPLITUDE 类型的数组和一批 IMAGE 图像作为输入。它内部将振幅值裁剪到 [0, 1] 的范围，并根据振幅值计算图像的裁剪尺寸，实现缩放效果。同时，节点支持累积模式，可以将连续的振幅变化累加起来，产生更强烈的视觉冲击。处理后的图像会以 IMAGE 格式输出，保持与输入相同的批次结构。

节点参数说明 - ImageTransformByNormalizedAmplitude

连接输入 (Inputs)

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`normalized_amp`	NORMALIZED_AMPLITUDE	是	-	-	normalized_amp（输入参数）：接收归一化的音频振幅数据，用于驱动图像变换。数值范围被限制在 0.0 到 1.0 之间。
`image`	IMAGE	是	-	-	image（输入参数）：输入待变换的原始图像批次。

控件参数 (Parameters)

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`zoom_scale`	FLOAT	是	0.0	-1.0 - 1.0 (间距: 0.001)	zoom_scale（输入参数）：控制振幅影响图像缩放的基础系数。取值范围为 -1.0 到 1.0，间距为 0.001。
`x_offset`	INT	是	0	-	x_offset（输入参数）：设置图像在水平方向（X轴）上的基础偏移量。取值范围受系统最大分辨率限制。
`y_offset`	INT	是	0	-	y_offset（输入参数）：设置图像在竖直方向（Y轴）上的基础偏移量。取值范围受系统最大分辨率限制。
`cumulative`	BOOLEAN	是	False	-	cumulative（输入参数）：启用累积模式。当设为 True 时，振幅效果会逐帧累积，增强变换强度。

Output 输出

参数名称	数据类型	说明
IMAGE	IMAGE	IMAGE（输出参数）：输出经过振幅驱动变换后的图像批次。

使用场景

一个典型的使用案例是在组合音频生成视频的工作流中。用户可以将 AudioScheduler 节点输出的归一化振幅数据连接至此节点，同时输入一组关键帧图像。节点会根据音频的实时振幅，自动对每一帧图像进行不同程度的缩放和偏移，从而生成一个随音乐节奏“跳动”或“呼吸”的动态视频序列。

注意事项

请注意，此节点设计为与 ComfyUI-AudioScheduler 扩展配合使用，以确保获得正确的振幅数据格式。输入的图像批次数量应与振幅数组的长度相匹配，否则可能引发错误。