EasyLoader (SV3D)(sv3dLoader)

Description

EasyLoader (SV3D) est un nœud de chargement du package ComfyUI-Easy-Use, regroupé sous EasyUse/Loaders. Il prépare un flux de travail SV3D image-vers-3D en chargeant un checkpoint et un VAE, en acceptant une image initiale, et en construisant la configuration latent/lot utilisée pour générer une séquence de vues autour du sujet.

Ce nœud expose également des contrôles de trajectoire de caméra et une chaîne de planification facultative, ce qui en fait un point d'entrée unique pour alimenter les nœuds en aval d'échantillonnage et de génération vidéo/3D.

Entrées

ckpt_name

COMBO. Sélectionne le modèle checkpoint à charger. Les options disponibles proviennent du dossier des checkpoints.

vae_name

COMBO. Sélectionne le VAE utilisé pour encoder/décoder les latents. Les options disponibles proviennent du dossier VAE.

init_image

IMAGE. L'image source utilisée comme vue de départ pour la génération SV3D. Cette image est encodée dans l'espace latent et utilisée comme ancrage visuel pour la trajectoire de caméra générée.

empty_latent_width

ENTIER. La largeur du latent vide utilisé pour les images générées. Définissez cette valeur pour correspondre à la résolution de sortie souhaitée pour la séquence SV3D.

empty_latent_height

ENTIER. La hauteur du latent vide utilisé pour les images générées. Définissez cette valeur pour correspondre à la résolution de sortie souhaitée pour la séquence SV3D.

batch_size

ENTIER, défaut 21, min 1, max 4096. Le nombre d'images/échantillons latents à générer. SV3D utilise couramment 21 images pour sa séquence de vues orbitales standard, c'est pourquoi la valeur par défaut est fixée à 21. Des valeurs plus élevées augmentent considérablement l'utilisation de la mémoire et le temps de génération.

interp_easing

COMBO, défaut linear. Options : linear, ease_in, ease_out, ease_in_out. Contrôle l'easing appliqué à l'interpolation le long de la trajectoire de caméra :

• linear : interpolation constante entre les images.
• ease_in : démarre lentement puis accélère.
• ease_out : démarre rapidement puis décélère.
• ease_in_out : accélère au début et décélère à la fin.

easing_mode

COMBO, défaut azimuth. Options : azimuth, elevation, custom. Sélectionne le type de mouvement de caméra utilisé pour la séquence SV3D :

• azimuth : orbite autour de l'objet horizontalement.
• elevation : déplace la caméra verticalement.
• custom : utilise une trajectoire de caméra ou de planification personnalisée.

scheduler

CHAÎNE, facultatif, défaut "". Une chaîne de planification facultative. Lorsqu'elle est vide, le chargeur utilise son comportement de planification intégré/par défaut. Lorsqu'elle est fournie, elle peut être transmise aux nœuds en aval qui consomment une valeur de planification.

Sorties

PIPE_LINE

Un objet pipeline EasyUse qui regroupe le modèle chargé, le VAE et les paramètres de génération associés pour une connexion pratique aux nœuds EasyUse en aval.

MODEL

Le modèle de diffusion SV3D chargé, prêt à être utilisé par un sampler ou d'autres nœuds consommant des modèles.

STRING

La chaîne de planification associée à cette configuration de chargeur. Elle peut être transmise aux nœuds qui attendent une valeur de planification, ou utilisée dans des flux de travail de débogage ou de planification personnalisée.

Notes d'utilisation

• Ce nœud est destiné à la génération SV3D image-vers-3D, où l'image initiale est utilisée comme ancrage pour une séquence de vues générées.
• Le batch_size par défaut de 21 correspond au nombre d'images standard de SV3D. Si vous le modifiez, assurez-vous que votre modèle en aval et votre configuration d'échantillonnage prennent en charge ce nombre d'images.
• empty_latent_width et empty_latent_height doivent généralement être définis à la même valeur que les dimensions de l'image d'entrée, ou à la résolution native attendue par le modèle SV3D.
• easing_mode et interp_easing définissent ensemble la façon dont la caméra se déplace autour de l'objet sur le lot. Pour une orbite simple, conservez easing_mode sur azimuth et interp_easing sur linear.
• L'entrée facultative scheduler est particulièrement utile lorsque vous souhaitez un contrôle externe sur le comportement de la caméra et de la planification plutôt que de vous fier aux valeurs par défaut du nœud.