Image Crop By Mask Batch (ImageCropByMaskBatch) - ComfyUI-KJNodes

Image Crop By Mask Batch ノードは、画像（IMAGE）とマスク（MASK）を入力として受け取ります。マスクは画像内で保持する領域を定義するために使用されます。

Image Crop By Mask Batch ノードは、提供されたマスクに基づいて入力画像を一括でクロップできる効率的な画像処理ツールです。その中核機能は、マスク領域を自動的に識別し、その領域を元の画像から正確に抽出して、新しい画像と対応するマスクを生成することです。

ノード機能

このノードは、画像（IMAGE）とマスク（MASK）を入力として受け取ります。マスクは画像内で保持する領域を定義します。ノードは各マスクの有効領域のバウンディングボックスを計算し、指定された幅、高さ、およびパディング値に基づいてクロップを行います。マスクのサイズが画像と一致しない場合、ノードは自動的に補間調整を行います。クロップされた領域は新しいキャンバスの中央に配置され、カスタム背景色がサポートされています。

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

接続入力（Inputs）

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`image`	IMAGE	はい	-	-	image（入力パラメータ）：クロップされる元の入力画像。
`masks`	MASK	はい	-	-	クロップ領域を定義するために使用されるマスク。

コントロールパラメータ（Parameters）

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`width`	INT	はい	-	-	width（入力パラメータ）：クロップ後の出力画像の幅。
`height`	INT	はい	-	-	height（入力パラメータ）：クロップ後の出力画像の高さ。
`padding`	INT	はい	0	0 - 4096（ステップ：1）	padding（入力パラメータ）：マスク領域のバウンディングボックスの外側に追加で拡張するピクセル数。範囲は0から4096まで。
`preserve_size`	BOOLEAN	はい	False	-	preserve_size（入力パラメータ）：Trueの場合、widthおよびheightパラメータは無視され、出力画像は元のサイズを保持します。
`bg_color`	STRING	はい	0, 0, 0	-	0〜255または0.0〜1.0の範囲のRGB値、色名、または16進コードで指定される色。

出力

パラメータ名	データ型	説明
images	IMAGE	images（出力パラメータ）：マスクに基づいてクロップされて生成された画像の集合。
masks	MASK	クロップおよび調整された後のマスク。

使用シナリオ

このノードは、画像修復やローカルリタッチングのワークフローで非常に有用です。例えば、まずマスク生成ノード（SAMやマスクエディターなど）を使用して画像内で修正が必要な部分（顔など）をマークし、その後このノードを使用してマークされた領域をクロップし、個別に詳細調整やスタイライズ処理を行い、最後に元の画像に合成し戻すことができます。

注意事項

入力されるマスクは、単一チャンネルの二値画像でなければならないことに注意してください。白色（または非ゼロ値）の領域が保持する部分を表します。マスクが完全に黒色（つまり有効な領域がない）の場合、そのマスクに対応する画像は処理されません。

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

Image Crop By Mask Batch ノードは ComfyUI-KJNodes ノードパッケージから提供されています。

Image Crop By Mask Batch(ImageCropByMaskBatch)