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.

Checking the stable version of the documentation...

InstancePlaceholder

Inherits: Node < Object

Marcador de posición para la raíz Node de una PackedScene.

Descripción

Turning on the option Load As Placeholder for an instanced scene in the editor causes it to be replaced by an InstancePlaceholder when running the game. This makes it possible to delay actually loading the scene until calling replace_by_instance. This is useful to avoid loading large scenes all at once by loading parts of it selectively.

The InstancePlaceholder does not have a transform. This causes any child nodes to be positioned relatively to the Viewport from point (0,0), rather than their parent as displayed in the editor. Replacing the placeholder with a scene with a transform will transform children relatively to their parent again.

Métodos

Node

create_instance ( bool replace=false, PackedScene custom_scene=null )

String

get_instance_path ( ) const

Dictionary

get_stored_values ( bool with_order=false )

void

replace_by_instance ( PackedScene custom_scene=null )

Descripciones de Métodos

Not thread-safe. Use Object.call_deferred if calling from a thread.

  • String get_instance_path ( ) const

Gets the path to the PackedScene resource file that is loaded by default when calling replace_by_instance. Not thread-safe. Use Object.call_deferred if calling from a thread.

  • void replace_by_instance ( PackedScene custom_scene=null )

Replaces this placeholder by the scene handed as an argument, or the original scene if no argument is given. As for all resources, the scene is loaded only if it's not loaded already. By manually loading the scene beforehand, delays caused by this function can be avoided.