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

Наследует: Node < Object

Заполнитель для корневого Node PackedScene.

Описание

Включение параметра Загрузить как плейсхолдер для созданной сцены в редакторе приводит к её замене на InstancePlaceholder при запуске игры, но не заменяет узел в редакторе. Это позволяет отложить фактическую загрузку сцены до вызова create_instance(). Это полезно, чтобы избежать одновременной загрузки больших сцен, загружая их по частям.

Примечание: Как и Node, InstancePlaceholder не имеет преобразования. Это приводит к тому, что все дочерние узлы располагаются относительно начала координат Viewport, а не относительно их родительских узлов, как отображается в редакторе. Замена плейсхолдера на сцену с преобразованием снова преобразует дочерние узлы относительно их родительских узлов.

Методы

Node	create_instance(replace: bool = false, custom_scene: PackedScene = null)
String	get_instance_path() const
Dictionary	get_stored_values(with_order: bool = false)

Описания метода

Node create_instance(replace: bool = false, custom_scene: PackedScene = null) 🔗

Вызовите этот метод для фактической загрузки узла. Созданный узел будет помещен как родственный выше InstancePlaceholder в дереве сцены. Ссылка на Node также возвращается для удобства.

Примечание: create_instance() не является потокобезопасным. Используйте Object.call_deferred() при вызове из потока.

String get_instance_path() const 🔗

Получает путь к файлу ресурсов PackedScene, который загружается по умолчанию при вызове create_instance(). Не потоко-безопасно. Используйте Object.call_deferred() при вызове из потока.

Dictionary get_stored_values(with_order: bool = false) 🔗

Возвращает список свойств, которые будут применены к узлу при вызове create_instance().

Если with_order равен true, ключ с именем .order (обратите внимание на начальную точку) добавляется в словарь. Этот ключ .order представляет собой Array имен свойств String, определяющих порядок, в котором будут применены свойства (индекс 0 является первым).