Описание
Быстрый предпросмотр пакета позволяет просмотреть целый пакет изображений или масок как единую полосу миниатюр H.264 MP4, отображаемую как интерактивная сетка в интерфейсе ComfyUI. Каждый кадр кодируется как I-кадр (ключевой кадр), что обеспечивает произвольный доступ — нажмите на любую плитку для её увеличения, затем просматривайте вперед/назад по пакету без материализации сотен отдельных PNG-файлов. Это значительно ускоряет и снижает затраты ресурсов при итерациях больших генераций.
Нода относится к категории KJNodes/experimental и предназначена как визуальный диагностический инструмент; она не производит выходных данных.
Входы
| Вход | Тип | Обязательно | По умолчанию | Мин. | Макс. | Шаг | Описание |
|---|---|---|---|---|---|---|---|
input | IMAGE, MASK или пакет | ✅ | – | – | – | – | Пакет изображений или масок для предпросмотра. Может быть одним изображением, пакетом изображений или пакетом масок. |
max_thumb_size | INT | ✅ | 512 | 512 | 1024 | 8 | Максимальная длина стороны (в пикселях) для миниатюры детального просмотра (увеличенный вид при нажатии на плитку). Плитки сетки (миниатюры полосы) автоматически ограничены до 256 пикселей независимо. |
crf | INT | ✅ | 25 | 0 | 51 | 1 | Постоянный коэффициент скорости (CRF) для кодирования H.264. Меньшие значения обеспечивают более высокое визуальное качество за счет большего размера файла; большие значения экономят место, но снижают качество. Значения ниже 18 обычно считаются визуально без потерь. |
max_grid_frames | INT | ✅ | 1024 | 1 | 4096 | 1 | Если входной пакет превышает это количество кадров, нода равномерно дискретизирует пакет с шагом, чтобы на сетке отображалось только это количество кадров. Полный пакет все еще доступен при просмотре увеличенных изображений. |
Примечания по использованию
- Когда использовать Быстрый предпросмотр пакета: Используйте эту ноду вместо сохранения отдельных изображений предпросмотра, когда нужно быстро просмотреть большое количество сгенерированных кадров, например, во время рабочих процессов анимации, выборки латентных пакетов или проверки последовательности масок.
- Обработка файла: Сгенерированный MP4 временно хранится и удаляется при закрытии ComfyUI. Он не записывается в стандартную выходную папку.
- Память против производительности: Поскольку нода использует один видеофайл с ключевыми кадрами, она избегает накладных расходов на запись и чтение N отдельных PNG. Это может значительно уменьшить задержку при предпросмотре пакетов из сотен или тысяч кадров.
- Логика шаговой дискретизации: Когда длина пакета >
max_grid_frames, сетка показывает равномерное подмножество кадров (например, каждый N-й кадр). Увеличенный вид позволяет пройтись по всему пакету. - Нет выходов: Нода существует исключительно для предпросмотра в реальном времени; она не передает данные дальше. Разместите её в конце цепочки рабочего процесса.
- Экспериментальное состояние: Находясь в
KJNodes/experimental, эта нода может претерпеть изменения API в будущих версиях. Проверьте обновления при обновлении пользовательского пакета узлов.
Комментарии
Войдите через GitHub, чтобы участвовать в обсуждении.