Image Uncrop By Mask (ImageUncropByMask) - ComfyUI-KJNodes

Image Uncrop By Mask ノードは、デスティネーション画像、ソース画像、マスク、およびバウンディングボックスを入力として受け取ります。

Image Uncrop By Mask ノードは、指定されたマスクとバウンディングボックスに基づいて、ソース画像をデスティネーション画像の特定領域にシームレスに合成するために使用されます。その中核となる機能は、「逆クロップ」操作を実行することで、ユーザーが1つの画像要素を別の画像の指定位置に正確に埋め込み、マスクを利用してスムーズな融合を実現できるようにします。

ノードの機能

このノードは、デスティネーション画像、ソース画像、マスク、およびバウンディングボックスを入力として受け取ります。内部では、バウンディングボックスの寸法に合わせて Lanczos アルゴリズムを使用してソース画像をアップサンプリングし、バイリニア補間を使用してマスクをアップサンプリングします。その後、パディング値を計算し、調整されたソース画像とマスクをデスティネーション画像の対応する座標位置に正確に配置し、最終的に合成された完全な画像を出力します。

ノードパラメータ説明 - Image Uncrop By Mask

入力 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`destination`	IMAGE	はい	-	-	destination (入力パラメータ): 背景となるデスティネーション画像。ソース画像はこの画像上に合成されます。
`source`	IMAGE	はい	-	-	source (入力パラメータ): デスティネーション画像上に合成する必要があるソース画像。
`mask`	MASK	はい	-	-	mask (入力パラメータ): ソース画像のどの部分をデスティネーション画像に合成するかを定義するマスク。通常はシングルチャンネルです。
`bbox`	BBOX	はい	-	-	ソース画像をデスティネーション画像内のどこに配置するかの位置と範囲を指定するために使用されます。

出力 (Output)

パラメータ名	データ型	説明
`image`	IMAGE	image (出力パラメータ): 合成後の最終的な出力画像。

使用シナリオ

典型的な使用シナリオは、画像の修復や編集時に、ユーザーがまず他のノード (例: Bounding Box 検出器) を使用して置換が必要な領域を特定し、その後このノードを使用して新しい画像コンテンツ (例: 修復された断片) をオリジナル画像に正確に貼り戻すことです。これは、顔の置き換え、オブジェクト除去後の塗りつぶし、または局所的なスタイル転送などのワークフローで一般的です。

Image Uncrop By Mask ノードソースコードリンク

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

Image Uncrop By Mask(ImageUncropByMask)