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.

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() 添加选项。

注意:所有 EditorSceneFormatImporterEditorScenePostImportPlugin 实例都会为所有文件添加选项。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 🔗

在此处执行批量场景导入逻辑,例如使用 GLTFDocumentFBXDocument


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() 中调用。