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
Segnaposto per il Node radice di un PackedScene.
Descrizione
Attivando l'opzione Carica come segnaposto per una scena istanziata nell'editor, la scena sarà sostituita da un InstancePlaceholder all'esecuzione del gioco, il che non sostituirà il nodo nell'editor. Ciò rende possibile ritardare il caricamento effettivo della scena fino alla chiamata di create_instance(). È utile per evitare di caricare scene grandi tutte in una volta, caricandone selettivamente in parti.
Nota: Come Node, InstancePlaceholder non ha una trasformazione. Ciò significa che tutti i nodi figlio saranno posizionati relativamente all'origine della Viewport, anziché il loro genitore come visualizzato nell'editor. Sostituendo il segnaposto con una scena con una trasformazione trasformerà nuovamente i figli relativamente al loro genitore.
Metodi
create_instance(replace: bool = false, custom_scene: PackedScene = null) |
|
get_instance_path() const |
|
get_stored_values(with_order: bool = false) |
Descrizioni dei metodi
Node create_instance(replace: bool = false, custom_scene: PackedScene = null) 🔗
Chiama questo metodo per caricare effettivamente il nodo. Il nodo creato verrà posizionato come fratello sopra l'InstancePlaceholder nell'albero di scene. Per comodità, viene restituito anche il riferimento al Node creato.
Nota: create_instance() non è sicuro su un altro thread. Usa Object.call_deferred() se si chiama da un thread.
String get_instance_path() const 🔗
Ottiene il percorso al file della risorsa PackedScene caricata come predefinita quando si chiama create_instance(). Non è sicuro su un altro thread. Utilizza Object.call_deferred() se si chiama da un thread.
Dictionary get_stored_values(with_order: bool = false) 🔗
Restituisce la lista delle proprietà che saranno applicate al nodo quando create_instance() è chiamato.
Se with_order è true, una chiave denominata .order (nota il punto iniziale) viene aggiunta al dizionario. Questa chiave .order è un Array di nomi di proprietà String che specificano l'ordine in cui le proprietà saranno applicate (con l'indice 0 come primo).