colorFormat(枚举) - Lucky-Koishi/KoishiExAPI GitHub Wiki
namespace Koishi;
└enum colorFormat;
该枚举表示图片型索引项采用的颜色格式(或数据格式),用于PICinfo对应的图片数据格式和颜色转换。
PICinfo里包含一个colorFormat类型的属性PICinfo::format,在对IMG文件进行提取时,会识别其图片型索引项中表示颜色格式的字节并将其存储为PICinfo类里的format属性,并作为该图片型索引项的类型:
如果是等于LINK(0x11),说明该索引项是指向型索引项;
如果是大于LINK,说明该索引项采用DDS引用形式,包括DXT1、3、5;
如果是小于LINK,说明该索引项是普通图片索引项,包括ARGB1555、ARGB4444、ARGB8888三种颜色格式。
值得注意的是,该枚举中并非所有值都直接来源于IMG文件,其中,COLOR_UDEF、V4_FMT和RGB565用于辅助作用,并不用于IMG的解析中。
colorFormat枚举中包含的值如下表所示:
元素 | 整型值 | 描述 |
---|---|---|
COLOR_UDEF | 0 | 表示缺省格式。 |
V4_FMT | 1 | 辅助作用,由于IMGV2中表示ARGB1555的格式数据和在非IMGV2中表示索引模式的格式数据均为0x0E,因此该值用在非IMGV2中指示应采取索引模式解析图像数据,而并非使用ARGB1555。 |
RGB565 | 2 | 辅助作用,RGB565本身用作DDS图像中的颜色数据,该值用作IMGV5中DDS图像向ARGB图像时进行颜色格式转换所采用的参数。 |
ARGB1555 | 0x0E | 在IMGV2中表示图像颜色格式采用ARGB1555;在带有调色板数据的非IMGV2中表示索引模式数据。 |
ARGB4444 | 0x0F | 表示该索引项对应的图像颜色格式采用ARGB4444。 |
ARGB8888 | 0x10 | 表示该索引项对应的图像颜色格式采用ARGB8888。 |
LINK | 0x11 | 表示该索引项为指向型索引项。 |
DDS_DXT1 | 0x12 | 表示该索引项采用引用DXT1格式DDS图像的方式。 |
DDS_DXT3 | 0x13 | 表示该索引项采用引用DXT3格式DDS图像的方式。 |
DDS_DXT5 | 0x14 | 表示该索引项采用引用DXT5格式DDS图像的方式。 |