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.

GDExtensionManager

Eredita: Object

Fornisce accesso alla funzionalità GDExtension.

Descrizione

GDExtensionManager carica, inizializza, e tiene traccia di tutte le librerie GDExtension disponibili nel progetto.

Nota: Non preoccuparti di GDExtension a meno che tu non sappia cosa stai facendo.

Tutorial

Metodi

GDExtension

get_extension(path: String)

PackedStringArray

get_loaded_extensions() const

bool

is_extension_loaded(path: String) const

LoadStatus

load_extension(path: String)

LoadStatus

load_extension_from_function(path: String, init_func: const GDExtensionInitializationFunction*)

LoadStatus

reload_extension(path: String)

LoadStatus

unload_extension(path: String)


Segnali

extension_loaded(extension: GDExtension) 🔗

Emesso dopo che l'editor ha finito di caricare una nuova estensione.

Nota: Questo segnale viene emesso solo nelle build dell'editor.


extension_unloading(extension: GDExtension) 🔗

Emesso prima che l'editor cominci a rimuovere un'estensione.

Nota: Questo segnale viene emesso solo nelle build dell'editor.


extensions_reloaded() 🔗

Emesso dopo che l'editor ha finito di ricaricare una o più estensioni.


Enumerazioni

enum LoadStatus: 🔗

LoadStatus LOAD_STATUS_OK = 0

L'estensione è stata caricata con successo.

LoadStatus LOAD_STATUS_FAILED = 1

Non è stato possibile caricare l'estensione, probabilmente perché non esiste o perché mancano delle dipendenze.

LoadStatus LOAD_STATUS_ALREADY_LOADED = 2

L'estensione è già stata caricata.

LoadStatus LOAD_STATUS_NOT_LOADED = 3

L'estensione non è stata caricata.

LoadStatus LOAD_STATUS_NEEDS_RESTART = 4

L'estensione richiede il riavvio dell'applicazione per essere caricata completamente.


Descrizioni dei metodi

GDExtension get_extension(path: String) 🔗

Restituisce la GDExtension nel file specificato dal percorso (path), o null se non è stata caricata o non esiste.


PackedStringArray get_loaded_extensions() const 🔗

Restituisce i percorsi di file di tutte le estensioni attualmente caricate.


bool is_extension_loaded(path: String) const 🔗

Restituisce true se l'estensione al percorso di file path è già stata caricata con successo. Vedi anche get_loaded_extensions().


LoadStatus load_extension(path: String) 🔗

Carica un'estensione dal suo percorso di file assoluto. path deve puntare a un GDExtension valido. Restituisce LOAD_STATUS_OK in caso di successo.


LoadStatus load_extension_from_function(path: String, init_func: const GDExtensionInitializationFunction*) 🔗

Loads the extension already in address space via the given path and initialization function. The path needs to be unique and start with "libgodot://". Returns LOAD_STATUS_OK if successful.


LoadStatus reload_extension(path: String) 🔗

Ricarica l'estensione nel percorso di file specificato. path deve puntare a un GDExtension valido, altrimenti questo metodo potrebbe restituire LOAD_STATUS_NOT_LOADED o LOAD_STATUS_FAILED.

Nota: È possibile ricaricare le estensioni solo nell'editor. Nelle build di rilascio, questo metodo fallisce sempre e restituisce LOAD_STATUS_FAILED.


LoadStatus unload_extension(path: String) 🔗

Rimuove un'estensione dal suo percorso di file. path deve puntare a un GDExtension già caricato, altrimenti questo metodo restituisce LOAD_STATUS_NOT_LOADED.