跳到主要内容

# 点阵字库工具

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

## 打开工具​

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

## 做一个单字点阵​

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`。

## 常见问题​

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