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

# 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。如果 3D 文件包含多个材质，则仅保留第一个材质的纹理和材质因子（会记录警告）。所有场景图元都会在应用其变换后合并为单个网格。此节点为实验性节点。

## 输出

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

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

***

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