Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

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_lightmap_uv2	`false`
float	generate_lightmap_uv2_texel_size	`0.2`
bool	generate_lods	`true`
bool	generate_shadow_mesh	`true`
bool	generate_tangents	`true`
Vector3	offset_mesh	`Vector3(0, 0, 0)`
Vector3	scale_mesh	`Vector3(1, 1, 1)`

属性说明

bool force_disable_mesh_compression = false 🔗

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

bool generate_lightmap_uv2 = false 🔗

如果为 true，导入时会为烘焙 LightmapGI 生成 UV2。

float generate_lightmap_uv2_texel_size = 0.2 🔗

控制烘焙光照贴图上每个纹素的大小。较小的值会产生更精确的光照贴图，但代价是光照贴图尺寸更大，烘焙时间也更长。

注意：仅当 generate_lightmap_uv2 为 true 时有效。

bool generate_lods = true 🔗

如果为 true，则生成网格的较低细节变体，这些变体将显示在远处以提高渲染性能。并非所有网格体都受益于 LOD，特别是如果它们从未从远处渲染。禁用该功能可以减少输出文件大小并加快导入速度。有关详细信息，请参阅网格细节级别（LOD）。

bool generate_shadow_mesh = true 🔗

如果为 true，则在导入时启用阴影网格体的生成。这可以通过在可能的情况下将顶点焊接在一起来优化阴影渲染，且不会降低质量。这反过来又减少了渲染阴影所需的内存带宽。阴影网格生成当前不支持使用比源网格更低的细节级别（但阴影渲染将在相关时使用 LOD）。

bool generate_tangents = true 🔗

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

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

Vector3 offset_mesh = Vector3(0, 0, 0) 🔗

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

Vector3 scale_mesh = Vector3(1, 1, 1) 🔗

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