Image Uncrop By Mask (ImageUncropByMask) - ComfyUI-KJNodes

Image Uncrop By Mask 노드는 대상 이미지, 소스 이미지, 마스크 및 경계 상자(Bounding Box)를 입력으로 받습니다.

Image Uncrop By Mask 노드는 지정된 마스크와 경계 상자를 사용하여 소스 이미지를 대상 이미지의 특정 영역에 자연스럽게 합성하는 데 사용됩니다. 핵심 기능은 "역 자르기(Uncrop)" 작업을 수행하여 사용자가 한 이미지의 요소를 다른 이미지의 지정된 위치에 정밀하게 삽입하고, 마스크를 활용해 매끄럽게 융합할 수 있도록 합니다.

노드 기능

이 노드는 대상 이미지(destination), 소스 이미지(source), 마스크(mask) 및 경계 상자(bbox)를 입력으로 받습니다. 내부적으로는 경계 상자의 크기에 따라 Lanczos 알고리즘을 사용하여 소스 이미지를 업샘플링하고, 쌍선형 보간법(Bilinear Interpolation)을 사용하여 마스크를 업샘플링합니다. 이후 패딩 값을 계산하여 조정된 소스 이미지와 마스크를 대상 이미지의 해당 좌표 위치에 정확히 배치하고, 최종적으로 합성된 완전한 이미지를 출력합니다.

노드 파라미터 설명 - Image Uncrop By Mask

입력

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`destination`	IMAGE	예	-	-	destination (입력 파라미터): 배경이 되는 대상 이미지입니다. 소스 이미지가 이 이미지 위에 합성됩니다.
`source`	IMAGE	예	-	-	source (입력 파라미터): 대상 이미지 위에 합성될 소스 이미지입니다.
`mask`	MASK	예	-	-	mask (입력 파라미터): 소스 이미지 중 어떤 부분이 대상 이미지에 합성되어야 하는지를 정의하는 마스크로, 일반적으로 단일 채널입니다.
`bbox`	BBOX	예	-	-	소스 이미지가 대상 이미지 내에 배치될 위치와 범위를 지정하는 데 사용됩니다.

출력

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

사용 시나리오

일반적인 사용 시나리오는 이미지 복원 또는 편집 시, 사용자가 먼저 다른 노드(예: Bounding Box 감지기)를 사용하여 교체해야 할 영역을 결정한 다음, 이 노드를 사용하여 새로운 이미지 콘텐츠(예: 복원된 조각)를 원본 이미지에 정밀하게 다시 붙여넣는 것입니다. 이는 얼굴 교체, 객체 제거 후 채우기, 또는 지역적 스타일 전이(style transfer) 워크플로우에서 흔히 볼 수 있습니다.

Image Uncrop By Mask 노드 소스 코드 링크

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

Image Uncrop By Mask(ImageUncropByMask)