EasyLoader (SV3D)(sv3dLoader)

描述

EasyLoader (SV3D) 是 ComfyUI-Easy-Use 插件中的一个加载器节点，归类于 EasyUse/Loaders 下。它通过加载 checkpoint 和 VAE、接受初始图像，并构建用于生成围绕主体的一系列视图的 Latent/批处理设置，来准备 SV3D 图像转 3D 工作流。

此节点还提供相机轨迹控制和一个可选的 scheduler 字符串，使其成为连接下游采样及视频/3D 生成节点的单一入口。

输入

ckpt_name

COMBO。选择要加载的 checkpoint 模型。可用选项来自 checkpoints 文件夹。

vae_name

COMBO。选择用于编码/解码 Latent 的 VAE。可用选项来自 VAE 文件夹。

init_image

IMAGE。用作 SV3D 生成起始视角的来源图像。此图像会被编码到 Latent 空间中，并用作已生成相机路径的视觉锚点。

empty_latent_width

INT。用于已生成帧的空 Latent 的宽度。请将此值设置为与 SV3D 序列所需输出分辨率匹配。

empty_latent_height

INT。用于已生成帧的空 Latent 的高度。请将此值设置为与 SV3D 序列所需输出分辨率匹配。

batch_size

INT，默认 21，最小值 1，最大值 4096。要生成的帧数/Latent 样本数。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 路径。

scheduler

STRING，可选，默认 ""。一个可选的 scheduler 字符串。为空时，加载器使用其内置/默认调度行为。提供时，可将其传递给需要 scheduler 值的下游节点。

输出

PIPE_LINE

一个 EasyUse pipeline 对象，将已加载模型、VAE 及相关生成设置打包在一起，方便连接到下游 EasyUse 节点。

MODEL

已加载的 SV3D 扩散模型，可直接供采样器或其他使用模型的节点使用。

STRING

与此加载器设置关联的 scheduler 字符串。可将其传递给需要 scheduler 值的节点，或用于调试/自定义调度工作流。

使用说明

• 此节点专用于 SV3D 图像转 3D 生成，其中初始图像用作一系列已生成视角的锚点。
• 默认 batch_size 为 21，与 SV3D 的标准帧数一致。如果更改该值，请确保下游模型和采样设置支持该帧数。
• empty_latent_width 和 empty_latent_height 通常应设置为与输入图像尺寸相同的值，或设置为 SV3D 模型所期望的原生分辨率。
• easing_mode 和 interp_easing 共同定义相机在批处理过程中如何围绕对象移动。若要实现简单的环绕效果，请将 easing_mode 保持为 azimuth，interp_easing 保持为 linear。
• 当您希望从外部控制相机/调度行为，而不是依赖节点的默认设置时，可选的 scheduler 输入尤其有用。