NormalizedAmplitudeToMask

NormalizedAmplitudeToMask ノードは、0から1の範囲に制限されたオーディオ振幅を表す浮動小数点数の配列を入力として受け取ります。

NormalizedAmplitudeToMask ノードは、正規化されたオーディオ振幅データを画像マスクに変換するオーディオ駆動ツールです。このノードはオーディオ処理と画像生成を結びつける橋渡しとして機能し、ユーザーがサウンドの強度に基づいて視覚要素を動的に生成または影響を与えることを可能にします。
AudioScheduler ノードへのブリッジとして機能します。

ノード機能

このノードは、0から1の範囲に制限された値を持つ、オーディオ振幅を表す浮動小数点数の配列を入力として受け取ります。そのコアメカニズムは、オプションのフレームオフセットパラメータを介して振幅データの時間的な位置合わせを調整し、指定された形状、位置、サイズ、およびカラーモードに従って、ユーザー定義のキャンバス上に対応するマスクを生成することです。サークル、正方形、三角形、または特定の形状なしでのマスク領域生成をサポートしています。

ノードパラメータ説明 - NormalizedAmplitudeToMask

接続入力 (Inputs)

パラメータ名	データ型	必須	デフォルト値	値の範囲/オプション	説明
`normalized_amp`	NORMALIZED_AMPLITUDE	はい	-	-	normalized_amp（入力パラメータ）：正規化されたオーディオ振幅データを入力します。値は0から1の間である必要があります。これはマスク生成のコアとなる駆動データです。

制御パラメータ (Parameters)

パラメータ名	データ型	必須	デフォルト値	値の範囲/オプション	説明
`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です。

出力 (Output)

パラメータ名	データ型	説明
MASK	MASK	MASK（出力パラメータ）：オーディオ振幅に基づいて生成された画像マスクを出力します。

使用シナリオ

このノードはビデオやアニメーション生成のワークフローで非常に有用です。例えば、音楽のリズム（振幅）をノードに接続し、音楽のビートに合わせてサイズが変化するサークルマスクを生成することができます。このマスクを使用して別のレイヤーの表示領域を制御することで、ミュージックビジュアライゼーション効果を作成できます。AudioSchedulerなどのオーディオノードと組み合わせて使用されることが一般的です。

注意事項

使用する際には、入力する振幅データが[0, 1]の範囲に正規化された配列である必要があります。生成されるマスクのサイズはユーザーが設定したキャンバスの幅と高さによって制限されます。また、形状の位置やサイズのパラメータがキャンバスの境界を超えないように注意してください。超えた場合、マスク領域の一部が表示されなくなります。