EasyLoader (SV3D)(sv3dLoader)

Descripción

EasyLoader (SV3D) es un nodo cargador del paquete ComfyUI-Easy-Use, agrupado en EasyUse/Loaders. Prepara un flujo de trabajo de imagen a 3D de SV3D cargando un checkpoint y un VAE, aceptando una imagen inicial y construyendo la configuración de latente/lote utilizada para generar una secuencia de vistas alrededor del sujeto.

El nodo también expone controles de trayectoria de cámara y una cadena de scheduler opcional, lo que lo convierte en un punto de entrada único para alimentar los nodos posteriores de muestreo y generación de vídeo/3D.

Entradas

ckpt_name

COMBO. Selecciona el modelo checkpoint que se va a cargar. Las opciones disponibles provienen de la carpeta de checkpoints.

vae_name

COMBO. Selecciona el VAE utilizado para codificar/decodificar latentes. Las opciones disponibles provienen de la carpeta de VAE.

init_image

IMAGE. La imagen fuente utilizada como vista inicial para la generación de SV3D. Esta imagen se codifica en el espacio latente y se utiliza como ancla visual para la trayectoria de cámara generada.

empty_latent_width

INT. El ancho del latente vacío utilizado para los fotogramas generados. Configúralo para que coincida con la resolución de salida deseada para la secuencia SV3D.

empty_latent_height

INT. El alto del latente vacío utilizado para los fotogramas generados. Configúralo para que coincida con la resolución de salida deseada para la secuencia SV3D.

batch_size

INT, valor por defecto 21, mínimo 1, máximo 4096. El número de fotogramas/muestras de latente a generar. SV3D utiliza comúnmente 21 fotogramas para su secuencia estándar de vistas orbitales, por lo que el valor por defecto es 21. Valores mayores aumentan significativamente el uso de memoria y el tiempo de generación.

interp_easing

COMBO, valor por defecto linear. Opciones: linear, ease_in, ease_out, ease_in_out. Controla el easing aplicado a la interpolación a lo largo de la trayectoria de cámara:

• linear: interpolación constante entre fotogramas.
• ease_in: comienza lento y acelera.
• ease_out: comienza rápido y desacelera.
• ease_in_out: acelera al principio y desacelera al final.

easing_mode

COMBO, valor por defecto azimuth. Opciones: azimuth, elevation, custom. Selecciona el tipo de movimiento de cámara utilizado para la secuencia SV3D:

• azimuth: orbita alrededor del objeto horizontalmente.
• elevation: mueve la cámara verticalmente.
• custom: utiliza una trayectoria de cámara/scheduler personalizada.

scheduler

STRING, opcional, valor por defecto "". Una cadena de scheduler opcional. Cuando está vacía, el cargador utiliza su comportamiento de programación integrado o predeterminado. Cuando se proporciona, se puede pasar a los nodos posteriores que consumen un valor de scheduler.

Salidas

PIPE_LINE

Un objeto de pipeline de EasyUse que agrupa el modelo cargado, el VAE y las configuraciones de generación relacionadas para una conexión conveniente con los nodos EasyUse posteriores.

MODEL

El modelo de difusión SV3D cargado, listo para ser utilizado por un muestreador u otros nodos que consumen modelos.

STRING

La cadena de scheduler asociada con esta configuración de cargador. Se puede pasar a los nodos que esperan un valor de scheduler o utilizarse para flujos de trabajo de depuración y programación personalizada.

Notas de uso

• Este nodo está diseñado para la generación de imagen a 3D de SV3D, donde la imagen inicial se utiliza como ancla para una secuencia de vistas generadas.
• El batch_size predeterminado de 21 coincide con el número de fotogramas estándar de SV3D. Si lo cambias, asegúrate de que tu modelo posterior y la configuración de muestreo soporten ese número de fotogramas.
• empty_latent_width y empty_latent_height normalmente deben configurarse con el mismo valor que las dimensiones de la imagen de entrada, o con la resolución nativa esperada por el modelo SV3D.
• easing_mode e interp_easing juntos definen cómo se mueve la cámara alrededor del objeto a lo largo del lote. Para una órbita simple, mantén easing_mode en azimuth e interp_easing en linear.
• La entrada opcional scheduler es especialmente útil cuando deseas tener control externo sobre el comportamiento de cámara/programación en lugar de depender de los valores predeterminados del nodo.