Процес імпорту

Імпорт активів (ассетів) у Godot 3.0+

Раніше імпорт активів у Godot 2.x вимагав ручної підтримки окремого каталогу з вихідними активами. Без цього, неможливо було вказати, як конвертувати та змінювати прапори (флаги) імпорту текстур, аудіофайлів, сцен тощо.

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.

This means that when trying to access imported assets through code you need to use the Resource Loader as it will automatically take into account where the internal files are saved. If you try and access an imported asset using the File class it will work in the editor, but break in the exported project.

However, the Resource Loader cannot access non imported files, only the File class can.

Зміна параметрів імпорту

To change the import parameters of an asset in Godot (again, keep in mind import parameters are only present in non-native Godot resource types) select the relevant resource in the filesystem dock:

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

Then, after adjusting the parameters, press "Reimport". These parameters will only be used for this asset and on future reimports.

Можлива зміна параметрів імпорту кількох активів одночасно. Просто виберіть їх усіх разом на панелі ресурсів, і відкриті параметри будуть застосовані до всіх при повторному імпорті.

Reimporting multiple assets

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.

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

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.

Automatic reimport

Коли контрольна сума MD5 вихідного ресурсу зміниться, Godot здійснить автоматичний повторний імпорт, застосувавши попередньо налаштований для цього конкретний ресурс.

Згенеровані файли

Імпорт додасть додатковий файл <asset> .import, що містить конфігурацію імпорту. Не забудьте скористатись цією системою контролю версій!

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

Крім того, додаткові активи будуть встановлені в прихованій теці res://.import:

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

Якщо будь-який із файлів, присутніх у цій теці, буде стерто (або вся папка), актив, або активи, будуть повторно імпортовані автоматично. Таким чином, закріплення цієї папки в системі управління версіями не є обов'язковим. Це може скоротити час повторного імпорту при переході на інший комп'ютер, але це забирає значно більше місця та часу на передачу. Виберіть,що, з гіршого, для вас краще!

Зміна типу ресурсу імпорту

Деякі вихідні активи можна імпортувати як різні види ресурсів. Для цього виберіть потрібний тип потрібного ресурсу та натисніть «Reimport»:

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

Зміна параметрів імпорту за замовчуванням

Для різних типів ігор можуть знадобитися різні параметри за замовчуванням. Їх зміна для кожного проекту може бути досягнута за допомогою меню "Попередньо .." ("Preset.."). Окрім деяких типів ресурсів, які пропонують свої попередні параметри, ці параметри також можна зберегти та очистити:

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

Простота є ключем!

Це дуже простий процес, до якого легко звикнути. Він також застосовує більш правильний спосіб поводження з ресурсами.

Є багато видів активів, доступних для імпорту, тому, будь ласка, читайте далі, щоб зрозуміти, як працювати з усіма ними!