Processo de importação

Importando ativos em Godot 3.0+

Previously, importing assets in Godot 2.x required manual maintenance of a separate directory with source assets. Without doing this, it was impossible to specify how to convert and change import flags for textures, audio files, scenes, 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.

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.

Alterando Parâmetros de Importação

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.

Changing the import parameters of several assets at the same time is also possible. Simply select all of them together in the resources dock and the exposed parameters will apply to all of them when reimporting.

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.

Reimportação Automática

Quando a soma de verificação MD5 do ativo de origem for alterada, Godot executará uma reimportação automática, aplicando a predefinição configurada para esse ativo específico.

Arquivos gerados

A importação adicionará um arquivo extra <asset> .import, contendo a configuração de importação. Certifique-se de cometer estes para o seu sistema de controle de versão!

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

Além disso, os ativos extras serão predefinidos na pasta res: //.import oculta:

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

If any of the files present in this folder is erased (or the whole folder), the asset or assets will be reimported automatically. As such, committing this folder to the version control system is optional. It can shorten reimporting time when checking out on another computer, but it takes considerably more space and transfer time. Pick your poison!

Alterando o Tipo de Recurso de Importação

Alguns recursos de origem podem ser importados como tipos diferentes de recursos. Para isso, selecione o tipo relevante de recurso desejado e pressione "Reimport":

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

Alterando Parâmetros de Importação Padrão

Diferentes tipos de jogos podem exigir padrões diferentes. Alterar os padrões por projeto pode ser obtido usando o menu "Preset ..". Além de alguns tipos de recursos que oferecem predefinições, a configuração padrão também pode ser salva e desmarcada:

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

Simplicidade é a chave!

Este é um fluxo de trabalho muito simples, que deve levar muito pouco tempo para se acostumar. Também impõe uma maneira mais correta de lidar com recursos.

Existem muitos tipos de recursos disponíveis para importação, portanto, continue lendo para entender como trabalhar com todos eles!