FilterZeroMasksAndCorrespondingImages

FilterZeroMasksAndCorrespondingImages 노드는 필수 입력으로 마스크(MASK) 목록을 받으며, 선택적으로 이미지(IMAGE) 목록을 받을 수 있습니다.

FilterZeroMasksAndCorrespondingImages 노드는 데이터 정리 및 필터링을 위한 도구입니다. 핵심 기능은 내용이 비어 있는 마스크를 자동으로 식별하고 분리하는 동시에, 제공된 경우 연관된 이미지 데이터를 처리하는 것입니다. 이 노드를 통해 사용자는 워크플로의 데이터를 효율적으로 정리하고 유효하지 않은 마스크 항목을 제거할 수 있습니다.

노드 기능

이 노드는 필수 입력으로 마스크(MASK) 목록을 받으며, 선택적으로 이미지(IMAGE) 목록을 받을 수 있습니다. 내부 메커니즘은 입력된 모든 마스크를 순회하며, 0이 아닌 픽셀 수를 계산하여 마스크가 비어 있는지 판단합니다. 이미지 목록이 제공된 경우, 노드는 그 길이가 마스크 목록과 일치하는지 확인한 후, 마스크의 필터링 결과에 따라 이미지를 동기적으로 그룹화하여 처리합니다.

노드 파라미터 설명 - FilterZeroMasksAndCorrespondingImages

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`masks`	MASK	예	-	-	masks (입력 파라미터): 필터링이 필요한 마스크 목록을 입력합니다. 노드는 각 마스크가 0이 아닌 픽셀을 포함하는지 확인합니다.
`original_images`	IMAGE	아니오	-	-	original_images (입력 파라미터): 선택적으로 입력할 수 있는 이미지 목록입니다. `masks` 파라미터의 마스크 수와 정확히 동일한 수여야 합니다.

출력 (Outputs)

파라미터 이름	데이터 타입	설명
non_zero_masks_out	MASK	non_zero_masks_out (출력 파라미터): 모든 비어 있지 않은 유효한 마스크를 출력합니다.
non_zero_mask_images_out	IMAGE	non_zero_mask_images_out (출력 파라미터): 비어 있지 않은 마스크에 해당하는 원본 이미지를 출력합니다.
zero_mask_images_out	IMAGE	zero_mask_images_out (출력 파라미터): 비어 있는 마스크에 해당하는 원본 이미지를 출력합니다.
zero_mask_images_out_indexes	INDEXES	zero_mask_images_out_indexes (출력 파라미터): 원본 입력 목록에서 비어 있는 마스크의 인덱스 위치를 출력합니다.

사용 시나리오

이 노드는 이미지를 배치 생성하고 후속 처리가 필요한 워크플로에서 매우 유용합니다. 예를 들어, 사용자는 먼저 여러 프롬프트를 사용하여 배치 이미지와 해당 마스크를 생성한 후, 결과를 이 노드에 연결할 수 있습니다. 노드는 유효한 내용을 생성하지 못한 마스크를 자동으로 걸러내고, 내용이 있는 마스크와 해당 이미지를 출력하여 다음 단계의 세부 작업에 사용할 수 있도록 합니다. 동시에 비어 있는 마스크에 해당하는 이미지는 별도로 출력하여 검사할 수 있도록 합니다.

주의사항

이미지 입력이 제공된 경우, 그 수는 마스크 수와 정확히 일치해야 합니다. 그렇지 않으면 노드는 이미지 입력을 무시하고 경고를 발생시킵니다. 이 노드는 마스크나 이미지 자체의 내용을 수정하지 않으며, 마스크가 모두 0인지 여부에 따라 재그룹화하고 인덱싱만 합니다.