ResourceImporterTextureAtlas

继承： ResourceImporter < RefCounted < Object

将PNG图像中的纹理集合导入优化的AtlasTexture以进行2D渲染。

描述

这会将PNG图像中的纹理集合导入AtlasTexture或2DArrayMesh。这可用于在从spritesheets导入2D动画时节省内存。纹理图集仅在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 = "" 🔗

图集spritesheet的路径。此必须设置为PNG图像的有效路径。否则，图集将无法导入。

---

bool crop_to_region = false 🔗

如果true，则丢弃图集中的空白区域。这只影响最终精灵定位，不影响存储。另请参见trim_alpha_border_from_region。

注：仅当import_mode为地区时有效。

---

int import_mode = 0 🔗

区域：在AtlasTexture资源中导入图集，该图集呈现为矩形。这渲染速度很快，但是如果trim_alpha_border_from_region不能有效地修剪透明区域，仍然需要渲染它们。这会降低在屏幕上渲染大型精灵时的性能。

Mesh：将图集作为ArrayMesh资源导入，保持原始位图可见（但渲染为多边形）。这可用于在渲染大型透明精灵时降低填充率，如果精灵中几乎没有透明区域，则以较慢的渲染为代价。

---

bool trim_alpha_border_from_region = true 🔗

如果true，则使用裁剪矩形（从不旋转）修剪区域以排除全透明像素。这可用于节省内存。另见crop_to_region。

注：仅当import_mode为地区时有效。