Load Videos From Folder (LoadVideosFromFolder) - ComfyUI-KJNodes

Load Videos From Folder 노드는 VideoHelperSuite 확장 기능에 의존하여 비디오 디코딩을 구현하며, 일반적인 비디오 형식을 지원합니다.

Load Videos From Folder 노드는 지정된 폴더에서 비디오 파일을 일괄적으로 불러오는 도구 노드입니다. 핵심 기능은 비디오를 읽어 프레임 시퀀스를 ComfyUI가 처리할 수 있는 이미지 텐서로 변환하여, 후속 이미지 또는 비디오 처리 워크플로에 입력 소스를 제공하는 것입니다.

노드 기능

이 노드는 VideoHelperSuite 확장 기능에 의존하여 비디오 디코딩을 구현하며, 일반적인 비디오 형식을 지원합니다. 내부 메커니즘은 비디오 파일을 프레임별로 디코딩하고 사용자가 설정한 파라미터(예: 프레임 건너뛰기, 크기 조정)에 따라 프레임 시퀀스를 전처리하여, 최종적으로 다중 프레임 이미지 배치 또는 그리드화된 이미지를 출력합니다.

노드 파라미터 설명 - Load Videos From Folder

Parameters

매개변수 이름	데이터 타입	필수	기본값	범위/옵션	설명
`output_type`	COMBO	예	batch	"batch", "grid"	output_type (입력 파라미터): 출력 이미지의 배열 방식을 선택합니다. "batch"는 프레임을 배치로 묶고, "grid"는 다중 프레임을 그리드 이미지로 배열합니다. 유효 옵션: "batch", "grid"
`video`	STRING	예	X://insert/path/	-	video (입력 파라미터): 불러올 비디오 파일이 포함된 폴더 경로를 지정합니다. 노드는 해당 경로 아래의 모든 비디오 파일을 읽습니다.
`force_rate`	FLOAT	예	0	0 - 60 (단계: 1)	force_rate (입력 파라미터): 출력 프레임 시퀀스의 프레임 속도(FPS)를 강제로 설정합니다. 0으로 설정하면 비디오의 원본 프레임 속도를 사용합니다. 유효 범위는 0-60, 단계는 1입니다.
`custom_width`	INT	예	0	0 - 4096	custom_width (입력 파라미터): 출력 이미지의 너비를 사용자 정의합니다. 0으로 설정하면 비디오 원본 너비를 유지합니다. 유효 범위는 0-4096입니다.
`custom_height`	INT	예	0	0 - 4096	custom_height (입력 파라미터): 출력 이미지의 높이를 사용자 정의합니다. 0으로 설정하면 비디오 원본 높이를 유지합니다. 유효 범위는 0-4096입니다.
`frame_load_cap`	INT	예	0	0 - 10000 (단계: 1)	frame_load_cap (입력 파라미터): 불러올 최대 프레임 수를 제한합니다. 0은 제한 없음을 의미합니다. 처리량을 제어하는 데 사용됩니다. 유효 범위는 0-10000, 단계는 1입니다.
`skip_first_frames`	INT	예	0	0 - 10000 (단계: 1)	skip_first_frames (입력 파라미터): 비디오 시작 부분에서 지정된 수의 프레임을 건너뛴 후 불러오기를 시작합니다. 유효 범위는 0-10000, 단계는 1입니다.
`select_every_nth`	INT	예	1	1 - 1000 (단계: 1)	select_every_nth (입력 파라미터): 간격 샘플링을 수행하여 매 N번째 프레임만 불러옵니다. 프레임 속도를 낮추거나 처리 속도를 높이는 데 사용됩니다. 유효 범위는 1-1000, 단계는 1입니다.
`grid_max_columns`	INT	예	4	1 - 16 (단계: 1)	grid_max_columns (입력 파라미터): 출력 유형이 "grid"일 때 그리드 레이아웃의 최대 열 수를 설정합니다. 유효 범위는 1-16, 단계는 1입니다.
`add_label`	BOOLEAN	예	False	-	add_label (입력 파라미터): 출력 이미지에 파일 이름 레이블을 추가할지 여부를 결정하는 논리값입니다. 다른 비디오 소스를 식별하는 데 사용됩니다.

Output

매개변수 이름	데이터 타입	설명
IMAGE	IMAGE	IMAGE (출력 파라미터): 불러와 처리된 비디오 프레임 시퀀스를 이미지 텐서 형식으로 출력합니다.

사용 시나리오

비디오 스타일 변환 또는 비디오 썸네일 미리보기를 제작하는 워크플로에서 이 노드는 매우 유용합니다. 사용자는 이를 이미지 업스케일링, 필터 적용 또는 프레임 보간 노드에 연결하여 불러온 비디오 프레임을 일괄 처리함으로써 전체 비디오 클립을 효율적으로 처리할 수 있습니다.

주의사항

이 노드를 사용하기 전에 반드시 ComfyUI-VideoHelperSuite 확장 기능이 설치되어 있어야 합니다. 또한 고해상도 또는 초장편 비디오를 처리할 때는 VRAM 사용량에 유의해야 하며, 프레임 수 상한 및 프레임 건너뛰기 파라미터를 설정하여 데이터 양을 제어할 수 있습니다.

Load Videos From Folder 노드 소스 코드 링크

Load Videos From Folder 노드는 ComfyUI-KJNodes 노드 패키지에서 제공됩니다.

Load Videos From Folder(LoadVideosFromFolder)