exporting data from aseprite (ru)
Aseprite - замечательное приложение для работы с pixel-art графикой и анимацией. У него много удобных инструментов для рисования, возможность изменения палитр и таблица слоев и кадров. На линии кадров можно выделять диапазоны с помощью тегов, в которых можно указать направление и количество повторений анимации. Для каждого кадра можно индивидуально задать длительность. Слои могут быть 4 типов: обычный растровый слой, референсный слой, слой тайловой карты и группа слоёв.
Aseprite позволяет гибко настроить экспорт в разные форматы, указывать, какие слои и тэги будут участвовать в экспорте, и самое главное - создавать атласы анимаций, так называемые sprite sheets. А так же у него есть богатый API для сценариев на Lua и CLI (интерфейс командной строки).
Чтобы не приходилось постоянно вызывать экспорт из Aseprite вручную и потом настраивать импорт его результатов в проект Godot, можно настроить импорт *.aseprite-файлов с помощью Importality. Для этого в настройках проекта в секции "Importality" укажите директорию временных файлов и укажите путь к исполняемому файлу Aseprite. Затем выберите *.aseprite-файл в дереве файловой системы Godot, на вкладке "Import" выберите нужный формат импорта, настройте его параметры и нажмите кнопку "Reimport". При изменении формата импорта движок потребует перезагрузку.
Если вы импортируете *.aseprite-файл как изображение, будет импортирован лишь первый его кадр. Если как набор анимаций - то будет создано по одной одноимённой анимации на каждый тег на таблице кадров. Плагин распознает направление анимации и количество её повторов.
Если при импорте произошли какие-то ошибки, внимательно прочитайте сообщения в консоли "Output" (вывод) и проверьте, правильно ли заполнены настройки путей и параметры импорта. Так же может помочь удаление *.import-файла рядом с файлом *.aseprite и одноимённых файлов из скрытой папки .godot/imported. Если эти действия не помогли, заведите тикет о своей проблеме в этом репозитории, и опишите в нём свою проблему. Укажите в нём вашу операционную систему, версию Aseprite, способ его дистрибуции и версию движка Godot. Приложите к нему скриншоты и другие материалы, которые помогут воспроизвести и исправить вашу проблему. Вы очень поможете этим развитию проекта!
У Aseprite иногда встречаются ошибки при упаковке атласа, связанные с выбранными расстояниями между спрайтами и краями атласа.
Например, бесплатном наборе шаблонных анимаций автора Zeggy, который можно скачать на itch.io, Aseprite неправильно упаковывает атлас, если указать параметры:
- Sheet Type: Packed
- Trim Cels: True
- Border Padding: 1
- Spacing (Shape Padding): 1
На картинке ниже, я залил всю неиспользуемую спрайтами область синим цветом, и стали видны места, где спрайты соприкасаются между собой и с границами атласа.
В связи с этой ошибкой, в ближайшее время я переведу упаковку атласа c функционала Aseprite на свой алгоритм, который используется для упаковки атласов в интеграциях с остальными приложениями.
