点阵字库工具
点阵字库工具适合把图片中的文字或图形整理成可复用的点阵数据。它常用于截图里的文字不是普通文本、无法用文本元素抓取时。
打开工具
先打开 样本工作台，切换到 点阵字库工具 页。也可以先在取色器中打开截图，再切换到点阵字库工具继续使用同一张图。
做一个单字点阵
- 打开带有目标文字或图形的截图。
- 在原图上点击目标文字颜色，把颜色加入
二值化偏色列表。 - 必要时调整
默认容差，或直接编辑类似RRGGBB-RRGGBB的颜色范围。 - 点击
二值化，直到二值化预览中尽量只剩目标文字或图形。 - 用
Shift拖拽框住单个字。需要第二组选区时，用Meta/Ctrl拖拽。 - 在
文字中填写这个字，例如A或阿。 - 点击
提交/更新，点阵会出现在点阵列表中。
触屏或移动端可以用 Shift选区、Meta选区 按钮切换选区模式。
拆分一排文字
如果截图中有一排字，可以先框住整排，再点击 拆分。工具会按空列把一排字拆成多条点阵。
拆分前建议先确认二值化预览足够干净：背景尽量为空，文字尽量完整。拆分结果不理想时，可以调小或调大最小间隔列数，或者先用 选区适应 让选区贴合内容。
看懂结果
二值化：把图片变成只保留目标颜色的黑白预览。偏色范围：允许颜色有一点误差，避免截图抗锯齿导致漏点。点阵列表：已经整理好的字库条目。拷贝：复制当前点阵编码行，适合粘到已有字库中。导出：复制或下载整份点阵列表，适合备份或导入到其它项目。代码模板 → 拷贝代码：把当前颜色范围、选区和点阵列表生成脚本片段，适合直接粘到脚本中。左偏移/右偏移：给字符左右留空，通常保持默认即可。
保存点阵图
需要把点阵预览保存为图片时：
- 点击
保存点阵图。 - 输入文件名称。
- 检查
生成的代码。 - 选择保存位置。
- 点击
保存，或点击拷贝代码并保存图像。
选择 拷贝代码并保存图像 时，会把加载该图片的代码复制到剪贴板。通常把它粘到脚本中需要载入资源的位置。
保存点阵图像中的代码模板与取色器的区域图像模板分别保存。它支持文件名变量 $imgFileBaseName，也支持点阵代码模板的全部变量：
- Shift 选区：
$shiftRect.left、$shiftRect.top、$shiftRect.right、$shiftRect.bottom。 - Meta 选区：
$metaRect.left、$metaRect.top、$metaRect.right、$metaRect.bottom。 - 点阵内容：
$colorRange、$matrix、$matrixList、$word。
在设备测试模板
在文本编辑器或设备右键菜单设置当前开发测试设备，再点击“拷贝”左侧的“在设备测试”。取色器支持 5 个模板、find_image、load_data 和保存区域图像；点阵页支持 6 个模板和点阵图像。两页统一使用当前开发测试设备，切换后立即跟随；截图设备、设备列表和分组的勾选不会改变测试目标。未设置或设备不可用时，请先通过上述入口设置可用设备。
点击取色器模板标题旁的铅笔图标可以编辑名称、原代码和测试包装，并查看生成结果；点阵模板在原有编辑弹窗中修改。输入会自动保存，关闭或按 Escape 保留修改。模板 1～5 的空名称会显示当前语言的默认名称；清空测试包装会禁用该项测试。“恢复默认模板”会同时恢复对应名称、原代码和测试包装。
测试包装用 $code 插入当前生成的原代码，插入内容不会再次展开变量。$screenOrient 是截图方向，默认 0；点阵还可用 $coreLine 插入核心行。图像测试支持 $testResourceRoot 和 $testImagePath。保存区域图像、点阵图像可直接测试当前 PNG，无需先保存到本机。
点击后会打开编辑器并展开设备日志，保留已有文件、日志与工作台内容。日志连接就绪后才发送代码，工作台显示发送状态，结果和错误显示在日志中。设备有脚本正在运行或编辑器正在运行、调试时，请先结束任务。发送结果未确认时先检查设备日志，再决定是否重试。
OCR、FindStr 默认自动加载当前点阵列表。$matrixListLiteral 会把列表转换成可安全嵌入 Lua 的字符串，支持引号、换行与特殊字符。仍与旧默认值一致的代码会自动升级；自行修改过的代码保持原样。测试与“拷贝代码”使用同一份内容：优先完整代码，空时使用核心行。
常见问题
- 二值化预览为空：重新点击目标颜色，或适当扩大容差。
- 背景和内容反了：切换底色模式后重新提取。
- 拆分结果为 0：确认选区覆盖了目标文字、颜色范围已勾选、最小间隔列数没有设置过大。
- 提示点阵数据无效：检查导入内容是否每行一条，或重新从选区提取。