Skip to main content
Load 3D Model

Load 3D Model · 截图待补

这个节点是做什么的

加载 3D 模型(Load 3D Model)属于 Input 分类(ComfyTV/Input)。它无 ▶ 运行:你在节点体里挑一个模型(来自 ComfyUI input/3d 文件夹下的文件),其快照即刻成为输出。支持的文件类型包括 GLB、GLTF、FBX、OBJ、PLY、SPZ、SPLAT、KSPLAT。 除简单加载外,节点的 3D 预览还可让你环绕模型,并在接入材质后通过点击(raycast)你想要的部件,把材质绑定到单个网格部件上。它发出 COMFYTV_MODEL 以及从预览视口截取的 COMFYTV_IMAGE 快照。 媒体以 ComfyTV 项目快照的形式流动,而非原生 ComfyUI 张量。若要与原生 ComfyUI 3D 节点互通,请插入 Bridge —— 见 bridges.md

适用场景

  • 把现成的 GLB/GLTF/FBX/OBJ(等)文件引入管线,而无需生成。
  • 通过把 Material Stage 输出绑定到特定部件,为模型重新贴图。
  • 借助截取的预览图,为模型生成一张摆好角度的缩略图。

参数

model(节点体)

隐藏下拉框,由卡片的缩略图选择器驱动;其选项携带服务端在 ComfyUI input/3d 文件夹下找到的文件列表。所选文件(相对 input/3d 的路径)成为 model 输出。

materials(autogrow)

可选的 COMFYTV_MATERIAL 输入(最多可增长到 4 个槽)。把 Material Stage 输出接到这里,即可用于部件绑定。

material_bindings(内部)

隐藏的 JSON 映射:网格部件键 → 材质输入槽,当你在节点体里点选某部件并指派一个已接材质时由部件绑定 UI 写入。运行时若存在绑定,会与材质值一并传下去,让下游看到重新贴图后的模型。

captured_image(内部)

隐藏。预览视口快照的 /view? URL,由节点体内的 3D 预览写入,成为 image 输出。

project_id / parent_output_id(内部)

隐藏,由 Project 节点与连线维护,一般无需理会。

输出

小贴士

  • 文件必须位于 ComfyUI 的 input/3d 文件夹下才会出现在选择器里。若要从项目库加载,请用 Load 3D Model from Asset
  • 部件绑定需先把材质接进 materials 槽;再在预览里点击某网格部件来指派。
  • 依赖 image 输出前,先环绕预览摆好一个合适的角度。

相关节点

  • Load 3D Model from Asset —— 从项目资产库挑模型,而非 input/3d
  • Material Stage —— 制作 PBR 材质,绑定到这里的部件上。
  • 3D Model Stage —— 生成模型而非加载。