Batch Uncrop Advanced (BatchUncropAdvanced) - ComfyUI-KJNodes

Batch Uncrop Advanced ノードは、元画像、切り抜かれた画像、対応する切り抜きマスク、結合マスク、およびバウンディングボックスデータを入力として受け取ります。

Batch Uncrop Advanced ノードは、切り抜きおよび編集された画像フラグメントを元の背景画像に正確に再統合するための高度な画像処理ノードです。その中核機能は、バッチ画像を処理し、マスクとバウンディングボックスを使用して統合プロセスを制御し、シームレスな合成結果を実現することです。

ノード機能

このノードは、元画像、切り抜かれた画像、対応する切り抜きマスク、結合マスク、およびバウンディングボックスデータを入力として受け取ります。その技術的な実装は、これらのマスクとバウンディングボックス情報に依存して画像を位置決めおよびブレンドします。統合エッジのフェード（border_blending パラメータによる）をサポートし、切り抜き領域のスケーリング（crop_rescale パラメータによる）を許可して、合成結果を微調整できます。

ノードパラメータ説明 - Batch Uncrop Advanced

入力接続 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`original_images`	IMAGE	はい	-	-	original_images (入力パラメータ): 背景として使用される元の完全な画像。切り抜かれた画像はここに統合されます。入力画像の数は `cropped_images` と一致する必要があります。
`cropped_images`	IMAGE	はい	-	-	cropped_images (入力パラメータ): 元の背景に貼り戻す必要がある切り抜かれた画像フラグメント。数は `original_images` と同じである必要があります。
`cropped_masks`	MASK	はい	-	-	cropped_masks (入力パラメータ): 各 `cropped_images` に対応するマスク。各切り抜きフラグメント内で統合する有効な領域を定義します。
`combined_crop_mask`	MASK	はい	-	-	combined_crop_mask (入力パラメータ): 通常、すべての切り抜き領域のマスクをマージして作成される結合マスク。全体の貼り付け可能領域を定義します。
`bboxes`	BBOX	はい	-	-	bboxes (入力パラメータ): 各 `cropped_images` を `original_images` 内のどこに配置するかを指定するバウンディングボックスのリスト。
`combined_bounding_box`	BBOX	いいえ	-	-	combined_bounding_box (入力パラメータ): オプションのバウンディングボックスで、結合マスクの全体的な領域を定義します。指定しない場合は、個々の `bboxes` からバウンディングボックスが導出されます。

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

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`border_blending`	FLOAT	はい	0.25	0.0 - 1.0 (ステップ: 0.01)	border_blending (入力パラメータ): 統合境界のフェード強度を制御します。範囲は 0.0 から 1.0、ステップは 0.01 です。値が大きいほど、エッジの遷移が滑らかになります。
`crop_rescale`	FLOAT	はい	1.0	0.0 - 10.0 (ステップ: 0.01)	crop_rescale (入力パラメータ): `cropped_images` に適用するスケーリング係数。範囲は 0.0 から 10.0、ステップは 0.01 です。1.0 は元のサイズを維持します。
`use_combined_mask`	BOOLEAN	はい	False	-	use_combined_mask (入力パラメータ): ブール値。True の場合、`combined_crop_mask` を使用してグローバルな統合を制御します。False の場合、個々の `cropped_masks` を使用します。
`use_square_mask`	BOOLEAN	はい	True	-	use_square_mask (入力パラメータ): ブール値。True の場合、マスク形状を正方形として処理します。False の場合、マスクの元の形状を保持します。

出力 (Output)

パラメータ名	データ型	説明
IMAGE	IMAGE	IMAGE (出力パラメータ): すべての切り抜きフラグメントが元の背景に統合された最終的な合成画像を出力します。

使用シナリオ

典型的な応用例は、「部分的な再描画」または「画像修復」ワークフローです。例えば、ユーザーはまず他のノード (Bounding Box ノードなど) を使用して元画像から編集が必要な複数の領域を選択し、それらの領域をそれぞれ再描画または編集した後、このノードを使用してすべての編集済み領域を一度に自然に元の画像に貼り戻すことで、複数ターゲットの編集を効率的に完了できます。

注意事項

使用する際には、入力される original_images と cropped_images の2つの画像グループの数が厳密に一致している必要があります。提供されたバウンディングボックス (bboxes) の数が画像の数より多い場合、余分なバウンディングボックスは自動的に無視されます。

Batch Uncrop Advanced ノードソースコードリンク

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

Batch Uncrop Advanced(BatchUncropAdvanced)