目录 一 KoishiEx 介绍 二 KoishiEx WIKI介绍 三 KoishiEx 数据元素 四 范例列表

　　KoishiEx是用于解析和修改NPK、IMG文件的代码库，目前版本为1。
　　完成于2017年11月15日，作者：乘着歌声的翅膀（恋恋）

　　KoishiEx用于解析DNF下的ImagePack2文件夹下的NPK文件以及衍生出的IMG文件，并允许对其进行修改等操作。
　　NPK文件是DNF用于存储贴图的文件包，它由若干个IMG文件构成，而IMG文件又由若干个图片集构成。IMG文件根据包含图片的格式和读取方式，分为1-6的6个版本，KoishiEx支持对其中的2、4、5、6版本进行分析、操作和互相转换，并支持图片、IMG包的拆解、打包、替换等操作。
　　KoishiEx不能用于解析音频NPK包，但是可以将NPK包内的音频文件名解析出来，但无法提取；KoishiEx同样不能用于解析其他不符合文件格式的其他文件，在使用KoishiEx制作EX或其他工具时，原则上应对解析是否成功进行判断，以增强工具的健壮性（虽然极特殊情况下，依然会解析成功但实际上是解析错误，从而仍然会导致程序崩溃）。
　　KoishiEx无法对敏感操作进行识别，例如将一个指向型索引项指向自己等，在制作EX等其他工具时，也需要务必注意到这一点，根据输出来确定您是否应该允许这么做。

• 读取并解析NPK文件、IMG文件(限2、4、5、6版本)到指定的NPK对象、IMG对象中。
• 将NPK对象、IMG对象的内容存储为NPK文件、IMG文件。
• IMG文件内部图片提取为像素矩阵。
• IMG文件内贴图的插入、删除和替换。
• IMG文件版本转换（2、4、5、6互转）。
• IMG文件内部其他数据的编辑，例如调色板，DDS贴图，索引项等。
• 数据流编辑和控制，导入导出为二进制文件。
• 颜色编辑和控制，导入导出为act文件。
• 像素矩阵的编辑、控制、剪切、扩充、拼合、导入导出为png文件。

• 代码库版权声明。
• 代码库的使用前设置。

　　这个WIKI暂时由原作者编写和维护，待全部写好后会开放全体用户来维护，姑且把它当成使用手册来看待吧。

　　KoishiEx代码库中对基础数据类型（包括char、short、long、int、long long、double、float）以及某些C++API类型(包括std::string以及各种类型的std::vector)进行了重命名，请参见KoishiEx 数据类型重命名页面。

　　KoishiEx代码库所使用的宏定义和常数，参见KoishiEx 宏定义、常数页面。

　　KoishiEx基础类是本代码库最主要的类，用于对NPK和IMG文件进行解析和编辑，包括NPKobject类和IMGobject类。

　　KoishiEx代码库所使用的枚举，请参见KoishiEx枚举页面。

　　KoishiEx辅助类是本代码库用于辅助基础类进行工作的数据类型，但实际操作时也将用到他们，包括stream、color、colorHSV、point、size、matrix、palette、IMGindex、PICinfo和DDSinfo。
　　KoishiEx衍生类是通过辅助类与某些指针和泛型构成的数据类型，包括pstream、pcolor、ppoint、psize、lcolor、llcolor、IMGcontent、PIClist和DDSlist等。
　　KoishiEx辅助类和衍生类的相关介绍参见KoishiEx辅助类和衍生类页面。