ImagePad KJ (ImagePadKJ) - ComfyUI-KJNodes

ImagePad KJ 노드는 가장자리 픽셀 복제, 단색 사용 또는 블러 효과 적용을 포함한 다양한 패딩 모드를 지원하며, 이미지 데이터와 해당 마스크 데이터를 동시에 처리할 수 있습니다.

ImagePad KJ는 입력된 이미지와 선택적 마스크에 테두리 또는 패딩 영역을 추가하기 위한 전용 이미지 처리 노드입니다. 핵심 기능은 사용자가 이미지 상하좌우의 확장 크기와 채우기 방식을 정밀하게 제어하여 이미지 구도를 조정하거나 후속 처리 단계를 위한 캔버스를 준비할 수 있게 하는 것입니다.

노드 기능

이 노드는 가장자리 픽셀 복제, 단색 사용 또는 블러 효과 적용을 포함한 다양한 패딩 모드를 지원하며, 이미지 데이터와 해당 마스크 데이터를 동시에 처리할 수 있습니다. 표준 IMAGE 및 MASK 텐서를 입력으로 받아, 상, 하, 좌, 우 네 방향의 픽셀 값을 지정하여 패딩 영역을 정의하고, 출력 이미지와 마스크의 크기가 동기화되어 변경되도록 합니다.

노드 파라미터 설명 - 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 값, 색상 이름 또는 헥스 코드로 표현된 색상
`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