GEIMG Wiki：把图片拟合成图元

适用版本：1.3.0及更高

GEIMG（GE 图片工具）用于把 PNG、照片、Logo、UI 截图等图片拟合成由圆、椭圆和线形图元组成的数据集。它负责图片导入、拟合、局部补精度、视觉检查和数据集导出；数据集之后交给什么程序使用，由用户自行决定。

本 Wiki 的目标是让人或 AI **高效地把图拟合出来**。这里不规定 Lua、Live2D、游戏控件、特定引擎或某种动画方案，也不把任何下游格式当成默认答案。需要 Lua 或运行时知识时，请到对应的下游知识库获取。

## 推荐阅读顺序

1. [01-快速开始](https://docs.lumkfs.cn/GEIMG-WIKI/01/)：用 GUI 或 CLI 跑通一次最小流程。
2. [02-CLI工作流](https://docs.lumkfs.cn/GEIMG-WIKI/02/)：理解会话、四步状态机和可恢复操作。
3. [03-拟合模式与三个开关](https://docs.lumkfs.cn/GEIMG-WIKI/03/)：决定标准/透明模式及边缘、底色选项。
4. [04-参数、图元预算与性能](https://docs.lumkfs.cn/GEIMG-WIKI/04/)：分配图元预算并做本机测试。
5. [05-视觉验收与画质问题](https://docs.lumkfs.cn/GEIMG-WIKI/05/)：用图片判断是否真的变好。
6. [06-区域拟合与benchmark](https://docs.lumkfs.cn/GEIMG-WIKI/06/)：把预算放到最需要的区域，并记录设备差异。
7. [07-数据集格式与导出](https://docs.lumkfs.cn/GEIMG-WIKI/07/)：读取 GEIMG 的中立输出契约。
8. [08-命令参考](https://docs.lumkfs.cn/GEIMG-WIKI/08/)：查命令、前置条件和常见错误。
9. [09-已知问题与经验状态](https://docs.lumkfs.cn/GEIMG-WIKI/09/)：查看已验证、待复现和版本相关结论。

## 怎么读结论

- **工具不变量**：违反后会导致解析错误、流程不能继续或结果明显错误，例如图元字段含义、数组绘制顺序和坐标空间。
- **实验经验**：在特定素材、机器或版本上观察到的有效做法，可以作为起点，不能直接当硬门槛。
- **待验证**：目前没有足够对照数据。不要把它写成默认规则，应先做小规模对照。

同屏图元总数约 3000 可以作为起步参考，但它不是限制，也不是质量门槛。图片类型、目标细节、设备和同时显示的图片都会改变合适的预算。

## 版本边界与来源

命令、参数和状态机以 1.3.0 系列的当前实现为准。参数与画质的经验来自我们自己的拟合标定记录，覆盖平涂、赛璐璐、厚涂、照片、透明 Logo 和 UI 截图等素材类型。更早版本的图形界面教程只作为历史参考，遇到冲突时以本 Wiki 和程序自身的帮助输出为准。

Lua、Live2D、游戏控件和沙箱装配属于下游话题，我们在另一份资料里单独讲。本 Wiki 不重复那部分内容，也不把 Lua 当作 GEIMG 的默认消费方式。