Merge Masks 🎥🅥🅗🅢 (MergeMasks) - ComfyUI-VideoHelperSuite

Merge Masks 🎥🅥🅗🅢 ノードは、2つの MASK タイプの入力を受け取り、サイズ不一致の場合に複数のマージ戦略（Aに合わせる、Bに合わせる、小さい方に合わせる、大きい方に合わせるなど）をサポートします。

Merge Masks ノードは Video Helper Suite のツールの一つで、2つの独立したマスク（Mask）を1つに結合するために特化しています。その中核機能は、ユーザーが選択した戦略に基づいて、異なるソースからのマスク情報をインテリジェントに融合または組み合わせ、後続の画像または動画処理ステップに統一されたマスクデータを提供することです。

ノード機能

このノードは2つの MASK タイプの入力を受け取り、サイズ不一致の場合に複数のマージ戦略（Aに合わせる、Bに合わせる、小さい方に合わせる、大きい方に合わせるなど）をサポートします。入力マスクのサイズが異なる場合、ノードは選択された戦略とスケーリング方法（バイリニア、最近傍法など）およびクロップ方法に基づいて、一方のマスクのサイズをもう一方に合わせるように自動調整し、正しくマージできるようにします。その内部実装は PyTorch テンソル操作と ComfyUI の汎用スケーリング関数に依存しています。

ノードパラメータ説明 - Merge Masks 🎥🅥🅗🅢

入力 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`mask_A`	MASK	はい	-	-	マージ操作の基礎または参照の一つとなる、最初に入力するマスク画像。
`mask_B`	MASK	はい	-	-	`mask_A` とマージ操作を行う、2番目に入力するマスク画像。
`merge_strategy`	MERGESTRATEGIES	はい	-	Match B (MATCH_B), Match Smaller (MATCH_SMALLER), Match Larger (MATCH_LARGER).	マージ時にどのマスクの寸法に合わせるかを決定するために使用される戦略。
`scale_method`	SCALEMETHODS	はい	-	最近傍補間 (nearest) など	リサイズが必要な場合にマスクをスケーリングするために使用される方法。
`crop`	CROPMETHODS	はい	-	無効など	スケーリング処理中に適用されるクロップ方法。

出力 (Output)

パラメータ名	データ型	説明
MASK	MASK	マージ後に生成された新しいマスク画像。
count	INT	通常、マージ後のマスク内の有効領域の数やその他のカウント情報を示す整数値を出力します。

使用シナリオ

動画処理ワークフローにおいて、このノードは非常に実用的です。例えば、動体検出から得られたオブジェクトマスクと、カラーキーイングから得られた背景マスクがある場合、このノードを使用してそれらをマージすることで、前景オブジェクトと特定の背景領域の両方を含む複合マスクを取得でき、より複雑な合成や特殊効果の適用に使用できます。

注意事項

マージ結果の品質は、入力マスクの品質および選択されたスケーリングとクロップ方法に大きく依存することに注意してください。不適切なスケーリング方法は、マスクのエッジにジャギーやぼやけを生じさせ、最終的な合成効果に影響を与える可能性があります。

Merge Masks 🎥🅥🅗🅢 ノードソースコードリンク

Merge Masks 🎥🅥🅗🅢 ノードは ComfyUI-VideoHelperSuite ノードパッケージに含まれています。

Merge Masks 🎥🅥🅗🅢(MergeMasks)

Merge Masks