Load3DAnimation - ComfyUI Built-in Node Documentation

# Load3DAnimation 节点文档

## 概述

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

> - 此节点的大部分功能与 Load 3D 节点相同，但此节点支持加载带有动画的模型，并且您可以在节点中预览相应的动画。
> - 本文档内容与 Load3D 节点相同，因为除了动画预览和播放之外，它们的功能完全相同。

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

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

[设置菜单](https://docs.comfy.org/interface/settings/3d)

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

## 输入

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

## 输出

| 参数名 | 描述 | 数据类型 |
| --- | --- | --- |
| `image` | 画布渲染图像 | IMAGE |
| `mask` | 包含当前模型位置的遮罩 | MASK |
| `mesh_path` | 模型文件路径 | STRING |
| `normal` | 法线贴图 | IMAGE |
| `lineart` | 线稿图像输出，对应的 `edge_threshold` 可在画布模型菜单中调整 | IMAGE |
| `camera_info` | 相机信息 | LOAD3D_CAMERA |
| `recording_video` | 录制的视频（仅在存在录制时） | VIDEO |

所有输出预览：
![查看操作演示](/images/built-in-nodes/Load3DAnimation/load3d_outputs.webp)

## 画布区域说明

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

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

![Load 3D 节点界面](/images/built-in-nodes/Load3DAnimation/load3d_ui.jpg)

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

![菜单](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)

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

### 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/recording.mp4" type="video/mp4" />
  您的浏览器不支持视频播放。
</video>

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

1. **重置视图比例**：点击按钮后，视图将根据设置的宽度和高度调整画布渲染区域比例
2. **视频录制**：允许您将当前的 3D 视图操作录制为视频，允许导入，并可以作为 `recording_video` 输出到后续节点