> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Load3DAdvanced - ComfyUI Built-in Node Documentation

> Load 3D (Advanced) 节点从 ComfyUI 的 input/3d 目录加载 3D 模型文件，并提供模型数据以及从 3D 查看器视口状态中捕获的模型摆放和相机信息。

Load 3D (Advanced) 节点从 ComfyUI 的 `input/3d` 目录加载 3D 模型文件，并提供模型数据以及从 3D 查看器视口状态中捕获的模型摆放和相机信息。它支持常见的 3D 文件格式，并允许以像素为单位设置视口的渲染宽度和高度。此节点为实验性节点。

## 输入

| 参数               | 描述                                              | 数据类型   | 必需 | 范围                                          |
| ---------------- | ----------------------------------------------- | ------ | -- | ------------------------------------------- |
| `model_file`     | 要加载的 3D 模型文件。选择 "none" 可跳过加载模型文件。也可以直接通过控件上传文件。 | COMBO  | 是  | `"none"`<br />`input/3d` 目录中可用的 3D 模型文件     |
| `viewport_state` | 当前视口状态，包含来自 3D 查看器的相机和模型信息。                     | LOAD3D | 是  | -                                           |
| `width`          | 视口的渲染宽度，以像素为单位（默认：1024）。                        | INT    | 是  | 最小值：1<br />最大值：4096<br />默认值：1024<br />步长：1 |
| `height`         | 视口的渲染高度，以像素为单位（默认：1024）。                        | INT    | 是  | 最小值：1<br />最大值：4096<br />默认值：1024<br />步长：1 |

**参数说明：**

* `model_file` 参数仅列出以下扩展名的文件：.gltf、.glb、.obj、.fbx、.stl
* 文件必须放置在 ComfyUI 安装目录的 `input/3d` 目录中；也会搜索子文件夹，并且文件路径会相对于输入目录显示
* 如果 `model_file` 为 "none"，则不会加载任何模型数据，`model_3d` 输出将为空
* 如果 `model_file` 设置为不存在的文件，节点将返回验证错误："Invalid 3D model file: \{model\_file}"
* 如果 `viewport_state` 不是有效的视口状态对象，则将其视为空，因此 `model_3d_info` 会变为空列表，`camera_info` 会返回为空

## 输出

| 输出名称            | 描述                                        | 数据类型            |
| --------------- | ----------------------------------------- | --------------- |
| `model_3d`      | 已加载的 3D 模型文件（glb/obj/stl 等）。如果未选择模型文件则为空。 | FILE3DANY       |
| `model_3d_info` | 场景中每个模型的摆放信息：位置、旋转和缩放（Y 轴向上的世界空间）。        | LOAD3DMODELINFO |
| `camera_info`   | 视口相机信息：位置、看向目标、缩放和类型。                     | LOAD3DCAMERA    |
| `width`         | 视口的渲染宽度，以像素为单位。                           | INT             |
| `height`        | 视口的渲染高度，以像素为单位。                           | INT             |

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

***

**Source fingerprint (SHA-256):** `c79c53dde0c8b3afb7df7b972df749f5040c92d48b47e355c4497d9b0cbf1c22`