Load Video (Path) 🎥🅥🅗🅢 (LoadVideoPath) - ComfyUI-VideoHelperSuite

Load Video (Path) 🎥🅥🅗🅢 노드는 풍부한 비디오 처리 옵션을 제공하여 사용자가 로딩 과정을 세밀하게 제어할 수 있도록 합니다.

Load Video (Path) 노드는 Video Helper Suite 툴킷의 핵심 구성 요소로, 로컬 파일 시스템이나 네트워크 URL에서 비디오 파일을 로드하는 데 사용됩니다. 주요 기능은 비디오 파일을 일련의 연속적인 이미지 프레임(IMAGE)으로 디코딩하여 ComfyUI 워크플로우에서 후속 이미지 처리, 분석 또는 생성 작업을 수행할 수 있도록 하는 것입니다.

노드 기능

이 노드는 풍부한 비디오 처리 옵션을 제공하여 사용자가 로딩 과정을 세밀하게 제어할 수 있습니다. 예를 들어, 사용자는 로드할 프레임 수를 제한하거나, 시작 부분의 일부 프레임을 건너뛰거나, 간격을 두고 프레임을 추출하거나, 출력 프레임의 크기와 프레임 속도를 강제로 지정할 수도 있습니다. 이는 대용량 비디오 파일 처리나 특정 전처리 단계가 필요한 시나리오에 매우 유용합니다.

노드 매개변수 설명 - Load Video (Path) 🎥🅥🅗🅢

연결 입력 (Inputs)

매개변수 이름	데이터 타입	필수	기본값	범위/옵션	설명
`meta_batch`	VHS_BATCHMANAGER	아니요	-	-	: 배치 처리 모드에서 여러 비디오 로딩을 조정하는 배치 관리자에 연결합니다.
`vae`	VAE	아니요	-	-	: VAE 모델을 연결합니다. 제공된 경우 비디오 프레임의 잠재 공간 표현(LATENT)을 직접 출력하고, 그렇지 않으면 이미지(IMAGE)를 출력합니다.

컨트롤 매개변수 (Parameters)

매개변수 이름	데이터 타입	필수	기본값	범위/옵션	설명
`video`	STRING	예	-	-	: 로드할 비디오 파일 경로 또는 네트워크 URL을 지정합니다. 일반적인 비디오 형식(예: .mp4, .mov, .avi 등)을 지원합니다.
`force_rate`	COMBO	예	0	0 - 60 (단계: 1)	: 출력 프레임 시퀀스의 프레임 속도(FPS)를 강제로 설정합니다. 범위는 0에서 60까지이며 단계는 1입니다. 0으로 설정하면 비디오 원본 프레임 속도를 사용합니다.
`custom_width`	INT	예	0	0 - DIMMAX	: 출력 이미지의 너비를 강제로 설정합니다. 범위는 0에서 DIMMAX까지이며, 0으로 설정하면 비디오 원본 너비를 유지합니다.
`custom_height`	INT	예	0	0 - DIMMAX	: 출력 이미지의 높이를 강제로 설정합니다. 범위는 0에서 DIMMAX까지이며, 0으로 설정하면 비디오 원본 높이를 유지합니다.
`frame_load_cap`	INT	예	0	0 - BIGMAX (단계: 1)	: 최대 로드할 프레임 수를 제한합니다. 범위는 0에서 BIGMAX까지이며 단계는 1입니다. 0으로 설정하면 모든 프레임을 로드합니다.
`skip_first_frames`	INT	예	0	0 - BIGMAX (단계: 1)	: 비디오 시작 부분에서 지정된 수의 프레임을 건너뛴 후 로딩을 시작합니다. 범위는 0에서 BIGMAX까지이며 단계는 1입니다.
`select_every_nth`	INT	예	1	1 - BIGMAX (단계: 1)	: 다운샘플링을 위해 N번째 프레임마다 한 프레임을 로드합니다. 범위는 1에서 BIGMAX까지이며 단계는 1입니다.

출력 (Output)

매개변수 이름	데이터 타입	설명
IMAGE	UNKNOWN	: 출력되는 비디오 프레임 시퀀스(이미지 또는 잠재 공간 표현)입니다.
frame_count	INT	: 실제 성공적으로 로드된 비디오 프레임의 총 수입니다.
audio	AUDIO	: 비디오에서 분리된 오디오 트랙 데이터입니다.
VHS_VIDEOINFO	VHS_VIDEOINFO	: 원본 크기와 프레임 속도를 포함한 비디오 메타데이터입니다.

사용 시나리오

이 노드의 핵심 특징은 VAE(변분 자동인코더) 연결을 지원한다는 점입니다. VAE 모델이 제공되면, 노드는 비디오 프레임을 잠재 공간 표현(LATENT)으로 직접 인코딩하여 출력하므로, 명시적인 이미지 디코딩 단계를 건너뛰어 처리 워크플로우의 효율성을 크게 높일 수 있습니다. 이는 특히 비디오 입력을 Stable Diffusion과 같은 잠재 공간 기반 생성 모델에 사용하는 워크플로우에 적합합니다.

주의사항

또한, 이 노드는 비디오의 메타 정보(예: 원본 크기, 프레임 속도), 분리된 오디오 트랙, 그리고 실제 로드된 총 프레임 수를 출력합니다. 이러한 출력은 후속 노드에 필요한 컨텍스트 정보를 제공하여 복잡한 비디오 처리 파이프라인을 구축하는 데 도움이 됩니다.

Load Video (Path) 🎥🅥🅗🅢 노드 소스 코드 링크

Load Video (Path) 🎥🅥🅗🅢 노드는 ComfyUI-VideoHelperSuite 노드 패키지에서 제공됩니다.

Load Video (Path) 🎥🅥🅗🅢(LoadVideoPath)

Load Video Path