EasyLoader (SV3D)(sv3dLoader)

Описание

EasyLoader (SV3D) это нода-загрузчик из пакета ComfyUI-Easy-Use, находящаяся в группе EasyUse/Loaders. Она подготавливает рабочий процесс SV3D для преобразования изображения в 3D, загружая чекпойнт и VAE, принимая исходное изображение и создавая настройку латентного пространства/пакета, используемую для генерации последовательности ракурсов вокруг объекта.

Нода также предоставляет управление траекторией камеры и необязательную строку планировщика, что делает её единой точкой входа для передачи данных в последующие узлы выборки и генерации видео/3D.

Входы

ckpt_name

COMBO. Выбирает чекпойнт-модель для загрузки. Доступные варианты находятся в папке чекпойнтов.

vae_name

COMBO. Выбирает VAE, используемый для кодирования/декодирования латентных представлений. Доступные варианты находятся в папке VAE.

init_image

IMAGE. Исходное изображение, используемое в качестве начального ракурса для генерации SV3D. Это изображение кодируется в латентное пространство и используется как визуальный ориентир для сгенерированного пути камеры.

empty_latent_width

INT. Ширина пустого латентного пространства, используемого для сгенерированных кадров. Установите это значение в соответствии с желаемым разрешением вывода для последовательности SV3D.

empty_latent_height

INT. Высота пустого латентного пространства, используемого для сгенерированных кадров. Установите это значение в соответствии с желаемым разрешением вывода для последовательности SV3D.

batch_size

INT, по умолчанию 21, мин 1, макс 4096. Количество кадров/латентных сэмплов для генерации. SV3D обычно использует 21 кадр для стандартной последовательности орбитальных ракурсов, поэтому значение по умолчанию установлено на 21. Большие значения значительно увеличивают использование памяти и время генерации.

interp_easing

COMBO, по умолчанию linear. Варианты: linear, ease_in, ease_out, ease_in_out. Управляет плавностью интерполяции вдоль пути камеры:

• linear: постоянная интерполяция между кадрами.
• ease_in: начинается медленно и ускоряется.
• ease_out: начинается быстро и замедляется.
• ease_in_out: ускоряется в начале и замедляется в конце.

easing_mode

COMBO, по умолчанию azimuth. Варианты: azimuth, elevation, custom. Выбирает тип движения камеры для последовательности SV3D:

• azimuth: вращается вокруг объекта по горизонтали.
• elevation: перемещает камеру по вертикали.
• custom: использует пользовательский путь камеры/планировщика.

scheduler

STRING, необязательный, по умолчанию "". Необязательная строка планировщика. Если пусто, загрузчик использует встроенное/стандартное поведение планировщика. Если задано, её можно передавать последующим узлам, которые принимают значение планировщика.

Выходы

PIPE_LINE

Объект конвейера EasyUse, который объединяет загруженную модель, VAE и связанные настройки генерации для удобного подключения к последующим узлам EasyUse.

MODEL

Загруженная диффузионная модель SV3D, готовая к использованию сэмплером или другими узлами, потребляющими модель.

STRING

Строка планировщика, связанная с данной конфигурацией загрузчика. Её можно передавать узлам, ожидающим значение планировщика, или использовать для отладки/пользовательских рабочих процессов планирования.

Примечания по использованию

• Этот узел предназначен для генерации SV3D из изображения в 3D, где исходное изображение используется как ориентир для последовательности сгенерированных ракурсов.
• Значение batch_size по умолчанию (21) соответствует стандартному количеству кадров SV3D. Если вы измените его, убедитесь, что ваша последующая модель и настройка выборки поддерживают такое количество кадров.
• empty_latent_width и empty_latent_height обычно должны быть установлены на те же значения, что и размеры входного изображения, или на родное разрешение, ожидаемое моделью SV3D.
• easing_mode и interp_easing вместе определяют, как камера движется вокруг объекта по кадрам пакета. Для простой орбиты оставьте easing_mode как azimuth, а interp_easing как linear.
• Необязательный вход scheduler особенно полезен, когда вы хотите управлять поведением камеры/планировщика извне, а не полагаться на настройки узла по умолчанию.