Version:

创建纹理图集

要创建纹理集,请创建一个纹理集 (.texatlas) 文件。纹理图集文件是一个文本文件,用于指定要添加到纹理图集的图像文件。Asset Processor 会自动构建具有.texatlas扩展名的文件。

纹理图集文件格式

.texatlas文件的每一行都表示一个按顺序执行的命令。空行将被忽略。

评论

任何以 //开头的行都表示注释。

示例

// This is a comment that is ignored.

属性

具有等于 (=) 符号的行被视为属性值赋值。未指定的属性使用其默认值。

下表显示了可配置属性的列表。

属性默认值目的
maxdimension4096输出纹理图集的最大宽度和高度。
padding1纹理图集中每个纹理周围最小额外像素数。出于压缩目的,将复制每个纹理的边缘像素。重复量由计算 image_size + padding 四舍五入到最接近的压缩单位 4 来确定。
poweroftwofalse输出纹理图集的宽度和高度是否为 2 的幂。如果 iOS 使用 [PVRTC]( https://en.wikipedia.org/wiki/PVRTC 压缩,则无论此设置如何,输出纹理都是 2 的幂。
squarefalse输出纹理图集的宽度和高度是否相同。如果 PVRTC 压缩用于 iOS,则无论此设置如何,输出纹理都是正方形。
unusedcolor#3CB371FF输出纹理图集中未使用空间的颜色。
whitetexturetrue是否在输出纹理图集中包含路径名为 WhiteTexture 的白色纹理。
presetnameTextureAtlas用于图像处理的预设。如果将 TextureAtlas 用作 presetname,无论是显式的还是默认的,图像都将被压缩。这种压缩可能会导致图像质量下降。

在分配属性值时,请注意以下事项:

  • 允许使用空格。
  • 属性和值不区分大小写。
  • 如果属性值分配了两次,则仅接受最后一次分配。
  • 以下条目向 Asset Processor 报告错误,并使资产处理作业失败:
    • 无法识别的属性
    • 属性的值不正确
    • 具有多个等号 (=) 的行

文件路径

如果有一行指定了图像文件的路径,则该图像将包含在纹理图集中。图像文件路径可以相对于 Asset Processor 监控资产的任何监视文件夹。如果一行引用无法加载的文件,则会向 Asset Processor 报告错误,并且资产处理作业将失败。既不是注释也不是属性的行被假定为图像文件路径。

示例

UI/Textures/LyShineExamples/button.tif

更新纹理图集

如果图集中的纹理发生更改或现有源.texatlas文件发生更改,Asset Processor 会自动重新构建纹理图集。

纹理图集输出文件

Asset Processor 输出两个表示纹理图集的文件:.dds文件和.texatlasidx文件。.dds 文件是包含.texatlas文件中指定的所有图像的纹理。.texatlasidx文件存储坐标和其他图像信息。