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
Marcador de posición para la raíz Node de una PackedScene.
Descripción
Activar la opción Carga como marcador de posición para una escena instanciada en el editor hace que se sustituya por un InstancePlaceholder al ejecutar el juego. Esto no reemplazará el nodo en el editor. Esto hace posible retrasar la carga real de la escena hasta que se llame a create_instance(). Esto es útil para evitar cargar grandes escenas de una sola vez, cargando partes de ellas de forma selectiva.
Nota: Al igual que Node, InstancePlaceholder no tiene una transformación. Esto hace que cualquier nodo hijo se posicione de forma relativa al origen del Viewport, en lugar de su padre como se muestra en el editor. Reemplazar el marcador de posición por una escena con una transformación transformará a los hijos de forma relativa a su padre de nuevo.
Métodos
create_instance(replace: bool = false, custom_scene: PackedScene = null) |
|
get_instance_path() const |
|
get_stored_values(with_order: bool = false) |
Descripciones de Métodos
Node create_instance(replace: bool = false, custom_scene: PackedScene = null) 🔗
Llama a este método para cargar el nodo. El nodo creado será colocado como un hermano por encima del InstancePlaceholder en el árbol de la escena. La referencia del Node también se devuelve por conveniencia.
Nota: create_instance() no es seguro para hilos. Usa Object.call_deferred() si se llama desde un hilo.
String get_instance_path() const 🔗
Obtiene la ruta del archivo de recursos PackedScene que se carga por defecto al llamar a create_instance(). No es seguro para hilos. Usa Object.call_deferred() si se llama desde un hilo.
Dictionary get_stored_values(with_order: bool = false) 🔗
Devuelve la lista de propiedades que se aplicarán al nodo cuando se llame a create_instance().
Si with_order es true, se añade al diccionario una clave llamada .order (nótese el punto inicial). Esta clave .order es un Array de Strings que contiene los nombres de las propiedades, especificando el orden en que se aplicarán (siendo el índice 0 el primero).