Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

ResourceImporterOBJ

继承： ResourceImporter < RefCounted < Object

将 OBJ 3D 模型导入为独立的 Mesh 或场景。

描述

与 ResourceImporterScene 不同，ResourceImporterOBJ 默认情况下会导入单个 Mesh 资源，而不是导入一个 PackedScene。这使得在需要直接 Mesh 资源的节点（例如 GridMap、GPUParticles3D 或 CPUParticles3D）中使用 Mesh 资源变得更加容易。请注意，无论源格式如何，仍然可以使用高级导入设置对话框保存 3D 场景中的网格资源。

另请参见 ResourceImporterScene，它被用于更高级的 3D 格式，例如 glTF。

教程

• 导入 3D 场景

属性

bool	force_disable_mesh_compression	false
bool	generate_tangents	true
Vector3	offset_mesh	Vector3(0, 0, 0)
bool	optimize_mesh	true
Vector3	scale_mesh	Vector3(1, 1, 1)

---

属性说明

bool force_disable_mesh_compression = false

如果为 true，则不会使用网格压缩。如果你在网格法线或 UV 中发现块状伪影，或者如果你的网格在每个方向都大于几千米，请考虑启用。

---

bool generate_tangents = true

如果为 true，如果源网格没有切线数据，则使用 Mikktspace 生成顶点切线。如果可能，建议让 3D 建模软件在导出时生成切线，而不是依赖该选项。正确显示法线和高度贴图，以及任何需要切线的材质/着色器功能都需要切线。

如果你不需要那些需要切线的材质特性，则禁用该功能可以减少输出文件大小，并在源 3D 文件不包含切线的情况下加快导入速度。

---

Vector3 offset_mesh = Vector3(0, 0, 0)

将网格数据偏移指定值。这可被用于解决未对齐的网格，而无需修改源文件。

---

bool optimize_mesh = true

未使用的参数。这目前没有效果。

---

Vector3 scale_mesh = Vector3(1, 1, 1)

按指定值缩放网格数据。这可被用于解决缩放错误的网格，而无需修改源文件。