EditorScenePostImport

Inherits: Reference < Object

Category: Core

Brief Description

Post process scenes after import

Methods

String get_source_file ( ) const
String get_source_folder ( ) const
Object post_import ( Object scene ) virtual

Description

Imported scenes can be automatically modified right after import by setting their Custom Script Import property to a tool script that inherits from this class.

The post_import callback receives the imported scene’s root node and returns the modified version of the scene. Usage example:

tool # needed so it runs in editor
extends EditorScenePostImport

# This sample changes all node names

# Called right after the scene is imported and gets the root node
func post_import(scene):
    # change all node names to "modified_[oldnodename]"
    iterate(scene)
    return scene # remember to return the imported scene

func iterate(node):
    if node != null:
        node.name = "modified_"+node.name
        for child in node.get_children():
            iterate(child)

Method Descriptions

  • String get_source_file ( ) const

Returns the source file path which got imported (e.g. res://scene.dae).

  • String get_source_folder ( ) const

Returns the resource folder the imported scene file is located in.

Gets called after the scene got imported and has to return the modified version of the scene.