EditorSceneFormatImporter¶

继承： RefCounted < Object

派生： EditorSceneFormatImporterBlend, EditorSceneFormatImporterFBX2GLTF, EditorSceneFormatImporterGLTF, EditorSceneFormatImporterUFBX

从第三方的3D文件导入场景。

描述¶

EditorSceneFormatImporter允许为第三方3D格式定义导入器脚本。

要使用EditorSceneFormatImporter，首先使用EditorPlugin.add_scene_format_importer_plugin()方法注册它。

PackedStringArray	_get_extensions() virtual const
void	_get_import_options(path: String) virtual
Variant	_get_option_visibility(path: String, for_animation: bool, option: String) virtual const
Object	_import_scene(path: String, flags: int, options: Dictionary) virtual
void	add_import_option(name: String, value: Variant)
void	add_import_option_advanced(type: Variant.Type, name: String, default_value: Variant, hint: PropertyHint = 0, hint_string: String = "", usage_flags: int = 6)

IMPORT_SCENE = 1 🔗

IMPORT_ANIMATION = 2 🔗

IMPORT_FAIL_ON_MISSING_DEPENDENCIES = 4 🔗

IMPORT_GENERATE_TANGENT_ARRAYS = 8 🔗

IMPORT_USE_NAMED_SKIN_BINDS = 16 🔗

IMPORT_DISCARD_MESHES_AND_MATERIALS = 32 🔗

IMPORT_FORCE_DISABLE_MESH_COMPRESSION = 64 🔗

PackedStringArray _get_extensions() virtual const 🔗

返回此场景导入器支持的文件扩展名。

void _get_import_options(path: String) virtual 🔗

覆盖以添加常规导入选项。这些将出现在编辑器的主导入停靠站中。通过add_import_option()和add_import_option_advanced()添加选项。

注意：所有EditorSceneFormatImporter和EditorScenePostImportPlugin实例都会为所有文件添加选项。path非空时检查文件扩展名是一个很好的做法。

当用户编辑项目设置时，path将为空。建议在path为空时添加所有选项，以允许用户自定义导入默认值。

Variant _get_option_visibility(path: String, for_animation: bool, option: String) virtual const 🔗

应该返回true以显示给定选项，返回false以隐藏给定选项，或返回null以忽略。

Object _import_scene(path: String, flags: int, options: Dictionary) virtual 🔗

在此处执行大部分场景导入逻辑，例如使用GLTFDocument或FBXDocument。

void add_import_option(name: String, value: Variant) 🔗

添加特定的导入选项（仅限名称和默认值）。此函数只能从_get_import_options()调用。

void add_import_option_advanced(type: Variant.Type, name: String, default_value: Variant, hint: PropertyHint = 0, hint_string: String = "", usage_flags: int = 6) 🔗

添加特定的导入选项。此函数只能从_get_import_options()调用。