Image Batch Filter (ImageBatchFilter) - ComfyUI-KJNodes

Image Batch Filter 노드는 이미지 배치를 입력으로 받아 사용자가 "빈" 이미지를 나타내는 색상 값(예: 순수한 검정색)과 허용치 임계값을 정의할 수 있도록 합니다.

Image Batch Filter는 이미지 배치 처리를 위한 필터 노드로, 배치 내 "빈" 이미지를 자동으로 식별하고 제거하는 것이 핵심 기능입니다. 지정된 색상과 이미지를 비교하여 빈 이미지인지 판단함으로써, 사용자가 유효하지 않은 이미지 데이터를 정리하고 후속 처리 흐름의 효율성을 높이는 데 도움을 줍니다.

노드 기능

이 노드는 이미지 배치를 입력으로 받아 사용자가 "빈" 이미지를 나타내는 색상 값(예: 순수한 검정색)과 허용치 임계값을 정의할 수 있도록 합니다. 내부적으로는 배치 내 각 이미지와 지정 색상의 평균 차이를 계산하며, 이 차이가 임계값 미만이면 해당 이미지를 빈 이미지로 판단합니다. 사용자는 이러한 빈 이미지를 직접 제거하거나, 배치 크기를 유지하기 위해 다른 대체 이미지로 채울 수 있습니다.

노드 파라미터 설명 - Image Batch Filter

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`images`	IMAGE	예	-	-	images (출력 파라미터): 필터링되거나 대체된 이미지 배치입니다.
`replacement_image`	IMAGE	아니오	-	-	replacement_image (입력 파라미터): 빈 이미지로 판단된 이미지를 대체하는 데 사용할 선택적 파라미터입니다. 제공되지 않으면 빈 이미지가 직접 제거됩니다.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`empty_color`	STRING	예	0, 0, 0	-	empty_color (입력 파라미터): "빈" 이미지로 간주될 색상을 정의합니다. "R, G, B" 형식의 문자열로, 예를 들어 "0, 0, 0"은 순수한 검정색을 나타냅니다.
`empty_threshold`	FLOAT	예	0.01	0.0 - 1.0 (스텝: 0.01)	empty_threshold (입력 파라미터): 이미지가 빈 이미지인지 판단하는 허용치 임계값입니다. 범위는 0.0에서 1.0이며, 스텝은 0.01입니다. 값이 작을수록 판단 기준이 엄격해집니다.

출력

파라미터 이름	데이터 타입	설명
images	IMAGE	images (출력 파라미터): 필터링되거나 대체된 이미지 배치입니다.
removed_indices	STRING	removed_indices (출력 파라미터): 제거되거나 대체된 이미지의 원래 배치 내 인덱스 위치를 문자열 형태로 출력합니다.

사용 시나리오

이미지 생성 워크플로에서 상위 노드(예: 배치 생성 또는 이미지 로딩)가 많은 양의 단색 또는 유효하지 않은 플레이스홀더 이미지를 생성할 가능성이 있는 경우, 이 노드를 사용하여 자동 필터링을 수행할 수 있습니다. 예를 들어, 여러 LoRA 모델을 결합하여 배치 스타일 테스트를 진행할 때, 이 노드를 사용하여 생성에 실패한 단색 이미지를 필터링하고 유효한 이미지만 후속 업스케일링 또는 조합 노드로 전달하여 부드러운 워크플로를 보장할 수 있습니다.

주의사항

이 노드는 (제공된 경우) 대체 이미지의 채널 수가 입력 이미지와 일치해야 합니다. 그렇지 않으면 자동 크기 조정이 수행되어 이미지 품질에 영향을 미칠 수 있습니다. 또한, 빈 이미지 판단은 픽셀 평균값을 기반으로 하므로, 미세한 노이즈나 텍스처가 포함된 '거의 빈' 이미지에 대해서는 정확하지 않을 수 있으며, 실제 상황에 따라 임계값을 조정해야 합니다.

Image Batch Filter 노드 소스 코드 링크

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

Image Batch Filter(ImageBatchFilter)