WIP checkpoint (M2.53→M2.54 工作区): 字体归MeowOS/fonts+SDK跟随+多字体(进行中)+boot板载+状态栏28+亮度/音量修复+文档刷新

font/meow_font.h

@@ -51,6 +51,62 @@ void meow_font_drawtext(uint16_t *fb, int x, int y, const char *utf8,
 void meow_font_drawtext_outline(uint16_t *fb, int x, int y, const char *utf8,
                                 uint16_t color, uint16_t outline_color, int ol, int size);
 
+/* ---- 字符分类器（multi_font 逐字符路由的依据；按 codepoint 归类）---- */
+typedef enum {
+    MEOW_FCLS_CJK       = 0,  /* CJK 表意文字 + 扩展 / 兼容表意（U+3400-4DBF/4E00-9FFF/20000-2FA1F/…） */
+    MEOW_FCLS_CJK_SYM   = 1,  /* 全角/中文标点（U+3000-303F、U+FF00-FFEF、U+2014/2018-201D/2026、U+00B7） */
+    MEOW_FCLS_NUM       = 2,  /* 0-9 */
+    MEOW_FCLS_LATIN     = 3,  /* A-Za-z（基本拉丁字母） */
+    MEOW_FCLS_LATIN_SYM = 4,  /* 半角标点（ASCII 非字母数字：空格/括号/引号/运算符/控制符） */
+    MEOW_FCLS_OTHER     = 5,  /* 其他（假名/韩文/他文字/扩展区等） */
+    MEOW_FCLS_COUNT     = 6
+} meow_fclass;
+
+/* 把一个 codepoint 归类为上述之一。 */
+int meow_font_class_of(uint32_t cp);
+
+/* 校验码位是否在「将用于渲染它的字库」中存在字形（1=有，0=缺字/字库未加载→渲染为豆腐）。
+ * multi_font 开启时按分类路由到对应字库，关闭时仅查全局字库（slot 0）。 */
+int meow_font_has_glyph(uint32_t cp);
+
+/* ---- 多字体（MEOW_FCLS* 逐字符路由）----
+ * 槽位模型：slot 0 = meow_font_load() 装载的全局/默认字库（font.file）；额外字库经
+ * meow_font_load_slot() 装载后，用 meow_font_set_class_slot() 把某字符类指到某一槽。
+ * meow_font_drawtext/width_text/line_height/... 在 meow_font_enable_multifont(1) 开启时
+ * 逐字符分类 → 用该类别对应槽的字库取字形与度量；缺该类别字库/未加载 → 回退 slot 0。
+ * 关闭（默认）时一律走 slot 0，行为与单字体完全一致（零额外开销）。
+ * 同 family 去重、≤4 套上限由 meow_font_config_multifont() 统一处理（launcher 与 SDK 共用）。 */
+#define MEOW_MAX_SLOTS 5   /* slot0(全局) + ≤4 套类别字库；超出则截断并置 *truncated=1（调用方 WARN） */
+
+int  meow_font_load_slot(int slot, const char *png_path, const char *idx_path); /* 0=成功，负值失败 */
+void meow_font_unload_slot(int slot);
+void meow_font_enable_multifont(int on);         /* 0=单字体（默认）；1=逐字符分类路由 */
+void meow_font_set_class_slot(meow_fclass cls, int slot);  /* slot 越界/载入失败 → 该类别回退 slot 0 */
+
+/* 一个字符类的候选字库路径（绝对路径，已由调用方按卡根解析；png=NULL/空 = 跟随全局）。 */
+typedef struct {
+    const char *png;
+    const char *idx;
+} meow_font_class_cfg;
+
+/* 依据开关 + 各类候选配置多字体：同 png 路径去重（含与全局相同 → 直接用 slot 0），
+ * 独立字库数（含全局）> MEOW_MAX_SLOTS 时截断并置 *truncated=1（此前已装载的保留）。
+ * 返回 0 成功，负值失败；*distinct = 实际装载的不同字库数（含全局）。 */
+int  meow_font_config_multifont(int on,
+                                const char *global_png, const char *global_idx,
+                                const meow_font_class_cfg cfg[MEOW_FCLS_COUNT],
+                                int *distinct, int *truncated);
+
+/* ---- MeowPanel 预留：TF 卡字体库 .zip 导入/导出（TODO，未实现）----
+ * 当前仅声明占位，供 MeowPanel 后续接入；不实现、不接 zip 库。
+ * 调用方约定（待实现）：导入=校验 .zip 内含 font.png+font.idx+font.json 三件套，
+ *   校验通过后解压到 TF 卡 MeowOS/fonts/<family>/（family 取自 font.json 的 family 或 zip 名，
+ *   冲突时覆盖需先确认）；导出=把 MeowOS/fonts/<family>/ 三件套打包为 <out_zip>。
+ *   目录布局与 font.json schema 见 docs/MEOWOS_SPEC_REF.md §1.2/§5.2。
+ * 返回码：MEOW_OK=0 成功，负值错误码（沿用本模块失败负值约定）。 */
+int  meow_font_import_zip(const char *zip_path);            /* TODO：MeowPanel */
+int  meow_font_export_zip(const char *family, const char *out_zip);  /* TODO：MeowPanel */
+
 #ifdef __cplusplus
 }
 #endif