Batch Uncrop (BatchUncrop) - ComfyUI-KJNodes

Batch Uncrop 노드는 원본 이미지, 크롭된 이미지 및 해당 경계 상자(BBOX) 데이터를 입력으로 받습니다.

Batch Uncrop 노드는 이미지 합성을 위한 도구로, 핵심 기능은 크롭 처리된 이미지를 원본 배경 이미지의 지정된 위치에 정확하게 다시 배치하는 것입니다. 경계 상자 좌표를 통해 위치를 지정하며, 접합된 가장자리를 부드럽게 블렌딩하여 매끄러운 시각적 융합 효과를 구현합니다.

노드 기능

이 노드는 원본 이미지, 크롭된 이미지 및 해당 경계 상자(BBOX) 데이터를 입력으로 받습니다. 내부 메커니즘은 경계 상자가 정의한 좌표에 따라 크롭 이미지를 원본 이미지의 해당 영역에 다시 합성합니다. 재배치된 이미지의 크기 조정을 지원하며, 조절 가능한 블렌딩 강도를 통해 접합 가장자리를 처리하여 뚜렷한 이음매를 줄입니다. 모든 입력 이미지는 배치 형식이어야 하며, 그 수는 서로 일치해야 합니다.

노드 파라미터 설명 - Batch Uncrop

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`original_images`	IMAGE	예	-	-	original_images (입력 파라미터): 배경으로 사용될 원본 완전 이미지 배치입니다. 크롭된 이미지가 이 이미지에 다시 블렌딩됩니다.
`cropped_images`	IMAGE	예	-	-	cropped_images (입력 파라미터): 원본 배경에 다시 배치해야 할 크롭된 이미지 배치입니다. 수는 원본 이미지와 일치해야 합니다.
`bboxes`	BBOX	예	-	-	bboxes (입력 파라미터): 크롭 이미지가 원본 이미지에서 위치할 경계 상자 좌표 배치로, 정확한 위치 지정에 사용됩니다.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`border_blending`	FLOAT	예	0.25	0.0 - 1.0 (단계: 0.01)	border_blending (입력 파라미터): 접합 가장자리의 블렌딩 강도를 제어합니다. 범위는 0.0에서 1.0이며, 값이 클수록 블렌딩이 더 부드러워집니다.
`crop_rescale`	FLOAT	예	1.0	0.0 - 10.0 (단계: 0.01)	crop_rescale (입력 파라미터): 블렌딩 전에 크롭 이미지에 적용할 스케일링 비율 인자입니다. 범위는 0.0에서 10.0입니다.
`border_top`	BOOLEAN	예	True	-	border_top (입력 파라미터): 재배치된 이미지의 상단 가장자리에 블렌딩 효과를 적용할지 여부를 제어하는 부울 값입니다.
`border_bottom`	BOOLEAN	예	True	-	border_bottom (입력 파라미터): 재배치된 이미지의 하단 가장자리에 블렌딩 효과를 적용할지 여부를 제어하는 부울 값입니다.
`border_left`	BOOLEAN	예	True	-	border_left (입력 파라미터): 재배치된 이미지의 왼쪽 가장자리에 블렌딩 효과를 적용할지 여부를 제어하는 부울 값입니다.
`border_right`	BOOLEAN	예	True	-	border_right (입력 파라미터): 재배치된 이미지의 오른쪽 가장자리에 블렌딩 효과를 적용할지 여부를 제어하는 부울 값입니다.

출력 (Output)

파라미터 이름	데이터 타입	설명
IMAGE	IMAGE	IMAGE (출력 파라미터): 합성된 최종 이미지 배치를 출력합니다.

사용 시나리오

일반적인 사용 시나리오는 인물 보정 워크플로우입니다: 먼저 감지 노드를 사용하여 얼굴 영역을 찾아내고 크롭하여 확대한 후 세부 보정(예: 잡티 제거, 해상도 향상)을 수행합니다. 그런 다음 Batch Uncrop 노드를 사용하여 보정된 얼굴 이미지를 원본 사진의 해당 위치에 매끄럽게 블렌딩하여, 부분적으로 향상된 전체 이미지를 얻습니다.

주의사항

사용 시 입력된 original_images와 cropped_images 두 이미지 배치의 수가 정확히 일치하는지 확인해야 합니다. 제공된 경계 상자(bboxes) 수가 이미지 수보다 많을 경우, 노드는 자동으로 초과된 경계 상자를 버립니다.

Batch Uncrop 노드 소스 코드 링크

Batch Uncrop 노드는 ComfyUI-KJNodes 노드 패키지에서 제공됩니다.

Batch Uncrop(BatchUncrop)

Batch Uncrop