Image Crop By Mask And Resize (ImageCropByMaskAndResize) - ComfyUI-KJNodes

Image Crop By Mask And Resize ノードは、入力されたマスクを分析し、値が1のすべてのピクセルを特定し、それらの点を完全に囲む最小の矩形バウンディングボックスを計算します。

Image Crop By Mask And Resize ノードは、提供されたマスクに基づいて画像内の対応する領域を自動的に識別し、切り抜くことができる画像処理ツールです。切り抜き後、ノードはその領域を指定された解像度にリサイズし、処理後の画像、マスク、および切り抜き領域の座標情報を出力します。

ノード機能

このノードはまず、入力されたマスクを分析し、値が1のすべてのピクセルを特定し、それらの点を完全に囲む最小の矩形バウンディングボックスを計算します。次に、設定された最小/最大切り抜き解像度やパディングなどのパラメータに基づいて、このバウンディングボックスを調整および拡張します。最後に、設定された base_resolution に基づいて、切り抜かれた画像とマスク領域をそのサイズに比例的にスケーリングします。

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

入力接続 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`image`	IMAGE	はい	-	-	image（入力パラメータ）：切り抜き対象の元の入力画像。
`mask`	MASK	はい	-	-	mask（入力パラメータ）：切り抜き領域を定義するマスク。白い領域（値1）が保持する部分を示します。

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

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`base_resolution`	整数	はい	512	0 - MAX_RESOLUTION (ステップ: 8)	base_resolution（入力パラメータ）：切り抜き領域が最終的にスケーリングされる目標解像度の一辺の長さ。範囲は0からMAX_RESOLUTIONまでで、調整ステップは8です。
`padding`	整数	はい	0	0 - MAX_RESOLUTION (ステップ: 1)	padding（入力パラメータ）：計算された切り抜きボックスの周囲に追加する余分なピクセル単位のマージン。範囲は0からMAX_RESOLUTIONまでで、調整ステップは1です。
`min_crop_resolution`	整数	はい	128	0 - MAX_RESOLUTION (ステップ: 8)	min_crop_resolution（入力パラメータ）：切り抜きボックスの最小幅と高さがこの値を下回らないようにします。範囲は0からMAX_RESOLUTIONまでで、ステップは8です。
`max_crop_resolution`	整数	はい	512	0 - MAX_RESOLUTION (ステップ: 8)	max_crop_resolution（入力パラメータ）：切り抜きボックスの最大幅と高さがこの値を超えないように制限します。範囲は0からMAX_RESOLUTIONまでで、ステップは8です。

出力 (Output)

パラメータ名	データ型	説明
images	IMAGE	images（出力パラメータ）：切り抜きとスケーリング処理を施された出力画像。
masks	MASK	同じ切り抜きとスケーリング処理を施されたマスク。
bbox	BBOX	bbox（出力パラメータ）：元の画像座標系における、切り抜き領域のバウンディングボックスの座標情報。

使用シナリオ

このノードは、画像の特定部分に焦点を当てて詳細な処理を行うワークフローに非常に適しています。例えば、人物ポートレートの修正ワークフローでは、まずマスクを使用して顔を選択し、このノードを通じて顔領域を個別に切り抜き拡大することができます。これにより、後続のより細かい顔の特徴調整や高解像度修復を、画像全体を処理することなく行うことができます。

注意事項

マスク領域が元の画像の境界を超えている場合、または計算された切り抜きボックスのサイズが元の画像よりも大きい場合、ノードはエラーを報告する可能性があることに注意してください。また、すべての解像度パラメータ（base_resolutionなど）の調整は、通常8をステップとして行います。これは、多くのAIモデルの最適な入力サイズとの互換性を保つためです。

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

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

Image Crop By Mask And Resize(ImageCropByMaskAndResize)