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

# MeshToFile3D - ComfyUI Built-in Node Documentation

> 此节点将网格序列化为一个 GLB 文件对象，该对象可传递给 Save 3D 或 Preview 3D 节点。

此节点将网格序列化为一个 GLB 文件对象，该对象可传递给 Save 3D 或 Preview 3D 节点。它会携带所有网格数据，包括 UV、颜色、法线、纹理、法线/环境光遮蔽/自发光贴图以及材质设置。对于包含多个项目的批次，仅使用第一个项目。

## 输入

| 参数   | 描述                                                                                | 数据类型 | 必需 | 范围          |
| ---- | --------------------------------------------------------------------------------- | ---- | -- | ----------- |
| `网格` | 要转换为 GLB 文件的网格，包括 UV、颜色、法线、纹理、法线/环境光遮蔽/自发光贴图以及材质。每个批次仅支持一个项目；如果批次包含多个项目，则使用第一个项目。 | MESH | 是  | Single mesh |

注意：该节点每个批次仅支持一个项目。如果输入网格在其批次中包含多个项目，则会记录一条警告，并使用第一个项目。网格必须至少包含一个顶点和一个面；空网格会引发错误。

## 输出

| 输出名称       | 描述                                            | 数据类型   |
| ---------- | --------------------------------------------- | ------ |
| `model_3d` | 一个包含序列化网格的 GLB（glTF 二进制）文件对象，可供其他 3D 节点保存或预览。 | FILE3D |

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

***

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