ImagePad KJ (ImagePadKJ) - ComfyUI-KJNodes

ImagePad KJノードは、エッジピクセルの複製、単色の使用、またはぼかし効果の適用など、複数のパディングモードをサポートし、画像データと対応するマスクデータを同時に処理できます。

ImagePad KJは、入力画像とオプションのマスクにボーダーやパディング領域を追加するための専用画像処理ノードです。その中核機能は、画像の上下左右の拡張サイズとパディング方法をユーザーが正確に制御できるようにし、画像の構図を調整したり、後続の処理ステップのためのキャンバスを準備したりすることです。

ノード機能

このノードは、エッジピクセルの複製、単色の使用、またはぼかし効果の適用など、複数のパディングモードをサポートし、画像データと対応するマスクデータを同時に処理できます。標準的なIMAGEおよびMASKテンソルを入力として受け取り、上下左右の4方向のピクセル値を指定してパディング領域を定義し、出力画像とマスクのサイズが同期して変化することを保証します。

ノードパラメータ説明 - ImagePad KJ

接続入力 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`image`	IMAGE	はい	-	-	image（入力パラメータ）：パディングが必要な元の入力画像。ノードはこの画像に指定されたパディング設定を適用します。
`mask`	MASK	いいえ	-	-	mask（入力パラメータ）：オプション入力、画像に対応するマスク。ノードはこれを画像と同じサイズにスケーリングした後、同じパディング設定を適用します。

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

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`pad_mode`	COMBO	はい	edge	"edge", "edge_pixel", "color", "pillarbox_blur"	`edge_pixel`（単一のエッジピクセルを複製）、`color`（指定色を使用）、`pillarbox_blur`（エッジをぼかしてシネマティックな黒枠効果を作成）。
`left`	INT	はい	0	0 - MAX_RESOLUTION (ステップ: 1)	left（入力パラメータ）：画像の左側に追加するパディング領域の幅をピクセル単位で指定します。範囲は0からMAX_RESOLUTION、ステップは1です。
`right`	INT	はい	0	0 - MAX_RESOLUTION (ステップ: 1)	right（入力パラメータ）：画像の右側に追加するパディング領域の幅をピクセル単位で指定します。範囲は0からMAX_RESOLUTION、ステップは1です。
`top`	INT	はい	0	0 - MAX_RESOLUTION (ステップ: 1)	top（入力パラメータ）：画像の上部に追加するパディング領域の高さをピクセル単位で指定します。範囲は0からMAX_RESOLUTION、ステップは1です。
`bottom`	INT	はい	0	0 - MAX_RESOLUTION (ステップ: 1)	bottom（入力パラメータ）：画像の下部に追加するパディング領域の高さをピクセル単位で指定します。範囲は0からMAX_RESOLUTION、ステップは1です。
`extra_padding`	INT	はい	0	0 - MAX_RESOLUTION (ステップ: 1)	上下左右の指定パディング量に加えて、すべての辺に均一に追加するピクセル値。範囲は0からMAX_RESOLUTION、ステップは1です。
`color`	STRING	はい	0, 0, 0	-	0-255または0.0-1.0の範囲のRGB値、色名、または16進コードとしての色
`target_width`	INT	いいえ	—	0 - MAX_RESOLUTION (ステップ: 1)	-
`target_height`	INT	いいえ	—	0 - MAX_RESOLUTION (ステップ: 1)	-

Output 出力

パラメータ名	データ型	説明
images	IMAGE	images（出力パラメータ）：パディング処理後の画像を出力します。
masks	MASK	masks（出力パラメータ）：同期してパディング処理後のマスクを出力します。

使用シナリオ

不規則なサイズの画像を特定のアスペクト比に統一する必要があるワークフローで、このノードは非常に有用です。例えば、固定サイズのAIモデルに入力する前に、さまざまなソースからの画像をバッチ処理する際に、黒枠（pillarbox）やぼかし背景を追加して、すべての入力サイズを一貫させながら、元の画像内容が歪まないようにすることができます。

注意事項

過度に大きなパディング値は、最終的な画像解像度がシステムの処理能力を超える可能性があることに注意してください。また、マスクが提供された場合、ノードはパディング操作の前に自動的にそれを入力画像と同じサイズにスケーリングします。

ImagePad KJ ノードソースコードリンク

ImagePad KJ ノードは ComfyUI-KJNodes ノードパッケージから提供されています。

ImagePad KJ(ImagePadKJ)

Image Pad KJ