Create Audio Mask (CreateAudioMask) - ComfyUI-KJNodes

非推奨: このノードは非推奨となり、KJNodes/deprecated カテゴリに移動されました。将来のアップデートで削除される可能性があります。オーディオ駆動のマスク生成には代替ノードの使用を検討してください。

Create Audio Mask ノードは、指定されたパスのWAVオーディオファイルを読み込み、librosaライブラリを使用して短時間フーリエ変換を計算し、スペクトルデータを取得します。

Create Audio Mask ノードは、オーディオファイルのスペクトル情報に基づいて、一連の画像マスクを動的に生成します。その中核機能は、オーディオの振幅変化を視覚的な円形マスクのシーケンスに変換し、後続の画像処理や映像合成において、オーディオのリズムと同期した視覚要素を提供することです。

ノード機能

このノードは、指定されたパスのWAVオーディオファイルを読み込み、librosaライブラリを使用して短時間フーリエ変換を計算し、スペクトルデータを取得します。ノードは設定されたフレーム数に応じて、スペクトルから対応する時間スライスの平均振幅を抽出し、この振幅値にスケール係数を乗じて円形の半径を計算します。最終的に、指定されたサイズのキャンバスの中心に、白色の円形（または反転後の黒色の円形）画像を生成します。

ノードパラメータ説明 - Create Audio Mask

コントロールパラメータ (Parameters)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`invert`	BOOLEAN	はい	False	-	invert（入力パラメータ）：マスクの色を反転します。Falseの場合は白地に黒円、Trueの場合は黒地に白円を生成します。
`frames`	INT	はい	16	1 - 255 (ステップ: 1)	frames（入力パラメータ）：生成する画像マスクの総フレーム数を設定します。範囲は1から255です。
`scale`	FLOAT	はい	0.5	0.0 - 2.0 (ステップ: 0.01)	scale（入力パラメータ）：円形の半径のスケール係数を制御します。範囲は0.0から2.0、ステップは0.01です。
`audio_path`	STRING	はい	audio.wav	-	audio_path（入力パラメータ）：入力オーディオファイルのパス文字列を指定します。デフォルトではカレントディレクトリの「audio.wav」ファイルを読み込みます。
`width`	INT	はい	256	16 - 4096 (ステップ: 1)	width（入力パラメータ）：出力マスク画像の幅（ピクセル値）を設定します。範囲は16から4096です。
`height`	INT	はい	256	16 - 4096 (ステップ: 1)	height（入力パラメータ）：出力マスク画像の高さ（ピクセル値）を設定します。範囲は16から4096です。

Output

パラメータ名	データ型	説明
IMAGE	IMAGE	IMAGE（出力パラメータ）：生成された画像シーケンスを出力します。オーディオスペクトルに対応する視覚化マスクです。

使用シーン

ミュージックビジュアライゼーションショートムービーの制作や、音と映像の同期した特殊効果が必要なワークフローにおいて、このノードは非常に有用です。生成された画像シーケンス（マスク）を画像合成や再描画領域のノードに接続することで、映像内の特定の要素（グローやパーティクルなど）が音楽のリズムに合わせて出現または消失する範囲を制御し、オーディオ駆動の視覚変化効果を実現できます。

注意事項

このノードはlibrosaライブラリに依存しています。インストールされていない場合、実行エラーが発生します。デフォルトのオーディオパスは「audio.wav」です。ファイルがComfyUIのルートディレクトリにない場合は、ノードが正しくファイルを読み込めるように絶対パスの使用が必要になる場合があります。

Create Audio Mask ノードソースコードリンク

Create Audio Mask ノードは ComfyUI-KJNodes ノードパッケージに含まれています。

Create Audio Mask(CreateAudioMask)