paletteData(IMGobject类成员属性) - Lucky-Koishi/KoishiExAPI GitHub Wiki
namespace Koishi;
└class NPKobject;
└palette paletteData;
IMG对象的调色板数据,仅在V4、V5、V6版本有效。
paletteData属性包含了V4、V5(限索引格式的图片型索引项)、V6中全部的颜色数据,因此也用于提取IMG对象中的颜色信息。其中,对于V4和V5版本,paletteData属性中仅含有一个颜色方案,对V6则含有多个(也包含零个)颜色方案。由于paletteData属性属于palette类实例,因此也可以通过以下方式来访问其中的数据:
myIMG.paletteData[0]; //IMG对象中的第一个颜色方案
myIMG.paletteData[0][1]; //IMG对象中的第一个颜色方案的第二个颜色项
myIMG.getCount(); //IMG对象的颜色方案数,若版本号为V4或V5,则返回1,V6按照实际颜色方案数返回
myIMG.paletteData[0].size(); //IMG对象的第一个颜色方案包含的颜色数
myIMG.getColorCount(0); //同上,如果是V4或者V5,则参数可以省略,直接getColorCount()即可
值得注意的是,paletteData属性也有与其他属性类似的性质,对其他属性来说应避免对其进行左值赋值,而对paletteData属性来说,也应避免对其进行直接修改,避免对paletteData调用非常值函数如push()等,若需要对颜色信息进行修改,应调用IMGobject类的CLRpush()、CLRnewPalette()、CLRreplace()等函数,因为后者会对缓冲区进行同步更新。
下表列出palette类函数的可用情况:
palette类函数 | 是否能使用 |
---|---|
operator[] | 允许访问,但不能对其赋值。 |
clear() | 不能使用。 |
push() | 不能使用。 |
getCount() | 可以使用。 |
getTotalColorCount() | 可以使用。 |
getColorCount() | 可以使用。 |
findColor() | 可以使用。 |
joinWith() | 不能使用。 |
tinyMake() | 可以使用。 |
bigMake() | 可以使用。 |
makeACT() | 静态函数,可以使用。 |
loadACT() | 静态函数,可以使用。 |