Image Crop By Mask And Resize (ImageCropByMaskAndResize) - ComfyUI-KJNodes

Image Crop By Mask And Resize 노드는 입력된 마스크를 분석하여 값이 1인 모든 픽셀을 찾고, 이 점들을 완전히 둘러싸는 최소 직사각형 바운딩 박스를 계산합니다.

Image Crop By Mask And Resize 노드는 제공된 마스크를 기반으로 이미지에서 해당 영역을 자동으로 인식하고 잘라내는 이미지 처리 도구입니다. 자르기가 완료되면 노드는 해당 영역을 지정된 해상도로 조정하고, 처리된 이미지, 마스크, 그리고 자른 영역의 좌표 정보를 출력합니다.

노드 기능

이 노드는 먼저 입력된 마스크를 분석하여 값이 1인 모든 픽셀을 찾고, 이 점들을 완전히 둘러싸는 최소 직사각형 바운딩 박스를 계산합니다. 그런 다음, 설정한 최소/최대 자르기 해상도, 안쪽 여백 등의 파라미터를 기반으로 이 바운딩 박스를 수정하고 확장합니다. 마지막으로, 설정된 기본 해상도(base_resolution)를 기준으로 잘라낸 이미지와 마스크 영역을 해당 크기에 맞게 비율에 따라 조정합니다.

노드 파라미터 설명 - Image Crop By Mask And Resize

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`image`	IMAGE	예	-	-	image (입력 파라미터): 잘라낼 원본 입력 이미지입니다.
`mask`	MASK	예	-	-	mask (입력 파라미터): 자를 영역을 정의하는 마스크입니다. 흰색(값 1) 영역이 보존할 부분을 나타냅니다.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`base_resolution`	INT	예	512	0 - MAX_RESOLUTION (간격: 8)	base_resolution (입력 파라미터): 자른 영역이 최종적으로 조정될 목표 해상도의 한 변 길이입니다. 범위는 0부터 MAX_RESOLUTION까지이며, 조정 간격은 8입니다.
`padding`	INT	예	0	0 - MAX_RESOLUTION (간격: 1)	padding (입력 파라미터): 계산된 자르기 상자 주변에 추가할 여분의 픽셀 안쪽 여백입니다. 범위는 0부터 MAX_RESOLUTION까지이며, 조정 간격은 1입니다.
`min_crop_resolution`	INT	예	128	0 - MAX_RESOLUTION (간격: 8)	min_crop_resolution (입력 파라미터): 자르기 상자의 최소 너비와 높이가 이 값보다 낮지 않도록 보장합니다. 범위는 0부터 MAX_RESOLUTION까지이며, 간격은 8입니다.
`max_crop_resolution`	INT	예	512	0 - MAX_RESOLUTION (간격: 8)	max_crop_resolution (입력 파라미터): 자르기 상자의 최대 너비와 높이가 이 값을 초과하지 않도록 제한합니다. 범위는 0부터 MAX_RESOLUTION까지이며, 간격은 8입니다.

출력 (Output)

파라미터 이름	데이터 타입	설명
images	IMAGE	images (출력 파라미터): 자르기 및 크기 조정 처리가 완료된 출력 이미지입니다.
masks	MASK	동일하게 자르기 및 크기 조정 처리된 마스크입니다.
bbox	BBOX	bbox (출력 파라미터): 원본 이미지 좌표계에서 자른 영역의 바운딩 박스 좌표 정보입니다.

사용 시나리오

이 노드는 이미지의 특정 부분에 초점을 맞춰 정밀한 처리가 필요한 워크플로에 매우 유용합니다. 예를 들어, 인물 초상화 보정 워크플로에서 먼저 마스크를 사용해 얼굴을 선택한 후, 이 노드를 통해 얼굴 영역만 따로 잘라내고 확대할 수 있습니다. 이를 통해 전체 이미지를 처리하지 않고도 후속 작업에서 더 세밀한 얼굴 특징 조정이나 고해상도 복원을 수행할 수 있습니다.

주의사항

마스크 영역이 원본 이미지의 경계를 벗어나거나, 계산된 자르기 상자 크기가 원본 이미지보다 큰 경우 노드에서 오류가 발생할 수 있습니다. 또한, base_resolution과 같은 모든 해상도 파라미터 조정은 일반적으로 간격 8 단위로 이루어지며, 이는 많은 AI 모델의 최적 입력 크기와 호환되기 위한 것입니다.

Image Crop By Mask And Resize 노드 소스 코드 링크

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

Image Crop By Mask And Resize(ImageCropByMaskAndResize)