Batch Crop From Mask (BatchCropFromMask) - ComfyUI-KJNodes

Batch Crop From Mask 노드는 기술적 구현 관점에서, IMAGE 타입의 원본 이미지와 MASK 타입의 마스크를 입력으로 받습니다.

Batch Crop From Mask 노드는 제공된 마스크(Mask)를 기반으로 이미지 내 목표 영역을 자동으로 인식하고 잘라내는 배치 이미지 처리 도구입니다. 이 노드의 핵심 기능은 각 마스크의 0이 아닌 픽셀 영역을 분석하여 해당 경계 상자(Bounding Box)를 계산하고, 이 범위를 사용하여 원본 이미지에서 해당 부분 이미지를 잘라내는 것입니다.

노드 기능

기술적 구현 관점에서, 이 노드는 IMAGE 타입의 원본 이미지와 MASK 타입의 마스크를 입력으로 받습니다. 각 이미지와 마스크 쌍을 순회하며, 마스크 내 0이 아닌 픽셀의 좌표를 통해 최소 외접 사각형을 계산합니다. 이 노드는 경계 상자 크기의 평활화를 지원하며, bbox_smooth_alpha 매개변수를 통해 현재 프레임과 이전 프레임의 경계 상자 크기 간 혼합 정도를 조절할 수 있어 시퀀스 처리 시 더 안정적인 자르기 결과를 얻는 데 도움이 됩니다. 계산된 경계 상자 크기는 crop_size_mult 계수를 곱해 스케일링되어 최종 자르기 영역 크기를 유연하게 조정합니다.

노드 매개변수 설명 - Batch Crop From Mask

연결 입력 (Inputs)

매개변수 이름	데이터 타입	필수	기본값	범위/옵션	설명
`original_images`	IMAGE	예	-	-	**: 출력되는 원본 이미지 시퀀스로, 입력과 동일합니다. 타입은 IMAGE입니다.
`masks`	MASK	예	-	-	**: 원본 이미지에서 자를 목표 영역을 결정하는 데 사용되는 입력 마스크 시퀀스입니다. 마스크 내 0이 아닌 픽셀 영역이 경계 상자로 계산됩니다. 타입은 MASK입니다.

컨트롤 매개변수 (Parameters)

매개변수 이름	데이터 타입	필수	기본값	범위/옵션	설명
`crop_size_mult`	FLOAT	예	1.0	0.0 - 10.0 (간격: 0.001)	**: 계산된 경계 상자 크기를 스케일링하는 데 사용되는 자르기 크기 배수입니다. 범위는 0.0부터 10.0까지이며, 간격은 0.001입니다.
`bbox_smooth_alpha`	FLOAT	예	0.5	0.0 - 1.0 (간격: 0.01)	**: 현재 프레임과 이전 프레임의 경계 상자 크기를 혼합하여 부드러운 전환을 구현하는 경계 상자 평활 계수입니다. 범위는 0.0부터 1.0까지이며, 간격은 0.01입니다.

출력 (Output)

매개변수 이름	데이터 타입	설명
original_images	IMAGE	**: 출력되는 원본 이미지 시퀀스로, 입력과 동일합니다. 타입은 IMAGE입니다.
cropped_images	IMAGE	**: 출력되는 자른 후의 이미지 시퀀스입니다. 타입은 IMAGE입니다.
bboxes	BBOX	**: 출력되는 경계 상자 좌표 시퀀스로, 형식은 (x1, y1, x2, y2)입니다. 타입은 BBOX입니다.
width	INT	**: 출력되는 자른 후 이미지의 통일된 너비입니다. 타입은 INT입니다.
height	INT	**: 출력되는 자른 후 이미지의 통일된 높이입니다. 타입은 INT입니다.

사용 시나리오

실제 워크플로에서 이 노드는 이미지의 특정 부분에 초점을 맞춰야 하는 시나리오에서 자주 사용됩니다. 예를 들어, 애니메이션 제작이나 비디오 시퀀스 처리 시, 먼저 SAM 또는 GroundingDino와 같은 마스크 생성 노드를 사용하여 각 프레임의 주요 객체를 인식한 후, 생성된 마스크 시퀀스와 원본 이미지 시퀀스를 이 노드에 연결할 수 있습니다. 노드는 자른 이미지 시퀀스와 해당 경계 상자 좌표를 출력하며, 이 출력은 로컬 리페인팅, 초해상도 처리 또는 다른 이미지 처리 노드의 입력으로 추가로 사용될 수 있습니다.

Batch Crop From Mask 노드 소스 코드 링크

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

Batch Crop From Mask(BatchCropFromMask)