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...
ResourceUID
Eredita: Object
Un singleton che gestisce gli identificatori univoci di tutte le risorse all'interno di un progetto.
Descrizione
Gli UID delle risorse (Unique IDentifier) consentono al motore di mantenere intatti i riferimenti tra le risorse, anche se i file sono rinominati o spostati. Sono accessibili con uid://.
ResourceUID tiene traccia di tutti gli UID registrati delle risorse in un progetto, genera nuovi UID e converte tra le loro rappresentazioni di stringa e di numeri interi.
Metodi
void |
|
create_id_for_path(path: String) |
|
ensure_path(path_or_uid: String) static |
|
get_id_path(id: int) const |
|
id_to_text(id: int) const |
|
path_to_uid(path: String) static |
|
void |
|
void |
|
text_to_id(text_id: String) const |
|
uid_to_path(uid: String) static |
Costanti
INVALID_ID = -1 🔗
Il valore da utilizzare per un UID non valido, ad esempio se la risorsa non può essere caricata.
La sua rappresentazione testuale è uid://<invalid>.
Descrizioni dei metodi
void add_id(id: int, path: String) 🔗
Aggiunge un nuovo valore di UID che viene mappato al percorso della risorsa specificato.
Fallisce con un errore se l'UID esiste già, quindi assicurati di controllare prima has_id(), oppure usa set_id().
Genera un UID di risorsa casuale che è garantito di essere univoco all'interno della lista degli UID attualmente caricati.
Per registrare questo UID, è necessario chiamare add_id() o set_id().
int create_id_for_path(path: String) 🔗
Simile a create_id(), ma l'UID è generato con il parametro path fornito e il nome del progetto. Gli UID generati per quel percorso saranno sempre gli stessi all'interno del progetto attuale.
String ensure_path(path_or_uid: String) static 🔗
Returns a path, converting path_or_uid if necessary. Fails and returns an empty string if an invalid UID is provided.
String get_id_path(id: int) const 🔗
Restituisce il percorso a cui fa riferimento il valore UID specificato.
Fallisce con un errore se l'UID non esiste, quindi assicurati di controllare prima has_id().
Restituisce se il valore UID fornito è presente nella cache.
String id_to_text(id: int) const 🔗
Converte l'UID specificato in un valore di stringa uid://.
String path_to_uid(path: String) static 🔗
Converte la risorsa fornita al percorso path in un UID. Restituisce il percorso invariato se non ha un UID associato.
Rimuove un valore UID caricato dalla cache.
Fallisce con un errore se l'UID non esiste, quindi assicurati di controllare prima has_id().
void set_id(id: int, path: String) 🔗
Aggiorna il percorso della risorsa di un UID esistente.
Fallisce con un errore se l'UID non esiste, quindi assicurati di controllare prima has_id() o di usare add_id().
int text_to_id(text_id: String) const 🔗
Estrae il valore UID dalla stringa uid:// specificata.
String uid_to_path(uid: String) static 🔗
Converte l'uid fornito in un percorso. Stampa un errore se l'UID non è valido.