Load Images (Upload) 🎥🅥🅗🅢 (LoadImagesFromDirectoryUpload) - ComfyUI-VideoHelperSuite

첫 번째 단락 (간단한 설명, 2-3문장): Load Images (Upload) 노드는 Video Helper Suite 카테고리에 속하는 핵심 노드로, ComfyUI의 입력 디렉토리에서 이미지를 일괄적으로 로드하는 데 사용됩니다. 주요 기능은 사용자가 지정된 폴더에 업로드한 이미지 시퀀스를 워크플로로 읽어와, 후속 이미지 처리나 비디오 생성을 위한 소재를 제공하는 것입니다.

노드 기능

두 번째 단락 (노드 기능, 3-4문장): 이 노드는 ComfyUI 입력 디렉토리 아래의 모든 하위 폴더(clipspace 폴더 제외)를 스캔하여 나열하며, 사용자가 그 중 하나를 이미지 소스로 선택할 수 있게 합니다. 로드할 이미지 수의 상한 설정, 처음 몇 장의 이미지 건너뛰기, n번째 이미지마다 선택하기 등 로드 과정을 세밀하게 제어할 수 있습니다. 노드는 내부적으로 디렉토리 경로의 유효성을 검증하고 파일 변경 사항을 추적하여 캐시를 최적화합니다.

노드 파라미터 설명 - Load Images (Upload) 🎥🅥🅗🅢

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`directory`	COMBO	예	-	-	**: 로드할 이미지 시퀀스가 포함된 소스 폴더를 선택합니다. 이 목록은 ComfyUI 입력 디렉토리 아래의 하위 폴더 이름에서 동적으로 가져옵니다.
`meta_batch`	VHS_BatchManager	아니오	-	-	**: 복잡한 워크플로에서 여러 이미지 로드 작업의 배치와 메타데이터를 조정하는 데 사용되는 배치 관리자 객체를 받습니다. 타입은 VHS_BatchManager입니다.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`image_load_cap`	INT	아니오	0	0 - BIGMAX (간격: 1)	-
`skip_first_images`	INT	아니오	0	0 - BIGMAX (간격: 1)	-
`select_every_nth`	INT	아니오	1	1 - BIGMAX (간격: 1)	-

출력

파라미터 이름	데이터 타입	설명
IMAGE	IMAGE	**: 로드된 모든 이미지 데이터가 배치 텐서로 쌓여 출력됩니다.
MASK	MASK	**: 이미지에 대응하는 마스크 데이터가 배치 텐서로 쌓여 출력됩니다.
frame_count	INT	**: 실제로 성공적으로 로드된 이미지의 총 프레임 수를 출력합니다.

사용 시나리오

세 번째 단락 (사용 시나리오, 2-3문장): 이미지 기반 비디오 생성(Img2Vid) 워크플로를 제작할 때, 이 노드를 사용하여 키프레임 시퀀스가 포함된 폴더를 로드할 수 있습니다. 그린 스크린 크로마키와 같이 일괄 처리 및 마스크 추가가 필요한 작업의 경우, 원본 이미지 시퀀스와 그에 대응하는 마스크 시퀀스를 로드할 수 있습니다. 다양한 이미지 처리 효과를 테스트할 때도, 이 노드로 테스트 이미지 세트를 빠르게 로드하여 일괄 적용할 수 있습니다.

주의사항

네 번째 단락 (주의사항, 선택사항, 1-2문장): 로드할 이미지 파일은 반드시 ComfyUI의 인터페이스나 API를 통해 지정된 입력 디렉토리의 하위 폴더에 미리 업로드되어 있어야 합니다. 노드는 폴더만 처리하며 개별 파일을 직접 처리하지 않습니다.

Load Images (Upload) 🎥🅥🅗🅢 노드 소스 코드 링크

Load Images (Upload) 🎥🅥🅗🅢 노드는 ComfyUI-VideoHelperSuite 노드 패키지에서 가져왔습니다.

Load Images (Upload) 🎥🅥🅗🅢(LoadImagesFromDirectoryUpload)

Load Images From Directory Upload