字库模块总览 - Overview

本分类做什么

围绕 系统已安装字体 与 字库资源：批量生成字形 PNG、可选入库、枚举字体名、根据截图反推字体与字号。与 文字识别 中 字库识字 衔接：本分类偏 字库素材生产与字体分析，识字找字在「文字识别」分类。

---

一、三接口职责对照

接口	输入侧重	输出侧重	典型场景
BuildFontLibrary	字符集（文本/区间/文件）、字体路径或系统名、字号、是否抗锯齿、可选 DB	导出数量 或失败码；可 仅 PNG 或 同时入库	为新游戏/UI 批量造 字库图 并写入数据库
GetSystemFontNames	无业务参数（仅需实例）	| 分隔的 字体名字符串	下拉框填充、BuildFontLibrary 的 fontName 候选
SearchFontByImage	截图路径、已知文本、候选字体列表、字号范围、样式掩码	JSON（bestFont/bestSize/score/top 等）	UI 上截一块字图，反查最接近的 系统字体+字号

---

二、BuildFontLibrary 内部参数差异（选型）

参数	差异要点
charsetType	0 文本 / 1 区间表达式 / 2 文件路径 —— 同一函数三种字符集来源。
outputDir	可为空：仅 入库 时允许；目录创建失败可能 只跳过 PNG 仍入库（见详情页）。
fontPath vs fontName	路径优先；空则走 系统字体名（需本机已安装，可配合 GetSystemFontNames）。
fixedCellWidth/Height	0 表示 按字形真实包围盒；非 0 为 固定格子（对齐字库表）。
dbHandle	0 常表示 默认库（需已 OpenDatabase）。
cover	是否 覆盖 已有同名字库数据。

---

三、SearchFontByImage 与 BuildFontLibrary 的分工

对比	SearchFontByImage	BuildFontLibrary
目的	反查字体参数	正向生成字形与字库
输入	已有渲染截图 + 已知文字	字符集 + 字体参数
输出	排序后的 候选 JSON	文件 与/或 数据库记录

---

四、相关分类

模块	关系
文字识别 - InitDictFromDir 等	使用本模块产出的 PNG/库名 做识字。
数据库	入库依赖连接与表结构。

---

五、注意

• SearchFontByImage 的 fontStyleMask 各位含义以 插件版本文档 为准（粗体/斜体等组合）。
• 生成 大量字符 时注意磁盘与 数据库体积。