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 に設定すると、振幅効果がフレームごとに累積され、変換強度が増強されます。

出力

パラメータ名	データ型	説明
IMAGE	IMAGE	IMAGE（出力パラメータ）：振幅駆動変換を適用した後の画像バッチを出力します。

使用シナリオ

典型的な使用例は、オーディオとビデオ生成を組み合わせたワークフローです。ユーザーは AudioScheduler ノードから出力される正規化振幅データをこのノードに接続し、同時に一連のキーフレーム画像を入力できます。ノードはオーディオのリアルタイム振幅に基づいて、各フレーム画像に対して異なる程度のスケーリングとオフセットを自動的に適用し、音楽のリズムに合わせて「脈動する」または「呼吸する」動的なビデオシーケンスを生成します。

注意事項

このノードは、正しい振幅データフォーマットを確実に取得するために、ComfyUI-AudioScheduler 拡張機能と組み合わせて使用するように設計されていることに注意してください。入力される画像バッチの数は、振幅配列の長さと一致する必要があります。一致しない場合、エラーが発生する可能性があります。