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

# Load3DAdvanced - ComfyUI Built-in Node Documentation

> Complete documentation for the Load3DAdvanced node in ComfyUI. Learn its inputs, outputs, parameters and usage.

此节点从您的 ComfyUI 输入目录加载 3D 模型文件，并提供模型数据以及相机和视口信息。它支持常见的 3D 文件格式，并允许您指定渲染输出的图像尺寸。

## 输入

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

**参数说明：**

* `model_file` 参数仅显示以下扩展名的文件：.gltf、.glb、.obj、.fbx、.stl
* 文件必须放置在 ComfyUI 安装目录的 `input/3d` 文件夹中
* 如果 `model_file` 设置为 "none"，则不会加载任何 3D 模型数据（输出 `model_3d` 将为空）

## 输出

| 输出名称            | 描述                        | 数据类型            |
| --------------- | ------------------------- | --------------- |
| `model_3d`      | 已加载的 3D 模型数据，如果未选择模型文件则为空 | FILE3DANY       |
| `model_3d_info` | 来自视口状态的已加载 3D 模型信息        | 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):** `fdacea8abf627621150e1196743e36f61534333837c33cc9a7416a6d11700c4d`