AskaEth
ff97f3cee7
- 条漫：meow_scroll 跟手+fling，按滚动位置懒解码视口±1 页（驻留上限 4 页）； 排版用 mr_book_meta 累加适宽高度（nav.c 纯逻辑，宿主可测） - 模式：阅读 chrome 图标一键切翻页/条漫；每册模式与 last page 经 meow_config 持久化 （reader.mode/page.<FNV1a64(册路径)>），重进该册恢复模式与页码 - 续读：离开/翻页/滚动停止节流落盘；书库扫描给含图册副标题追加「· 续读 Pn」 - 册间衔接：末页前进→同父目录下一含图册首页，首页后退→上一册末页；无相邻册轻提示不退出 - 跳页：chrome 内 meow_slider，目标页预解码完成后落位（2.5s 超时降级提示） - 解码：改走 M12 预算解码 meow_img_load_file_dim；超大 PNG/BMP 先 probe 预判， 超 40MiB 原始 RGBA 跳过并显示「图片无法显示」，12MiB 以上记 WARN（如实保留残余风险） - 测试：新增条漫排版/跳页状态/模式续读持久化/册间边界宿主测试，以及真实 SDK 源码树上的 阅读器集成测试（模式切换/跳页落位/续读/跨册），test/run_webtoon_tests.sh 一键运行
76 lines
3.6 KiB
C
76 lines
3.6 KiB
C
/* logic/library.h — 漫画书库扫描/排序（纯 C，不依赖 meow_ui.h）。
|
||
*
|
||
* 分层契约同 examples/hello：logic 层只含文件系统与纯数据，宿主 gcc 可直接裸测。
|
||
* （M7 起另提供每册续读角标与册间顺序查询；续读状态本身由 logic/reader.c 持久化，
|
||
* 本层只读它来拼副标题，宿主测试用配置存根顶替。）
|
||
* 书库语义：
|
||
* - 从 TF 卡根（MR_ROOT_DIR）起列「直接子目录」；
|
||
* - 只保留自身含 PNG/JPEG/BMP 的目录，或子树中最终含图的中间目录（可继续导航）；
|
||
* - 行的 pages=该目录直接图片数；subdirs=其下含图子目录数（中间目录用于副标题）；
|
||
* - cover=缩略图源文件：优先该目录自然序第一张图，否则取第一个含图子目录的 cover；
|
||
* - 条目按名称自然排序（page2 < page10），含前导零与数字/字母混合名。
|
||
*
|
||
* 深度上限 MR_LIB_MAX_DEPTH 用于防止坏卡/超大树的无限递归；隐藏目录与系统目录
|
||
* （. 开头、MeowAPPs/MeowData/MeowOS/lost+found）不参与书库。符号链接跳过（防环）。
|
||
*/
|
||
#ifndef MR_LIBRARY_H
|
||
#define MR_LIBRARY_H
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
#define MR_PATH_MAX 512
|
||
#define MR_NAME_MAX 256
|
||
#define MR_LIB_MAX_DEPTH 8
|
||
|
||
typedef struct mr_library_entry {
|
||
char name[MR_NAME_MAX]; /* 目录名（行主标题） */
|
||
char path[MR_PATH_MAX]; /* 完整路径（导航/进 reader 用） */
|
||
char cover[MR_PATH_MAX]; /* 缩略图源图（空=none） */
|
||
char subtitle[48]; /* 预先格式化好的 "N pages" / "N folders" */
|
||
int pages; /* 本目录直接图片数 */
|
||
int subdirs; /* 本目录下含图子目录数 */
|
||
int has_images; /* 1=本目录直接含图（点入进 reader） */
|
||
} mr_library_entry;
|
||
|
||
typedef struct mr_library {
|
||
mr_library_entry *items;
|
||
int count;
|
||
int cap;
|
||
} mr_library;
|
||
|
||
/* 扩展名判断：png/jpg/jpeg/bmp（大小写不敏感）。1=受支持图片。 */
|
||
int mr_path_is_image(const char *name);
|
||
|
||
/* 自然排序比较：数字段按数值比（page2 < page10），数字相等时前导零少的在前；
|
||
* 非数字段 ASCII 大小写不敏感，完全等价时按原始字节序定序。 */
|
||
int mr_natural_cmp(const char *a, const char *b);
|
||
|
||
/* 扫描 dir 的直接子目录，写入 lib（先释放 lib 旧内容）。
|
||
* 返回条目数（>=0）；dir 不可读返回 -1（lib 仍为空且可安全 mr_library_free）。
|
||
* max_depth<=0 或超过 MR_LIB_MAX_DEPTH 时按上限处理。 */
|
||
int mr_library_scan(mr_library *lib, const char *dir, int max_depth);
|
||
|
||
/* 释放条目数组并清零（可重复调用）。 */
|
||
void mr_library_free(mr_library *lib);
|
||
|
||
/* 取父目录路径（去掉末尾 '/' 后截断最后一段）。根 "/" 返回 "/"。
|
||
* 成功 0；参数非法/输出缓冲不足 -1。 */
|
||
int mr_path_parent(const char *path, char *out, int outsz);
|
||
|
||
/* 目录是否**直接**含受支持图片（= 书库语义里的「一本书」，可直接进 reader）。
|
||
* 1=有；0=没有/不可读。 */
|
||
int mr_library_dir_has_images(const char *dir);
|
||
|
||
/* 册间衔接（M7）：同父目录下按书库自然序排列的「直接含图」兄弟册。
|
||
* delta=+1 下一册 / -1 上一册。1=找到并写入 out 完整路径；
|
||
* 0=没有相邻册（当前册是首/末册，或当前册不在兄弟表中）；-1=参数非法。
|
||
* 语义与书库一致：跳过隐藏/系统目录与符号链接，排序同 mr_natural_cmp。 */
|
||
int mr_book_adjacent(const char *dir, int delta, char *out, int outsz);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
#endif /* MR_LIBRARY_H */
|