Load Video (Path) 🎥🅥🅗🅢(LoadVideoPath)
Этот узел предоставляет широкие возможности обработки видео, позволяя пользователю осуществлять детальный контроль над процессом загрузки.
Load Video Path
Узел 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 | КОМБО | Да | 0 | 0 - 60 (шаг: 1) | Принудительная установка частоты кадров (FPS) для выходной последовательности. Диапазон от 0 до 60, шаг 1. Значение 0 означает использование исходной частоты кадров видео. |
custom_width | ЦЕЛОЕ | Да | 0 | 0 - DIMMAX | Принудительная установка ширины выходного изображения. Диапазон от 0 до DIMMAX. Значение 0 означает сохранение исходной ширины видео. |
custom_height | ЦЕЛОЕ | Да | 0 | 0 - DIMMAX | Принудительная установка высоты выходного изображения. Диапазон от 0 до DIMMAX. Значение 0 означает сохранение исходной высоты видео. |
frame_load_cap | ЦЕЛОЕ | Да | 0 | 0 - BIGMAX (шаг: 1) | Ограничение максимального количества загружаемых кадров. Диапазон от 0 до BIGMAX, шаг 1. Значение 0 означает загрузку всех кадров. |
skip_first_frames | ЦЕЛОЕ | Да | 0 | 0 - BIGMAX (шаг: 1) | Пропуск указанного количества кадров в начале видео перед началом загрузки. Диапазон от 0 до BIGMAX, шаг 1. |
select_every_nth | ЦЕЛОЕ | Да | 1 | 1 - BIGMAX (шаг: 1) | Загрузка каждого N-го кадра для понижающей дискретизации. Диапазон от 1 до BIGMAX, шаг 1. |
Выходные данные (Output)
| Параметр | Тип данных | Описание |
|---|---|---|
| IMAGE | Неизвестно | Выходная последовательность кадров видео (изображения или латентные представления). |
| frame_count | ЦЕЛОЕ | Общее количество кадров видео, успешно загруженных. |
| audio | АУДИО | Данные аудиодорожки, извлечённые из видео. |
| VHS_VIDEOINFO | VHS_VIDEOINFO | Метаданные видео, включая исходные размеры и частоту кадров. |
Сценарии использования
Ключевой особенностью узла является поддержка подключения VAE (вариационного автоэнкодера). При предоставлении модели VAE узел напрямую кодирует кадры видео в латентное представление (LATENT) на выходе, пропуская этап явного декодирования изображения. Это может значительно повысить эффективность процесса обработки, особенно в рабочих процессах, требующих подачи видео в модели генерации на основе латентного пространства (например, Stable Diffusion).
Примечания
Кроме того, узел выводит метаинформацию о видео (например, исходный размер, частоту кадров), извлечённую аудиодорожку и общее количество фактически загруженных кадров. Эти выходные данные предоставляют последующим узлам необходимую контекстную информацию, что упрощает построение сложных конвейеров обработки видео.
Ссылка на исходный код узла Load Video (Path) 🎥🅥🅗🅢
Узел Load Video (Path) 🎥🅥🅗🅢 взят из пакета узлов ComfyUI-VideoHelperSuite.
Комментарии
Войдите через GitHub, чтобы участвовать в обсуждении.