Create Fade Mask (CreateFadeMask) - ComfyUI-KJNodes

Create Fade Mask ノードは、動的でカスタマイズ可能なグラデーションマスクシーケンスを生成します。その中核機能は、設定されたキーポイントに基づいて各フレームのグレースケール値が滑らかに遷移する複数の画像フレームからなるバッチを作成し、時間（フレームシーケンス）とともに変化するマスクを形成することです。このマスクは、他の画像処理ノードの透明度や影響範囲を制御するために直接使用できます。

ノード機能

このノードは、開始、中間、終了の3つのキーフレームにおけるグレースケール値（0.0から1.0の間）を設定し、異なる補間アルゴリズム（リニア、イーズイン、イーズアウト、イーズインアウトなど）を選択することで、中間の各フレームのピクセル値を計算します。形状が (フレーム数, 高さ, 幅) でデータ型が float32 の NumPy 配列を生成し、最終的に ComfyUI の標準 MASK フォーマットとして出力します。midpoint_frame が 0 に設定されている場合、中点は自動的に総フレーム数の半分に設定されます。

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

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

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`interpolation`	COMBO	はい	linear	"linear", "ease_in", "ease_out", "ease_in_out"	補間方法を選択します。"linear"（リニア）、"ease_in"（イーズイン）、"ease_out"（イーズアウト）、"ease_in_out"（イーズインアウト）のいずれかで、グラデーションの速度曲線に影響します。
`invert`	BOOLEAN	はい	False	-	ブール値スイッチ。True に設定すると、生成されたマスクシーケンス全体が反転処理されます（例：1.0 は 0.0 に、0.5 は 0.5 のまま、など）。
`frames`	INT	はい	2	2 - 10000 (ステップ: 1)	生成するマスクの総フレーム数を指定します。範囲は 2 から 10000 で、ステップは 1 です。これにより出力シーケンスの長さが決まります。
`width`	INT	はい	256	16 - 4096 (ステップ: 1)	生成するマスクの幅（ピクセル値）を設定します。範囲は 16 から 4096 で、ステップは 1 です。
`height`	INT	はい	256	16 - 4096 (ステップ: 1)	生成するマスクの高さ（ピクセル値）を設定します。範囲は 16 から 4096 で、ステップは 1 です。
`start_level`	FLOAT	はい	1.0	0.0 - 1.0 (ステップ: 0.01)	シーケンスの最初のフレームのグローバルなグレースケール値を定義します。範囲は 0.0（黒）から 1.0（白）で、ステップは 0.01 です。
`midpoint_level`	FLOAT	はい	0.5	0.0 - 1.0 (ステップ: 0.01)	`midpoint_frame` で指定されたフレームのグレースケール値を定義します。範囲は 0.0 から 1.0 で、ステップは 0.01 です。
`end_level`	FLOAT	はい	0.0	0.0 - 1.0 (ステップ: 0.01)	シーケンスの最後のフレームのグローバルなグレースケール値を定義します。範囲は 0.0 から 1.0 で、ステップは 0.01 です。
`midpoint_frame`	INT	はい	0	0 - 4096 (ステップ: 1)	グラデーションの中点として扱うフレームのインデックスを指定します。範囲は 0 から 4096 で、ステップは 1 です。値が 0 の場合、自動的に総フレーム数の半分が使用されます。

Output

パラメータ名	データ型	説明
MASK	MASK	出力されるグラデーションマスクシーケンス。複数フレームのグレースケール画像の集合であり、透明度やブレンド効果の制御に使用できます。

使用シナリオ

ビデオトランジションや画像ブレンディングのワークフローにおいて、このノードは非常に有用です。例えば、生成されたマスクシーケンスを VAEEncode や ImageComposite などのノードに接続し、マスクのグラデーション値を利用して、2つのビデオクリップ間のフェードイン/フェードアウト効果を制御したり、1枚の画像が別の画像に滑らかに溶け込むようなトランジションを作成したりできます。

注意事項

このノードは「非推奨」カテゴリに分類されていることに注意してください。これは、更新版やより優れた代替案が存在する可能性があることを意味します。出力されるマスクの解像度は幅と高さのパラメータによって制限され、最大 4096x4096 です。また、フレーム数の上限は 10000 です。

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

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

Create Fade Mask(CreateFadeMask)

Create Fade Mask