Preview3D - ComfyUI Built-in Node Documentation

Preview3D 节点主要用于预览 3D 模型输出。此节点接受两个输入：一个来自 Load3D 节点的 camera_info，另一个是 3D 模型文件的路径。模型文件路径必须位于 ComfyUI/output 文件夹中。

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

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

输入

参数名	描述	类型
camera_info	相机信息	LOAD3D_CAMERA
model_file	ComfyUI/output/ 下的模型文件路径	LOAD3D_CAMERA

画布区域说明

目前，ComfyUI 前端中与 3D 相关的节点共享同一个画布组件，因此它们的基本操作除了一些功能差异外，大部分是一致的。

以下内容和界面主要基于 Load3D 节点，具体功能请以实际节点界面为准。

画布区域包含各种视图操作，例如：

• 预览视图设置（网格、背景颜色、预览视图）
• 相机控制：FOV、相机类型
• 全局光照强度：调整光照
• 模型导出：支持 GLB、OBJ、STL 格式
• 等等。

1. 包含 Load 3D 节点的多个菜单和隐藏菜单
2. 3D 视图操作轴

1. 视图操作

视图控制操作：

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

2. 左侧菜单功能

在预览区域中，一些视图操作菜单隐藏在菜单中。点击菜单按钮可以展开不同的菜单。

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

场景

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

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

模型

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

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

相机

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

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

光照

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

导出

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

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑