Batch Uncrop Advanced (BatchUncropAdvanced) - ComfyUI-KJNodes

Batch Uncrop Advanced 노드는 원본 이미지, 크롭된 이미지, 해당 크롭 마스크, 결합 마스크 및 바운딩 박스 데이터를 입력으로 받습니다.

Batch Uncrop Advanced 노드는 크롭 및 수정된 이미지 조각을 원본 배경 이미지에 정밀하게 재결합하기 위한 고급 이미지 처리 노드입니다. 핵심 기능은 배치 이미지를 처리하고, 마스크와 바운딩 박스를 사용하여 융합 과정을 제어하여 매끄러운 합성 효과를 구현하는 것을 지원합니다.

노드 기능

이 노드는 원본 이미지, 크롭된 이미지, 해당 크롭 마스크, 결합 마스크 및 바운딩 박스 데이터를 입력으로 받습니다. 기술적 구현은 이러한 마스크와 바운딩 박스 정보에 의존하여 이미지를 위치 지정하고 혼합합니다. 블렌드 가장자리 페더링을 지원하며(border_blending 매개변수 통해), 크롭 영역의 크기를 조정(crop_rescale 매개변수 통해)하여 합성 결과를 미세 조정할 수 있습니다.

노드 매개변수 설명 - Batch Uncrop Advanced

연결 입력 (Inputs)

매개변수 이름	데이터 타입	필수	기본값	범위/옵션	설명
`original_images`	IMAGE	예	-	-	original_images (입력 매개변수): 배경으로 사용될 원본 전체 이미지입니다. 크롭된 이미지가 여기에 융합됩니다. 입력 이미지 수는 `cropped_images`와 일치해야 합니다.
`cropped_images`	IMAGE	예	-	-	cropped_images (입력 매개변수): 원본 배경에 다시 붙여넣어야 할 크롭된 이미지 조각입니다. 수는 `original_images`와 동일해야 합니다.
`cropped_masks`	MASK	예	-	-	cropped_masks (입력 매개변수): 각 `cropped_images`에 해당하는 마스크로, 각 크롭 조각에서 융합될 유효 영역을 정의하는 데 사용됩니다.
`combined_crop_mask`	MASK	예	-	-	combined_crop_mask (입력 매개변수): 일반적으로 모든 크롭 영역의 마스크를 병합하여 생성된 결합 마스크로, 전체 붙여넣기 가능 영역을 정의하는 데 사용됩니다.
`bboxes`	BBOX	예	-	-	bboxes (입력 매개변수): 각 `cropped_images`가 `original_images` 내에 배치되어야 할 정확한 위치와 범위를 지정하는 바운딩 박스 목록입니다.
`combined_bounding_box`	BBOX	아니요	-	-	combined_bounding_box (입력 매개변수): 결합 마스크의 전체 영역을 정의하는 선택적 바운딩 박스입니다. 제공되지 않으면 개별 `bboxes`에서 바운딩 박스가 파생됩니다.

컨트롤 매개변수 (Parameters)

매개변수 이름	데이터 타입	필수	기본값	범위/옵션	설명
`border_blending`	실수	예	0.25	0.0 - 1.0 (단계: 0.01)	border_blending (입력 매개변수): 블렌드 경계의 페더링 강도를 제어합니다. 범위는 0.0에서 1.0이며, 단계는 0.01입니다. 값이 클수록 가장자리 전환이 더 부드러워집니다.
`crop_rescale`	실수	예	1.0	0.0 - 10.0 (단계: 0.01)	crop_rescale (입력 매개변수): `cropped_images`에 적용할 크기 조정 비율 인자입니다. 범위는 0.0에서 10.0이며, 단계는 0.01입니다. 1.0은 원본 크기를 유지합니다.
`use_combined_mask`	논리값	예	거짓	-	use_combined_mask (입력 매개변수): 논리값입니다. 참일 경우 `combined_crop_mask`를 사용하여 전역 융합을 제어하고, 거짓일 경우 개별 `cropped_masks`를 사용합니다.
`use_square_mask`	논리값	예	참	-	use_square_mask (입력 매개변수): 논리값입니다. 참일 경우 마스크 형태를 정사각형으로 처리하고, 거짓일 경우 마스크의 원래 형태를 유지합니다.

출력 (Output)

매개변수 이름	데이터 타입	설명
IMAGE	IMAGE	IMAGE (출력 매개변수): 모든 크롭 조각이 원본 배경에 융합된 최종 합성된 전체 이미지를 출력합니다.

사용 시나리오

일반적인 응용은 "인페인팅" 또는 "이미지 복원" 워크플로에서입니다. 예를 들어, 사용자는 먼저 Bounding Box 노드와 같은 다른 노드를 사용하여 원본 이미지에서 수정이 필요한 여러 영역을 선택하고, 이러한 영역을 각각 리페인팅하거나 편집한 후, 이 노드를 사용하여 수정된 모든 영역을 한 번에 자연스럽게 원본 이미지에 다시 붙여넣어 다중 대상 편집을 효율적으로 완료할 수 있습니다.

주의사항

사용 시 입력된 original_images와 cropped_images 두 그룹의 이미지 수가 반드시 정확히 일치해야 합니다. 제공된 바운딩 박스(bboxes) 수가 이미지 수보다 많을 경우, 초과된 바운딩 박스는 자동으로 무시됩니다.

Batch Uncrop Advanced 노드 소스 코드 링크

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

Batch Uncrop Advanced(BatchUncropAdvanced)