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) 🔗

Зателефонуйте цей метод, щоб фактично завантажити в вузол. Створена вершина буде розміщена в якості муфти above InstancePlaceholder в ялинку. Довідник Нод також повертається для зручності.

Примітка: методик створення_instance не є різьбовим. Використовуйте Object.call_deferred() якщо ви зателефонуєте з ниток.

String get_instance_path() const 🔗

Gets the path to the PackedScene ресурсний файл, який завантажується за замовчуванням при викликі create_instance(). Не нижня-безпечна. Використовуйте Object.call_deferred() якщо ви зателефонуєте з ниток.

Dictionary get_stored_values(with_order: bool = false) 🔗

Повертає список властивостей, які будуть застосовані до вершини, коли називається create_instance().

Якщо with_order є true, ключ названий .order (призначає провідний період) додається до словника. .order ключ — Array імен об'єктів String, в якому будуть застосовані властивості (з індексом 0, будучи першим).