Create Voronoi Mask (CreateVoronoiMask) - ComfyUI-KJNodes

Create Voronoi Mask(CreateVoronoiMask)

このノードはSciPyライブラリを使用してボロノイ図を計算し、ランダムに生成された開始点と終了点に基づき、指定された速度パラメータに従って複数のフレーム間で線形補間を行い、ポイントの滑らかな移動をシミュレートします。

Create Voronoi Mask ノードは、SciPy ライブラリを使用してボロノイ図を計算します。ランダムに生成された開始点と終了点に基づき、指定された速度パラメータで複数のフレーム間を線形補間し、ポイントの滑らかな移動をシミュレートします。

Create Voronoi Mask ノードは、動的なボロノイ図（Voronoi Diagram）パターンを生成し、それをマスク（Mask）に変換するために使用されます。一連のポイントの動きを制御することで、時間とともに変化する幾何学的な分割効果を作成し、最終的に標準マスクとその反転バージョンを出力します。

ノード機能

このノードは、SciPy ライブラリを使用してボロノイ図を計算します。ランダムに生成された開始点と終了点に基づき、指定された速度パラメータで複数のフレーム間を線形補間し、ポイントの滑らかな移動をシミュレートします。生成されるパターンの線幅は調整可能で、最終的には指定されたサイズのシングルチャネル2値画像としてレンダリングされ、ComfyUI のマスク形式と互換性を持たせています。

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

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

パラメータ名	データ型	必須	デフォルト値	値範囲/オプション	説明
`frames`	INT	はい	16	2 - 4096 (ステップ: 1)	生成するマスクアニメーションの総フレーム数を指定します。範囲は 2 から 4096、ステップは 1 です。
`num_points`	INT	はい	15	1 - 4096 (ステップ: 1)	ボロノイ図の生成に使用するランダムなポイントの数を定義します。範囲は 1 から 4096、ステップは 1 です。
`line_width`	INT	はい	4	1 - 4096 (ステップ: 1)	ボロノイ図パターン内の分割線の幅（ピクセル）を設定します。範囲は 1 から 4096、ステップは 1 です。
`speed`	FLOAT	はい	0.5	0.0 - 1.0 (ステップ: 0.01)	ポイントが開始位置から終了位置へ移動するアニメーションの速度を制御します。範囲は 0.0 から 1.0、ステップは 0.01 です。
`frame_width`	INT	はい	512	16 - 4096 (ステップ: 1)	出力マスクの幅（ピクセル）を設定します。範囲は 16 から 4096、ステップは 1 です。
`frame_height`	INT	はい	512	16 - 4096 (ステップ: 1)	出力マスクの高さ（ピクセル）を設定します。範囲は 16 から 4096、ステップは 1 です。

出力

パラメータ名	データ型	説明
mask	MASK	出力されるボロノイ図パターンのマスク。
mask_inverted	MASK	出力される反転ボロノイ図パターンのマスク。

使用シナリオ

動画生成や画像シーケンス処理のワークフローにおいて、このノードで生成された動的マスクは、エフェクトの適用領域を制御するために使用できます。例えば、マスクを画像合成ノードに接続することで、ボロノイ図パターンが時間の経過とともに画像の特定部分を徐々に明らかにしたり覆い隠したりし、ユニークなトランジションやテクスチャオーバーレイ効果を作り出すことができます。

注意事項

生成されるマスクのサイズは frame_width および frame_height パラメータによって直接決定されることに注意してください。また、ポイントや線の数が多すぎると計算負荷が増加する可能性があります。ノードが出力するマスクの数は frames パラメータの値と等しく、バッチ処理に適しています。

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

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