ComfyPilotComfyPilot
文档 / 节点说明 / 加载3D

加载3D

Load3D 节点是用于加载和处理 3D 模型文件的核心节点。加载节点时,它会自动从 ComfyUI/input/3d/ 目录中检索可用的 3D 资源。

节点说明 Load3D 更新于 2026-11-12

查看官方原文

加载3D - ComfyUI Built-in Node Documentation

Load3D 节点是用于加载和处理 3D 模型文件的核心节点。加载节点时,它会自动从 ComfyUI/input/3d/ 目录中检索可用的 3D 资源。

Load3D 节点是用于加载和处理 3D 模型文件的核心节点。加载节点时,它会自动从 ComfyUI/input/3d/ 目录中检索可用的 3D 资源。您也可以使用上传功能上传支持的 3D 文件进行预览。

支持的格式 目前,此节点支持多种 3D 文件格式,包括 .gltf、.glb、.obj、.fbx 和 .stl。

3D 节点偏好设置 可以在 ComfyUI 的设置菜单中配置 3D 节点的一些相关偏好设置。请参考以下文档进行相应设置:

设置菜单

除了常规的节点输出外,Load3D 在画布菜单中还有许多与 3D 视图相关的设置。

输入

参数名描述类型默认值范围
模型文件3D 模型文件路径,支持上传,默认从 ComfyUI/input/3d/ 读取模型文件文件选择-支持的格式
宽度画布渲染宽度INT10241-4096
高度画布渲染高度INT10241-4096

输出

参数名描述数据类型
图像画布渲染图像IMAGE
mask包含当前模型位置的遮罩MASK
网格路径模型文件路径STRING
法线法线贴图IMAGE
相机信息线稿图像输出,对应的 edge_threshold 可在画布模型菜单中调整IMAGE
录制视频相机信息LOAD3D\_CAMERA
model_3d录制的视频(仅在存在录制时)VIDEO

所有输出预览:

查看操作演示

画布区域说明

Load3D 节点的画布区域包含大量视图操作,包括:

  • 预览视图设置(网格、背景颜色、预览视图)
  • 相机控制:控制视野角度(FOV)、相机类型
  • 全局光照强度:调整光照强度
  • 视频录制:录制并导出视频
  • 模型导出:支持 GLB、OBJ、STL 格式
  • 以及更多

Load 3D 节点界面

  1. 包含 Load 3D 节点的多个菜单和隐藏菜单
  2. 调整预览窗口大小 和 画布视频录制 的菜单
  3. 3D 视图操作轴
  4. 预览缩略图
  5. 预览大小设置,通过设置尺寸然后调整窗口大小来缩放预览视图显示

1. 视图操作

<video controls width="640" height="360"> <source src="https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3D/asset/view_operations.mp4" type="video/mp4" />

您的浏览器不支持视频播放。 </video>

视图控制操作:

  • 左键点击 + 拖动:旋转视图
  • 右键点击 + 拖动:平移视图
  • 中键滚轮滚动 或 中键点击 + 拖动:放大/缩小
  • 坐标轴:切换视图

2. 左侧菜单功能

菜单

在画布中,一些设置隐藏在菜单中。点击菜单按钮可以展开不同的菜单

  • 1. 场景:包含预览窗口网格、背景颜色、预览设置
  • 2. 模型:模型渲染模式、纹理材质、向上方向设置
  • 3. 相机:在正交视图和透视视图之间切换,并设置透视角度大小
  • 4. 光照:场景全局光照强度
  • 5. 导出:将模型导出为其他格式(GLB、OBJ、STL)

场景

场景菜单

场景菜单提供了一些基本的场景设置功能

  1. 显示/隐藏网格
  2. 设置背景颜色
  3. 点击上传背景图片
  4. 隐藏预览

模型

菜单\_场景

模型菜单提供了一些与模型相关的功能

  1. 向上方向:确定模型的哪个轴是向上方向
  2. 材质模式:切换模型渲染模式 - 原始、法线、线框、线稿

相机

菜单\_模型\_相机

此菜单提供正交视图和透视视图之间的切换,以及透视角度大小设置

  1. 相机:快速在正交视图和透视视图之间切换
  2. FOV:调整视野角度

光照

菜单\_模型\_相机

通过此菜单,您可以快速调整场景的全局光照强度

导出

菜单\_导出

此菜单提供快速转换和导出模型格式的功能

3. 右侧菜单功能

<video controls width="640" height="360"> <source src="https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3D/asset/view_operations.mp4" type="video/mp4" />

您的浏览器不支持视频播放。 </video>

右侧菜单有两个主要功能:

  1. 重置视图比例:点击按钮后,视图将根据设置的宽度和高度调整画布渲染区域的比例
  2. 视频录制:允许您将当前的 3D 视图操作录制为视频,允许导入,并可以作为 recording_video 输出到后续节点
本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑