ResourceImporterTextureAtlas

Наследует: ResourceImporter < RefCounted < Object

Импортирует коллекцию текстур из изображения PNG в оптимизированный AtlasTexture для 2D-рендеринга.

Описание

Это импортирует коллекцию текстур из изображения PNG в AtlasTexture или 2D ArrayMesh. Это можно использовать для экономии памяти при импорте 2D-анимаций из spritesheets. Текстурные атласы поддерживаются только в 2D-рендеринге, а не в 3D. См. также ResourceImporterTexture и ResourceImporterLayeredTexture.

Примечание: ResourceImporterTextureAtlas не обрабатывает импорт TileSetAtlasSource, который создается с помощью редактора TileSet.

Свойства

String

atlas_file

""

bool

crop_to_region

false

int

import_mode

0

bool

trim_alpha_border_from_region

true


Описания свойств

String atlas_file = "" 🔗

Путь к листу спрайтов атласа. Этот путь должен быть установлен на действительный путь к PNG-изображению. В противном случае атлас не будет импортирован.


bool crop_to_region = false 🔗

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

Примечание: Действует только если import_modeRegion.


int import_mode = 0 🔗

Region: Импортирует атлас в ресурс AtlasTexture, который визуализируется как прямоугольник. Это быстро визуализируется, но прозрачные области все равно должны визуализироваться, если их невозможно эффективно обрезать с помощью trim_alpha_border_from_region. Это может снизить производительность при визуализации больших спрайтов на экране.

Mesh: Импортирует атлас как ресурс ArrayMesh, сохраняя исходное растровое изображение видимым (но визуализируя его как многоугольник). Это можно использовать для снижения скорости заполнения при визуализации больших прозрачных спрайтов за счет более медленной визуализации, если в спрайте мало или совсем нет прозрачных областей.


bool trim_alpha_border_from_region = true 🔗

Если true, обрезает область, чтобы исключить полностью прозрачные пиксели, используя прямоугольник обрезки (который никогда не поворачивается). Это можно использовать для экономии памяти. См. также crop_to_region.

Примечание: Действует только если import_mode равно Region.