Batch Crop From Mask Advanced (BatchCropFromMaskAdvanced) - ComfyUI-KJNodes

Batch Crop From Mask Advanced 노드는 이미지(IMAGE)와 마스크(MASK)를 입력으로 받아, 마스크 내에서 0이 아닌 픽셀의 바운딩 박스를 계산하여 크롭 영역을 결정합니다.

Batch Crop From Mask Advanced는 제공된 마스크를 기반으로 원본 이미지에서 대상 영역을 자동으로 식별하고 배치 크롭할 수 있는 고급 이미지 크롭 노드입니다. 핵심 기능은 마스크로 정의된 관심 영역을 이미지 세트에서 정확하게 추출하여 크롭된 이미지와 마스크를 출력함과 동시에 관련된 바운딩 박스 정보를 제공하는 것입니다.

노드 기능

이 노드는 이미지(IMAGE)와 마스크(MASK)를 입력으로 받아, 마스크 내에서 0이 아닌 픽셀의 바운딩 박스를 계산하여 크롭 영역을 결정합니다. 배치 처리를 지원하며, 바운딩 박스 평활화 메커니즘을 포함합니다. bbox_smooth_alpha 매개변수는 현재 프레임과 이전 프레임의 바운딩 박스 위치 및 크기 간의 전환 부드러움을 조정하며, 이는 비디오나 이미지 시퀀스를 처리할 때 크롭 안정성을 유지하는 데 특히 유용합니다. 또한, crop_size_mult 매개변수를 통해 사용자는 크롭 영역을 비례적으로 확대하여 대상 객체가 완전히 포함되도록 할 수 있습니다.

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

연결 입력 (Inputs)

매개변수 이름	데이터 타입	필수	기본값	범위/옵션	설명
`original_images`	IMAGE	예	-	-	original_images (입력 매개변수): 대상 영역이 크롭될 원본 이미지입니다. 이 이미지는 변경 없이 출력으로 전달됩니다.
`masks`	MASK	예	-	-	masks (입력 매개변수): 원본 이미지에 대응하는 마스크 시퀀스를 입력합니다. 각 이미지에서 크롭할 대상 영역을 정의하는 데 사용됩니다.

컨트롤 매개변수 (Parameters)

매개변수 이름	데이터 타입	필수	기본값	범위/옵션	설명
`crop_size_mult`	FLOAT	예	1.0	0.0 - 10.0 (스텝: 0.01)	crop_size_mult (입력 매개변수): 크롭 크기 배율입니다. 마스크를 기반으로 계산된 원본 바운딩 박스를 비례적으로 확대하는 데 사용됩니다. 범위는 0.0부터 10.0까지이며, 스텝은 0.01입니다.
`bbox_smooth_alpha`	FLOAT	예	0.5	0.0 - 1.0 (스텝: 0.01)	bbox_smooth_alpha (입력 매개변수): 바운딩 박스 평활화 계수입니다. 연속된 이미지 프레임 간에 바운딩 박스의 위치와 크기 변화를 부드럽게 만드는 데 사용됩니다. 범위는 0.0부터 1.0까지이며, 스텝은 0.01입니다.

출력 (Output)

매개변수 이름	데이터 타입	설명
original_images	IMAGE	original_images (출력 매개변수): 입력된 원본 이미지를 그대로 출력하여 워크플로 연결을 용이하게 합니다.
cropped_images	IMAGE	cropped_images (출력 매개변수): 각 마스크에 따라 크롭된 이미지를 출력합니다.
cropped_masks	MASK	동일한 영역으로 크롭된 마스크입니다.
combined_crop_image	IMAGE	combined_crop_image (출력 매개변수): 모든 크롭된 이미지를 연결하여 조합한 단일 이미지를 출력합니다.
combined_crop_masks	MASK	combined_crop_masks (출력 매개변수): 모든 크롭된 마스크를 연결하여 조합한 단일 마스크를 출력합니다.
bboxes	BBOX	bboxes (출력 매개변수): 각 입력 이미지에 대해 계산된 바운딩 박스 좌표 목록을 출력합니다.
combined_bounding_box	BBOX	combined_bounding_box (출력 매개변수): 모든 개별 바운딩 박스를 포함하는 전체 바운딩 박스를 출력합니다.
bbox_width	INT	bbox_width (출력 매개변수): `combined_bounding_box`의 너비 값을 출력합니다.
bbox_height	INT	bbox_height (출력 매개변수): `combined_bounding_box`의 높이 값을 출력합니다.

사용 시나리오

실제 애플리케이션에서 이 노드는 일련의 이미지에서 특정 객체를 추출하여 후속 처리를 해야 하는 워크플로에 자주 사용됩니다. 예를 들어, 캐릭터 애니메이션이나 제품 전시물을 제작할 때, 먼저 세그멘테이션 모델을 사용하여 대상 객체의 마스크를 생성한 다음, 원본 이미지와 마스크를 이 노드에 입력하여 해당 객체만 포함된 크기가 통일된 크롭 이미지 세트를 얻을 수 있습니다. 이러한 이미지는 다른 노드로 쉽게 전송되어 다시 그리기, 스타일 변환 또는 합성 작업에 사용될 수 있습니다.

주의사항

입력된 이미지와 마스크의 배치 크기는 일치해야 합니다. 마스크가 완전히 비어 있는 경우(즉, 0이 아닌 픽셀이 없음), 노드는 빈 크롭 영역을 반환합니다. 평활화 매개변수는 연속 프레임(예: 비디오)을 처리할 때만 효과가 두드러지며, 단일 이미지나 순서가 없는 이미지의 경우 그 효과가 제한적입니다.

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

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

Batch Crop From Mask Advanced(BatchCropFromMaskAdvanced)