> press any key to skip

CRAFTCODE

Atlas Mode

Atlas Mode — основной режим. Пакует несколько текстур в один атлас, генерирует спрайты и Material Instances с пиксельными UV-параметрами.


Открытие редактора

Content Browser → выдели 2+ текстур → ПКМ → Sprite Optimizer → Atlas.

Редактор атласа — Items, Viewport, Settings

Структура редактора

ПанельОписание
Items (слева)Список элементов: размещённые (Placed) и не размещённые (Unplaced). Поиск, фильтр, чекбоксы.
Viewport (центр)Интерактивный холст — перемещение, поворот, выделение.
Settings (справа)Алгоритм, размер страницы, параметры вывода.

Тулбар

КнопкаШорткатОписание
AnalyzeF5Запустить алгоритм пакинга и показать превью
Create AtlasCtrl+Shift+EnterЭкспортировать атлас, спрайты, Material Instances
RepackCtrl+RПерепаковать текущую страницу
Place AllРазместить все Unplaced элементы
Import AtlasИмпортировать готовый атлас
FitHomeПодогнать вид под весь атлас
GridGПереключить сетку
SnapSПереключить привязку к сетке
Free MoveFСвободное перемещение (без коллизий)

Алгоритмы пакинга

АлгоритмЛучше всего для
Max RectsУниверсальный. 5 эвристик × 4 порядка сортировки. Отраслевой стандарт.
Bin PackАлгоритм опорных точек. Хорошо для разнородных размеров.
Fixed GridРавномерная N×M сетка. Лучший выбор для tile-based игр.
Tile (Simple)Горизонтальная/вертикальная полоса. Для линейных раскладок.

Работа с холстом

Управление

ДействиеКак
Выбрать элементЛКМ по элементу
Добавить в выделениеCtrl+ЛКМ
Rubber bandЛКМ перетащить по пустому месту
ПереместитьЛКМ перетащить по элементу
Axis lockShift+перетаскивание — фиксирует ось (H или V, автодетект)
Поворот 90°R на выделенных
Убрать из атласаDel — переходит в Unplaced

Мультистраничные атласы

Если элементы не помещаются на одной странице, плагин автоматически создаёт дополнительные страницы. Переключение через таб-бар над viewport.

Коллизии

Пересекающиеся элементы подсвечиваются красным, в статус-баре появляется предупреждение “Collisions!”. Включи Free Move (F) чтобы разрешить перекрытия.

Drag & Drop

Перетащи текстуры из Content Browser прямо в панель Items — они добавятся как Unplaced, затем нажми Place All или Analyze.


Вывод

После Create Atlas (Ctrl+Shift+Enter) в Content Browser появляются:

Content/YourFolder/
├── MyAtlas.uasset              ← атлас-текстура (BC7 компрессия)
├── MyAtlas_Project.uasset      ← сессия редактирования
├── MyAtlas_Sprite1.uasset      ← PaperSprite с корректными SourceUV
└── MyAtlas_Sprite1_MI.uasset   ← Material Instance с пиксельными UV

Material Instance параметры

ПараметрОписание
PixelX, PixelYПозиция спрайта в атласе (пиксели)
SizeW, SizeHРазмер спрайта (пиксели)
AtlasW, AtlasHРазмер атласа (пиксели)
UVRotationФлаг поворота (для упакованных с ротацией)

Работает в 3D-мешах, Paper2D-спрайтах и UMG-виджетах.


Настройки вывода

ОпцияОписание
TextureВсегда создаётся — BC7 сжатие с альфа
SpritePaperSprite ассеты
Material InstanceMI с пиксельными UV параметрами
Preserve PositionСкорректировать пивот после обрезки
Pad to x4Размеры кратны 4 для BC-компрессии