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() 静态函数,可以使用。

参见

  IMGobject类

⚠️ **GitHub.com Fallback** ⚠️