跳到主要内容

点阵字库工具

点阵字库工具适合把图片中的文字或图形整理成可复用的点阵数据。它常用于截图里的文字不是普通文本、无法用文本元素抓取时。

打开工具​

先打开 样本工作台,切换到 点阵字库工具 页。也可以先在取色器中打开截图,再切换到点阵字库工具继续使用同一张图。

做一个单字点阵​

  1. 打开带有目标文字或图形的截图。
  2. 在原图上点击目标文字颜色,把颜色加入 二值化偏色列表。
  3. 必要时调整 默认容差,或直接编辑类似 RRGGBB-RRGGBB 的颜色范围。
  4. 点击 二值化,直到二值化预览中尽量只剩目标文字或图形。
  5. 用 Shift 拖拽框住单个字。需要第二组选区时,用 Meta/Ctrl 拖拽。
  6. 在 文字 中填写这个字,例如 A 或 阿。
  7. 点击 提交/更新,点阵会出现在 点阵列表 中。

触屏或移动端可以用 Shift选区、Meta选区 按钮切换选区模式。

拆分一排文字​

如果截图中有一排字,可以先框住整排,再点击 拆分。工具会按空列把一排字拆成多条点阵。

拆分前建议先确认二值化预览足够干净:背景尽量为空,文字尽量完整。拆分结果不理想时,可以调小或调大最小间隔列数,或者先用 选区适应 让选区贴合内容。

看懂结果​

  • 二值化:把图片变成只保留目标颜色的黑白预览。
  • 偏色范围:允许颜色有一点误差,避免截图抗锯齿导致漏点。
  • 点阵列表:已经整理好的字库条目。
  • 拷贝:复制当前点阵编码行,适合粘到已有字库中。
  • 导出:复制或下载整份点阵列表,适合备份或导入到其它项目。
  • 代码模板 → 拷贝代码:把当前颜色范围、选区和点阵列表生成脚本片段,适合直接粘到脚本中。
  • 左偏移 / 右偏移:给字符左右留空,通常保持默认即可。

保存点阵图​

需要把点阵预览保存为图片时:

  1. 点击 保存点阵图。
  2. 输入文件名称。
  3. 检查 生成的代码。
  4. 选择保存位置。
  5. 点击 保存,或点击 拷贝代码并保存图像。

选择 拷贝代码并保存图像 时,会把加载该图片的代码复制到剪贴板。通常把它粘到脚本中需要载入资源的位置。

保存点阵图像 支持文件名变量 $imgFileBaseName 及以下变量:

  • Shift 选区:$shiftRect.left、$shiftRect.top、$shiftRect.right、$shiftRect.bottom。
  • Meta 选区:$metaRect.left、$metaRect.top、$metaRect.right、$metaRect.bottom。
  • 点阵内容:$colorRange、$matrix、$matrixList、$word。

在设备测试模板​

在文本编辑器或设备右键菜单中设置开发测试设备,点击模板旁的“在设备测试”,然后在编辑器的设备日志中查看结果。测试前请先停止正在运行或调试的脚本。

在模板编辑窗口中修改原代码和测试包装,并查看生成结果。需要重置时,点击“恢复默认模板”。

测试包装用 $code 插入当前生成的原代码,插入内容不会再次展开变量。$screenOrient 是截图方向,默认 0;点阵还可用 $coreLine 插入核心行。图像测试支持 $testResourceRoot 和 $testImagePath。保存区域图像、点阵图像可直接测试当前 PNG,无需先保存到本机。

OCR、FindStr 测试使用当前点阵列表。自定义模板可用 $matrixListLiteral 插入列表。

常见问题​

  • 二值化预览为空:重新点击目标颜色,或适当扩大容差。
  • 背景和内容反了:切换底色模式后重新提取。
  • 拆分结果为 0:确认选区覆盖了目标文字、颜色范围已勾选、最小间隔列数没有设置过大。
  • 提示点阵数据无效:检查导入内容是否每行一条,或重新从选区提取。