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

# Get3DComponents - ComfyUI Built-in Node Documentation

> Get3DComponents 会将 3D 模型文件（GLB、GLTF、OBJ 或 STL）解析为可编辑网格，可供 decimate、remesh、UV unwrap 和 bake 等网格处理节点使用。

Get3DComponents 会将 3D 模型文件（GLB、GLTF、OBJ 或 STL）解析为可编辑网格，可供 decimate、remesh、UV unwrap 和 bake 等网格处理节点使用。所有场景节点和图元都会合并为一个网格，并应用各自的变换；纹理和材质设置来自第一个材质。它是 MeshToFile3D 节点的对应节点。

## 输入

| 参数         | 描述                                                     | 数据类型                                                                   | 必需 | 范围                              |
| ---------- | ------------------------------------------------------ | ---------------------------------------------------------------------- | -- | ------------------------------- |
| `model_3d` | 来自 Load 3D 或其他 3D 节点的 3D 模型文件。不支持 FBX/USDZ——请先转换为 GLB。 | File3DGLB<br />File3DGLTF<br />File3DOBJ<br />File3DSTL<br />File3DAny | 是  | GLB<br />GLTF<br />OBJ<br />STL |

注意：不支持 FBX 和 USDZ 文件，使用它们会导致错误；请先将其转换为 GLB 或 GLTF。如果无法将文件格式识别为 GLB、GLTF、OBJ 或 STL，节点会抛出错误并列出支持的格式。如果 glTF 场景不包含三角形几何体，或者文件包含指向顶点列表之外的面索引（文件损坏的迹象），节点会抛出错误。如果 3D 文件包含多个材质，则只保留第一个材质的纹理和材质因子（会记录一条警告）。所有场景图元都会合并为单个网格，并应用其变换。此节点为实验性节点。

## 输出

| 输出名    | 描述                                                                                                               | 数据类型 |
| ------ | ---------------------------------------------------------------------------------------------------------------- | ---- |
| `mesh` | 可编辑网格，包含顶点、面、UV、顶点颜色、法线和切线，以及从文件获取的材质信息（纹理、金属度-粗糙度、法线贴图、自发光颜色、unlit 标志、occlusion-in-metallic-roughness 标志和材质数据）。 | MESH |

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

***

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