Create Gradient Mask (CreateGradientMask) - ComfyUI-KJNodes

Create Gradient Mask ノードは、NumPy および PyTorch ライブラリを使用して内部で2次元浮動小数点テンソルを生成します。

Create Gradient Mask ノードは、黒から白への線形グラデーションマスクを生成するために使用されます。指定されたサイズとフレーム数に基づいてグレースケール画像をバッチ生成でき、これらの画像はマスクとして画像処理ワークフローで使用され、他のエフェクトの強度や適用領域を制御します。

ノード機能

このノードは、NumPy および PyTorch ライブラリを使用して内部で2次元浮動小数点テンソルを生成します。その核心メカニズムは、画像の幅方向に沿って1.0（白）から0.0（黒）への線形グラデーション値を作成することです。複数のフレームを設定すると、各フレームのグラデーションは時間とともにオフセットされ、動的な変化効果を生み出し、最終的に形状が [フレーム数, 高さ, 幅] の MASK タイプのテンソルを出力します。

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

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

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`invert`	BOOLEAN	はい	False	-	: マスクのグラデーション方向を反転します。Trueに設定すると、黒と白の領域が入れ替わります。デフォルト値はFalseです。
`frames`	INT	はい	0	0 - 255 (ステップ: 1)	: 生成するマスクのフレーム数を指定し、バッチシーケンスを作成します。範囲は0から255、ステップは1です。
`width`	INT	はい	256	16 - 4096 (ステップ: 1)	: 生成するマスクの幅（ピクセル値）を設定します。範囲は16から4096、ステップは1です。
`height`	INT	はい	256	16 - 4096 (ステップ: 1)	: 生成するマスクの高さ（ピクセル値）を設定します。範囲は16から4096、ステップは1です。

Output 出力

パラメータ名	データ型	説明
MASK	MASK	: 出力されるグラデーションマスク。シングルチャネルのグレースケールテンソルです。

使用シナリオ

動画生成や画像シーケンス処理のワークフローでは、このノードで生成したグラデーションマスクを「マスクを適用」や「画像をブレンド」するノードに接続できます。例えば、トランジション効果の強度を制御して左から右へのスムーズな移行を実現したり、異なる領域に異なる強度のフィルターを適用したりするために使用できます。

注意事項

このノードが生成するマスクはシングルチャネルのグレースケール画像であることに注意してください。frames パラメータが0より大きい場合、バッチマスクシーケンスを出力するため、下流のノードがバッチ入力を処理できることを確認する必要があります。

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

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

Create Gradient Mask(CreateGradientMask)