> ## 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.

# Save3DAdvanced - ComfyUI Built-in Node Documentation

> 将 3D 模型保存到 ComfyUI 输出目录中的文件，并生成已保存场景的预览。

将 3D 模型保存到 ComfyUI 输出目录中的文件，并生成已保存场景的预览。它还会将 3D 模型、其在场景中的放置、相机信息以及视口尺寸传递给下游节点。当模型放置或相机信息未连接时，节点使用视口状态中存储的值。

## 输入

| 参数                | 描述                                                               | 数据类型            | 必需 | 范围                                                          |
| ----------------- | ---------------------------------------------------------------- | --------------- | -- | ----------------------------------------------------------- |
| `model_3d`        | 来自上游 3D 节点的 3D 模型文件。                                             | FILE3D          | 是  | GLB<br />GLTF<br />FBX<br />OBJ<br />STL<br />USDZ<br />Any |
| `filename_prefix` | 用于保存文件名的前缀（默认值："3d/ComfyUI"）。                                    | STRING          | 是  | 自由文本                                                        |
| `viewport_state`  | 包含相机和模型放置信息的视口状态，通常来自 Load 3D 节点。                                | LOAD3D          | 是  | -                                                           |
| `model_3d_info`   | 场景中每个模型的放置：位置、旋转和缩放（Y 轴向上的世界空间）。连接时覆盖 `viewport_state` 中存储的模型放置。 | LOAD3DMODELINFO | 否  | -                                                           |
| `camera_info`     | 视口相机信息：位置、注视目标、缩放和类型。连接时覆盖 `viewport_state` 中存储的相机信息。            | LOAD3DCAMERA    | 否  | -                                                           |
| `width`           | 视口的渲染宽度（像素）（默认值：1024）。                                           | INT             | 是  | 1 到 4096                                                    |
| `height`          | 视口的渲染高度（像素）（默认值：1024）。                                           | INT             | 是  | 1 到 4096                                                    |

注意：`model_3d_info` 和 `camera_info` 是可选的。当任一输入未连接时，节点回退到 `viewport_state` 中存储的对应值。

## 输出

| 输出名称            | 描述                               | 数据类型            |
| --------------- | -------------------------------- | --------------- |
| `model_3d`      | 从输入传递过来的 3D 模型文件。                | FILE3D          |
| `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/Save3DAdvanced/zh.md)

***

**Source fingerprint (SHA-256):** `27cb15c5cf382e6e5b8164cfd456993404222c61d59edff2d51f9f1c8e47b25f`