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

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

**3D 节点偏好设置**
可以在 ComfyUI 的设置菜单中配置 3D 节点的一些相关偏好设置。请参考以下文档进行相应设置：
[设置菜单](https://docs.comfy.org/interface/settings/3d)

## 输入

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

## 画布区域说明

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

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

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

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

![Load 3D 节点界面](./asset/preview3d_canvas.jpg)

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

### 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. 左侧菜单功能

![菜单](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu.webp)

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

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

#### 场景

![场景菜单](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_scene.webp)

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

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

#### 模型

![菜单_场景](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_model.webp)

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

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

#### 相机

![菜单_模型_菜单_相机](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_camera.webp)

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

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

#### 光照

![菜单_模型_菜单_相机](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_light.webp)

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

#### 导出

![菜单_导出](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_export.webp)

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

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Preview3D/zh.md)