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.

ResourceImporterOBJ

继承: ResourceImporter < RefCounted < Object

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

描述

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

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

教程

属性

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) 🔗

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