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...
Processo d'importazione
Importare risorse in Godot
Per importare risorse in Godot, colloca le risorse (file immagine, scene, file audio, font, ecc.) direttamente nella cartella del progetto. Ci sono due modi per farlo:
Per qualsiasi tipo di file: copia i file manualmente tramite il gestore file del tuo sistema operativo.
Per i tipi di file che si possono importare in Godot: trascina e rilascia i file dal gestore file del sistema operativo al pannello Filesystem dell'editor. Questo funziona solo con i tipi di file risorsa (ovvero i tipi di file che Godot può importare).
Godot importerà automaticamente questi file internamente e manterrà le risorse importate nascoste in una cartella res://.godot/imported/.
Ciò significa che quando si tenta di accedere alle risorse importate tramite codice, è necessario utilizzare il Resource Loader poiché terrà automaticamente conto di dove sono salvati i file interni. Se si tenta di accedere a una risorsa importata attraverso la classe FileAccess, funzionerà nell'editor, ma non funzionerà nel progetto esportato.
Tuttavia, il Resource Loader non può accedere ai file non importati. Solo la classe FileAccess può farlo.
Cambiare i parametri di importazione
Nota
Import parameters are only present in non-native Godot resource types.
This means Godot's own scene and resource file formats (.tscn, .scn,
.tres, .res) don't have import options you can select in the Import
dock.
Per cambiare i parametri di importazione di un contenuto in Godot, seleziona la risorsa interessata nel pannello del FileSystem:
After adjusting the parameters, click Reimport. Be careful: if you select another file in the FileSystem dock before clicking Reimport, changes will be discarded. After clicking Reimport, the chosen parameters will only be used for this asset and on future reimports.
Inoltre, è possibile cambiare i parametri di importazione di più contenuti allo stesso tempo. Selezionali tutti assieme nel pannello FileSystem e i parametri visualizzati verranno applicati a tutti dopo averli reimportati.
Reimportazione di più contenuti
While working on a project you may find that several assets need to have the same parameters changed, such as enabling mipmaps, but you only want those specific parameters changed. To do this, select every asset you want to reimport in the file system. In the import tab there will now be a checkbox to the left of every import parameter.
Select the checkbox of the parameters you want to change on your imported assets, then change the parameters normally. Finally, click the reimport button and every selected asset will be reimported with only those parameters changed.
Reimportazione automatica
Quando il checksum MD5 del contenuto originale cambia, Godot lo reimporta automaticamente, applicando le configurazioni della preconfigurazione (o preset) per quel contenuto specifico.
Ignorare cartelle specifiche
Sometimes, you have files that you don't want to be imported by Godot, such as images used in a game's press kit or promotional materials. You can place those files in a folder that you instruct Godot to ignore. Ignoring a folder ensures it is not imported by Godot; this also hides the folder from the FileSystem dock. Ignoring a folder also results in its contents not being exported with the project, therefore reducing the exported PCK size.
Consultare Ignorare cartelle specifiche del tutorial sull'organizzazione dei progetti per maggiori dettagli.
File generati
L'importazione aggiungerà un ulteriore file <asset>.import accanto al file sorgente, contenente la configurazione di importazione.
Assicurati di fare il commit di questi file nel tuo sistema di controllo della versione, poiché questi file contengono metadati importanti.
ls
example.png
example.png.import
project.godot
Inoltre, risorse aggiuntive saranno presenti nella cartella nascosta res://.godot/imported/:
ls .godot/imported
example.png-218a8f2b3041327d8a5756f3a245f83b.ctex
example.png-218a8f2b3041327d8a5756f3a245f83b.md5
Se uno di questi file in questa cartella viene cancellato (o tutta la cartella), la risorsa o le risorse verranno reimportate automaticamente. Perciò, non è consigliato fare il commit della cartella .godot/ nel sistema di controllo versione. Sebbene ciò possa ridurre i tempi di reimportazione durante il checkout su un altro computer, ciò richiede moltissimo più spazio e tempo di trasferimento.
The default version control metadata that can be generated on project creation
will automatically ignore the .godot/ folder.
Cambiare il tipo della risorsa da importare
Alcuni contenuti si possono importare come risorse di tipo differente. Per questo, seleziona il tipo interessato e clicca Reimporta:
Select Keep File (exported as is) as resource type to skip file import, files
with this resource type will be preserved as is during project export.
Select Skip File (not exported) as resource type to skip file import and ignore
file during project export.
Cambiare i parametri di importazione standard
Giochi diversi possono richiedere diversi valori predefinito. È possibile modificare le opzioni di importazione in un insieme predefinito attraverso il menu Preimpostazione.... Oltre ad alcuni tipi di risorse che offrono preimpostazioni, è anche possibile salvare e cancellare le preimpostazioni:
The default import parameters for a given resource type can be changed project-wide using the Import Defaults tab of the Project Settings dialog:
Ulteriore lettura
Questo flusso di lavoro richiede un po' di tempo per abituarsi, ma impone a gestire le risorse in modo più corretto.
Esistono molti tipi di risorse disponibili per essere importati. Continua a leggere per capire come utilizzarle tutti: