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...
SceneState
Eredita: RefCounted < Object
Fornisce l'accesso alle informazioni di un file di scena.
Descrizione
Mantiene una lista di risorse, nodi, proprietà esportate e sovrascritte e script incorporati associati a una scena. Non possono essere modificati da uno SceneState, ma solo accessibili. Utile per dare un'occhiata a cosa contiene un PackedScene senza istanziarlo.
Questa classe non può essere istanziata direttamente, è recuperata per una determinata scena come risultato di PackedScene.get_state().
Metodi
get_base_scene_state() const |
|
get_connection_binds(idx: int) const |
|
get_connection_count() const |
|
get_connection_flags(idx: int) const |
|
get_connection_method(idx: int) const |
|
get_connection_signal(idx: int) const |
|
get_connection_source(idx: int) const |
|
get_connection_target(idx: int) const |
|
get_connection_unbinds(idx: int) const |
|
get_node_count() const |
|
get_node_groups(idx: int) const |
|
get_node_index(idx: int) const |
|
get_node_instance(idx: int) const |
|
get_node_instance_placeholder(idx: int) const |
|
get_node_name(idx: int) const |
|
get_node_owner_path(idx: int) const |
|
get_node_path(idx: int, for_parent: bool = false) const |
|
get_node_property_count(idx: int) const |
|
get_node_property_name(idx: int, prop_idx: int) const |
|
get_node_property_value(idx: int, prop_idx: int) const |
|
get_node_type(idx: int) const |
|
get_path() const |
|
is_node_instance_placeholder(idx: int) const |
Enumerazioni
enum GenEditState: 🔗
GenEditState GEN_EDIT_STATE_DISABLED = 0
Se passato a PackedScene.instantiate(), blocca le modifiche allo stato della scena.
GenEditState GEN_EDIT_STATE_INSTANCE = 1
Se passato a PackedScene.instantiate(), fornisce le risorse di scena ereditate alla scena locale.
Nota: Disponibile solo nelle build dell'editor.
GenEditState GEN_EDIT_STATE_MAIN = 2
Se passato a PackedScene.instantiate(), fornisce le risorse di scena locali alla scena locale. Solo la scena principale dovrebbe ricevere lo stato di modifica principale.
Nota: Disponibile solo nelle build dell'editor.
GenEditState GEN_EDIT_STATE_MAIN_INHERITED = 3
Se passato a PackedScene.instantiate(), è simile a GEN_EDIT_STATE_MAIN, ma per il caso in cui la scena viene istanziata per essere la base di un'altra.
Nota: Disponibile solo nelle build dell'editor.
Descrizioni dei metodi
SceneState get_base_scene_state() const 🔗
Restituisce lo SceneState della scena da cui eredita questa scena, o null se il nodo non eredita da alcuna scena.
Array get_connection_binds(idx: int) const 🔗
Restituisce la lista dei parametri associati per il segnale all'indice idx.
int get_connection_count() const 🔗
Restituisce il numero delle connessioni di segnali nella scena.
L'argomento idx utilizzato per interrogare i metadati di connessione in altri metodi get_connection_* nell'intervallo [0, get_connection_count() - 1].
int get_connection_flags(idx: int) const 🔗
Restituisce i flag di connessione per il segnale all'indice idx. Vedi le costanti di ConnectFlags.
StringName get_connection_method(idx: int) const 🔗
Restituisce il metodo collegato al segnale all'indice idx.
StringName get_connection_signal(idx: int) const 🔗
Restituisce il nome del segnale all'indice idx.
NodePath get_connection_source(idx: int) const 🔗
Restituisce il percorso al nodo proprietario del segnale all'indice idx, relativo al nodo radice.
NodePath get_connection_target(idx: int) const 🔗
Restituisce il percorso al nodo proprietario del metodo connesso al segnale all'indice idx, relativo al nodo radice.
int get_connection_unbinds(idx: int) const 🔗
Restituisce il numero di parametri rimossi dal segnale all'indice idx.
Restituisce il numero di nodi nella scena.
L'argomento idx utilizzato per interrogare i dati dei nodi in altri metodi get_node_* nell'intervallo [0, get_node_count() - 1].
PackedStringArray get_node_groups(idx: int) const 🔗
Restituisce la lista dei nomi di gruppo associati al nodo all'indice idx.
int get_node_index(idx: int) const 🔗
Restituisce l'indice del nodo, che è la sua posizione relativa ai suoi fratelli. Questo è rilevante e salvato solo nelle scene per i casi in cui nuovi nodi sono aggiunti a una scena istanziata o ereditata tra i fratelli dalla scena di base. Nonostante il nome, questo indice non è correlato all'argomento idx utilizzato qui e in altri metodi.
PackedScene get_node_instance(idx: int) const 🔗
Restituisce un PackedScene per il nodo all'indice idx (ovvero l'intero ramo che inizia in questo nodo, con i suoi nodi figlio e le sue risorse) oppure null se il nodo non è un'istanza.
String get_node_instance_placeholder(idx: int) const 🔗
Restituisce il percorso al file di scena rappresentato se il nodo all'indice idx è un InstancePlaceholder.
StringName get_node_name(idx: int) const 🔗
Restituisce il nome del nodo all'indice idx.
NodePath get_node_owner_path(idx: int) const 🔗
Restituisce il percorso al proprietario del nodo all'indice idx, relativo al nodo radice.
NodePath get_node_path(idx: int, for_parent: bool = false) const 🔗
Restituisce il percorso al nodo all'indice idx.
Se for_parent è true, restituisce invece il percorso del genitore del nodo all'indice idx.
int get_node_property_count(idx: int) const 🔗
Restituisce il numero di proprietà esportate o sovrascritte per il nodo all'indice idx.
L'argomento prop_idx utilizzato per interrogare i dati delle proprietà del nodo in altri metodi get_node_property_* nell'intervallo [0, get_node_property_count() - 1].
StringName get_node_property_name(idx: int, prop_idx: int) const 🔗
Restituisce il nome della proprietà all'indice prop_idx per il nodo all'indice idx.
Variant get_node_property_value(idx: int, prop_idx: int) const 🔗
Restituisce il valore della proprietà all'indice prop_idx per il nodo all'indice idx.
StringName get_node_type(idx: int) const 🔗
Restituisce il tipo del nodo all'indice idx.
Restituisce il percorso di risorsa al PackedScene rappresentato.
bool is_node_instance_placeholder(idx: int) const 🔗
Restituisce true se il nodo all'indice idx è un InstancePlaceholder.