Read this manual in English

Ресурс Atlas

Несмотря на то, что отдельные изображения часто используются в качестве источника спрайтов, по соображениям производительности изображения необходимо объединять в большие массивы, называемые атласами. Объединение множества небольших изображений в атласы особенно важно для мобильных устройств, где память и вычислительная мощность более ограничены, чем в настольных компьютерах или специализированных игровых консолях.

В Defold ресурс Atlas — это список отдельных файлов изображений, которые автоматически объединяются в более крупное изображение.

Создание атласа

Выберите New... ▸ Atlas из контекстного меню браузера Assets. Присвойте имя новому файлу, после чего он откроется в соответствующем редакторе. Свойства атласа отображаются в панели Properties, где их можно редактировать (см. ниже).

Атлас необходимо заполнить изображениями или анимацией, прежде чем использовать его в качестве источника графики для таких компонентов объекта, как Sprite и Particle FX.

Необходимо убедиться, что изображения добавлены в проект (перетаскиванием файлов изображений в нужное расположение в браузер Assets).

Добавление одиночных изображений

Выполните клик ПКМ в корне ресурса Atlas в панели Outline.

Выберите Add Images из контекстного меню.

Откроется диалоговое окно, в котором можно найти и выбрать изображения для включения в атлас. Стоит отметить, что можно использовать фильтр и выбирать несколько файлов сразу.

Добавленные изображения отображаются в Outline в виде списка, при этом атлас в сборе можно увидеть в центральном окне редактора. Возможно, потребуется нажать F (View ▸ Frame Selection из меню) чтобы изменить масштаб отображения выделенного.

Добавление мултикадровой анимации

Выполните клик ПКМ в корне ресурса Atlas в панели Outline.

Выберите Add Animation Group из контекстного меню.

Новая, пустая группа анимации с именем по умолчанию (“New Animation”) будет добавлена в атлас.

Выполните клик ПКМ по новой группе и выберите Add Images из контекстного меню.

Откроется диалоговое окно, в котором можно найти и выбрать изображения для включения их в группу анимации.

Нажмите Space при выделенной группе анимации для ее предварительного просмотра. При необходимости настройте Свойства анимации (см. ниже).

Порядок изображений в Outline можно изменить, выделив их и нажав Alt + Up/down. Кроме того, можно легко создавать дубликаты, копируя и вставляя изображения в Outline (из меню Edit, контекстного меню по клику ПКМ или сочетаниями клавиш).

Свойства атласа

Каждый ресурс типа Atlas имеет набор свойств. Они отображаются в панели Properties при выделении корневого элемента в представлении Outline.

Size

Отображает общий вычисленный размер результирующей текстуры. Ширина и высота устанавливаются в ближайшую степень числа 2. Обратите внимание, что если включить сжатие текстур, некоторые форматы потребуют квадратных размеров. В этом случае размер неквадратных текстур будет изменен и заполнен пустым пространством, чтобы текстура стала квадратной. За подробностями обращайтесь к руководству по текстурным профилям.

Margin

Количество пикселей, которые должны быть добавлены между каждым изображением.

Inner Padding

Количество пустых пикселей, которые должны быть добавлены вокруг каждого изображения.

Extrude Borders

Количество краевых пикселей, которые должны быть многократно добавлены вокруг каждого изображения. Когда фрагментный шейдер делает выборку пикселей на краю изображения, пиксели соседнего изображения (на той же текстуре атласа) могут просвечиваться (bleed over). Экструзия границы решает эту проблему.

Вот примеры различных настроек свойств с четырьмя квадратными изображениями размером 64x64, добавленными в атлас. Обратите внимание, как атлас переходит к размеру 256x256, как только изображения не помещаются в 128x128, что приводит к бесполезному расходу текстурного пространства.

Свойства изображения

Каждое изображение в атласе обладает набором свойств:

Id

Идентификатор изображения (только для чтения).

Size

Ширина и высота изображения (только для чтения).

Sprite Trim Mode

Способ рендеринга спрайта. По умолчанию спрайт отображается в виде прямоугольника (опция Sprite Trim Mode установлена в Off). Если спрайт содержит много прозрачных пикселей, может оказаться более эффективным рендеринг спрайта в виде непрямоугольной формы с использованием от 4 до 8 вершин.

Image

Путь к файлу самого изображения.

Свойства анимации

Кроме списка изображений, входящих в группу анимации, доступен набор свойств:

Id

Имя анимации.

Fps

Скорость воспроизведения анимации, выраженная в кадрах в секунду (FPS).

Flip Horizontal

Переворачивает анимацию по горизонтали.

Flip Vertical

Переворачивает анимацию по вертикали.

Playback

Указывает, как должна воспроизводиться анимация:

• None — анимация вообще не воспроизводится, отображается первое изображение.
• Once Forward — воспроизводится один раз, начиная с первого и заканчивая последним изображением.
• Once Backward — воспроизводится один раз, начиная с последнего и заканчивая первым изображением.
• Once Ping Pong — воспроизводится один раз, начиная с первого и заканчивая последним изображением, затем возврат к первому.
• Loop Forward — воспроизводится циклически, начиная с первого и заканчивая последним изображением.
• Loop Backward — воспроизводится циклически, начиная с последнего и заканчивая первым изображением.
• Loop Ping Pong — воспроизводится циклически, начиная с первого и заканчивая последним изображением, затем возврат к первому.