资产定义

图集资产（Texture Atlas Asset）是在 SandMod 游戏编辑器中的 项目窗口（Project）内创建的，用于编辑与记录图集的图片纹理信息。创建后将在 项目窗口（Project）对应项目文件夹中获得图集资产，该资产样式如图：

【Texture_Atlas_Asset001.png】

项目文件夹中的图集资产

创建资产

从 项目窗口（Project） 中创建菜单或从 项目窗口（Project） 中创建图集资产。

方法一：

在 项目窗口 中，点击 添加（+） 然后选择 图集（Atlas） 。

【Texture_Atlas_Asset002.png】

方法二：

在 项目窗口 中右键点击空白处，然后选择 创建（Create） > 图集（Atlas） 。

【Texture_Atlas_Asset003.png】

编辑资产

如果您需要编辑 图集资产（Texture Atlas Asset），您可以在 项目窗口（Project）中点击选中图集资产，此时在 检视窗口（Inspector）中即可查看并编辑该图集资产的属性。

【Texture_Atlas_Asset004.png】

在 检视窗口（Inspector）中，除了资产的基础属性外（具体请参阅 资产 章节），您还可以看到图集资产的以下可编辑属性：

【Texture_Atlas_Asset005.png】

名称	描述
尺寸（Size）	设置导入的 图片纹理（Texture）的最大尺寸，属性值以像素为单位。对于尺寸较大的图片纹理，您可以使用此属性将纹理缩小到合适的尺寸大小，是便捷的图片压缩方式。如果导入的图片纹理的宽或高像素值超出了图集此属性值，则图集会忽略该图片纹理的尺寸，并将图集的宽高像素值保持小于或等于此值。
图片（Images）
元素条目（Element）	元素条目的属性值决定了图集所包含和显示的内容，其属性值为 2D 贴图资产。 · 创建元素条目：如果您需要创建元素条目，请在列表下方点击 追加（Append）按钮。 【Texture_Atlas_Asset006.png】 · 定义元素条目数：列表右上角可设置列表中元素条目的数量，元素条目会根据设置的数量增删，会优先删除序号更大的元素条目。 【Texture_Atlas_Asset007.png】 · 自定义序列： 您可以拖动每个元素条目左侧的控制柄以调整该元素条目的顺序。此顺序不会影响图集的图片打包排序。 【Texture_Atlas_Asset008.gif】 · 删除：鼠标左键点击元素条目右侧的删除按钮（x），可对元素条目进行删除。 【Texture_Atlas_Asset009.png】 · 赋值：可从 项目窗口（Project）将 2D 贴图资产拖入，或点击条目选框右侧的圆形图标打开选择列表选择 2D 贴图资产用以分配给此元素条目。
预览（Preview）	点击该属性按钮以后会根据设置的属性生成图集预览图，您可以在 预览窗口（Preview）查看图集的预览图，预览窗口的操作方法请参阅 图集预览 小节。

CAUTION

在编辑 图集资产（Atlas Asset）后，元素条目（Element）中所引用的 图片纹理（Texture）不能删除，否则图集资产会无法读取该元素而发生错误。

图集预览

您在设置图集的相关内容并点击 预览（Preview） 按钮，您可以在 检视窗口（Inspector）底部查看图集预览。

【Texture_Atlas_Asset010.png】

如果预览窗口没有显示，您可以拖动 检视窗口（Inspector）底部的 预览窗口（Preview）将其显示，并可通过拖动 预览窗口（Preview）的顶部调整窗口的大小。

【Texture_Atlas_Asset011.gif】

如果图集所包含的图片纹理排列后图集的尺寸超过 尺寸（Size）属性的设置值，除了会对尺寸大于该属性值的图片纹理进行压缩以外，还会对其他图片纹理进行分页处理，您可以通过切换按钮查看该图集其他页面的内容。

【Texture_Atlas_Asset012.png】

引用资产

您可以使用代码 Atlas.GetTexture(uuid:string, out_rect:Rect) 在需要引用 2D 贴图资产（2D Texture Asset）的时候引用 图集资产（Texture Atlas Asset）中所包含的图片纹理。其中传入的 out_rect 参数会在这段代码运行时将参数值更改为该图片纹理在图集中的位置和大小。关于该代码的详细使用方法请参阅 API 文档关于 Atlas.GetTexture 的相关内容。

【Texture_Atlas_Asset013.png】

资产右键菜单

在 项目窗口（Project）中，鼠标指向图集资产，并点击鼠标右键，即会打开图集资产对应的上下文菜单，在上下文菜单中您可以对此图集资产进行以下内容的编辑。

【Texture_Atlas_Asset009.png】

名称	描述
在资源管理器中显示（Show In Explorer）	在电脑的资源管理器上打开选中的图集资产。
复制（Copy）	复制所选图集资产至剪贴板。
剪切（Cut）	剪切所选图集资产至剪贴板，与复制不同的是，剪切后的图集资产将不再出现于原路径下。
复制并粘贴（Duplicate）	在所选的图集资产路径下克隆一份所选的图集资产。
重命名（Rename）	使对象名称可编辑，以便进行更改。按 Enter 键以保存更改，或按 Esc 键以取消重命名。
删除（Delete）	删除选中的图集资产。
复制资源 ID（Copy Asset ID）	复制选中的图集资产的 ID，Resources.Load 代码可以直接通过此 ID 将图集资产以 Atlas 类型动态引用。
复制路径（Copy Path）	以 Type Script 语法的方式，创建选中的图集资产从 Assets 目录下的路径在剪贴板中。