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

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