Processus d’importation

Importer des ressources dans Godot 3.0+

Précédemment, importer des assets dans Godot 2.x requérait la maintenance manuelle d’un répertoire avec les fichiers sources des assets. Sans faire ça, il était impossible de spécifier comment convertir et comment changer une configuration d’importation pour les textures, l’audio, les scènes, etc.

In Godot 3.0+, we use a more modern approach to importing: Simply drop your assets (image files, scenes, audio files, fonts, etc) directly in the project folder (copy them manually with your OS file explorer). Godot will automatically import these files internally and keep the imported resources hidden in a res://.import folder.

Cela signifie que lorsque vous essayez d'accéder à des ressources importées par le biais du code, vous devez utiliser le Resource Loader car il prendra automatiquement en compte l'endroit où les fichiers internes sont enregistrés. Si vous essayez d'accéder à une ressource importée en utilisant la classe Fichier, cela fonctionnera dans l'éditeur, mais pas dans le projet exporté.

Cependant, la classe Resource Loader ne peut pas accéder aux fichiers non importés, seule la classe File le peut.

Changer les paramètres d’importation

Pour changer les paramètres d’importation d’un asset dans Godot(encore une fois, gardez à l’esprit que les paramètres d’importation sont seulement présents pour les types de ressources non-natifs de Godot) sélectionnez la ressource concernée dans le dock du système de fichiers :

../../../_images/asset_workflow1.png

Et, après ajustement des paramètres, pressez "Reimport". Les paramètres utilisés seront uniquement appliqués à cet asset et seront utilisés pour les réimportations futures.

Changer les paramètres d’importation pour plusieurs assets en même temps est possible également. Sélectionnez-les toutes ensemble dans l’onglet ressources et les paramètres exposés seront appliqués à chacune d’entre elles lors de leur réimportation.

Réimporter plusieurs assets

En travaillant sur un projet, vous pouvez constater que plusieurs assets doivent avoir les mêmes paramètres modifiés, comme l'activation des mipmaps, mais que vous ne voulez que ces paramètres spécifiques uniquement soient modifiés. Pour ce faire, sélectionnez chaque asset que vous souhaitez réimporter dans le système de fichiers. Dans l'onglet d'importation, il y aura désormais une case à cocher à gauche de chaque paramètre d'importation.

../../../_images/reimport_multiple.png

Cochez la case des paramètres que vous souhaitez modifier sur vos assets importés, puis modifiez les paramètres normalement. Enfin, cliquez sur le bouton de réimportation et chaque asset sélectionné sera réimporté avec uniquement les paramètres modifiés.

Réimportation automatique

Lorsque que la somme de contrôle MD5 d’une ressource change, Godot effectuera une réimportation automatique de celle-ci, en appliquant les paramètres configurés pour cette ressource spécifique.

Fichiers générés

Importing will add an extra <asset>.import file, containing the import configuration. Make sure to commit these to your version control system!

../../../_images/asset_workflow4.png

Additionally, extra assets will be preset in the hidden res://.import folder:

../../../_images/asset_workflow5.png

Si l'un des fichiers présents dans ce dossier est effacé (ou le dossier entier), la ou les assets seront réimportées automatiquement. De la sorte, la validation de ce dossier sur le système de contrôle de version est facultative. Cela permet de gagner du temps sur la réimportation lors de la vérification sur un autre ordinateur, mais cela prend beaucoup plus de place et de temps de transfert. Choisissez votre poison !

Changer le type d’importation de ressource

Certains assets sources peuvent être importés comme différent types de ressources. Pour cela, sélectionnez le type de ressource désiré et appuyez sur "Reimport" :

../../../_images/asset_workflow2.png

Changer les paramètres d’importation par défaut

Différent types de jeux peuvent nécessiter des valeurs par défaut différentes. Changer ces valeurs par défaut pour un projet peut être effectué en utilisant le menu "Pré-configuration". En plus de certains types de ressources offrant des pré-configurations, la configuration par défaut peut-être sauvées et remise à zéro aussi :

../../../_images/asset_workflow3.png

La simplicité est la clé !

C'est un flux de travail très simple qui devrait prendre très peu de temps pour s'y habituer. Il impose également une manière plus adéquate de gérer les ressources.

Il existe de nombreux types de ressources disponibles pour l’importation, alors continuez à lire pour comprendre comment les utiliser !