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 🔗

There is currently no description for this constant. Please help us by contributing one!

IMPORT_ANIMATION = 2 🔗

There is currently no description for this constant. Please help us by contributing one!

IMPORT_FAIL_ON_MISSING_DEPENDENCIES = 4 🔗

There is currently no description for this constant. Please help us by contributing one!

IMPORT_GENERATE_TANGENT_ARRAYS = 8 🔗

There is currently no description for this constant. Please help us by contributing one!

IMPORT_USE_NAMED_SKIN_BINDS = 16 🔗

There is currently no description for this constant. Please help us by contributing one!

IMPORT_DISCARD_MESHES_AND_MATERIALS = 32 🔗

There is currently no description for this constant. Please help us by contributing one!

IMPORT_FORCE_DISABLE_MESH_COMPRESSION = 64 🔗

There is currently no description for this constant. Please help us by contributing one!


方法說明

PackedStringArray _get_extensions() virtual const 🔗

Return supported file extensions for this scene importer.


void _get_import_options(path: String) virtual 🔗

Override to add general import options. These will appear in the main import dock on the editor. Add options via add_import_option() and add_import_option_advanced().

Note: All EditorSceneFormatImporter and EditorScenePostImportPlugin instances will add options for all files. It is good practice to check the file extension when path is non-empty.

When the user is editing project settings, path will be empty. It is recommended to add all options when path is empty to allow the user to customize Import Defaults.


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

Should return true to show the given option, false to hide the given option, or null to ignore.


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

Perform the bulk of the scene import logic here, for example using GLTFDocument or FBXDocument.


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

Add a specific import option (name and default value only). This function can only be called from _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) 🔗

Add a specific import option. This function can only be called from _get_import_options().