# 获取 3D 组件

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`
