P1-1(会静默开错图):取消「书库从列表推导图片下标」。 - 新增 mr_reader_open_dir_at_name(dir, name):阅读器打开目录册后,在**自己刚枚举出的 全量目录册**(mr_dir_book,与翻页同一份枚举)里按 basename 定位起始页(先精确, 再大小写不敏感兜底;找不到退回续读/首页)。书库点击只传文件名。 - 删除 mr_library_image_index(不再有跨枚举的隐式契约)。 - 截断提示文案改为「仅显示前 2000 项(图片可在阅读器中翻到)」。 - 修复前(cb02722 探针,2100 张 4 位名夹具):rows=2000/truncated=1/ library_images=2000/reader_pages=2100/**mismatched=590**(首行 p1412 → 打开 p1411); 评审夹具为 1995/2000。修复后:2000 个可见图片行按名定位 **0 mismatch**, 2100 页全量可翻;26 次真实 UI 点开(首尾各 3 + 20 个确定性伪随机)逐张命中。 连带处理(评审 r1): 1. 删掉 reader_page_enter 的 c->view 死写(reopen 判定用 activity active/depth); 顺手删掉 library_page_create 里同款死写。 2. 阅读器册间衔接根锁定:新增 mr_path_within_root + mr_book_adjacent_rooted, book_switch 用浏览根(默认 MR_ROOT_DIR,测试可注入)钳制相邻册; 根外的兄弟册按「没有相邻册」处理。test_cont_adjacent A7 验证「明文 _ex 会越根、 rooted 拒绝、根内翻册不受影响」;test_mode_switch_host H6 验证条漫末页不越根。 3. test_reader_perf 不再依赖顶栏 tap 命中时序:模式切换改走测试钩子 mr_reader_test_toggle_mode()(与顶栏动作同一个 mode_set),负载下稳定。 4. page_cache 注释去掉「缩略图缓存/缩略图线程」过时描述(只改文字)。 回归:run_tests.sh(library 81 / nav 74 / lazy 57 / perf 25 / … / open_book 含 2100 用例) 与 run_webtoon_tests.sh(含 A7/H6)全 PASS;交叉构建零警告。
58 lines
3.2 KiB
C
58 lines
3.2 KiB
C
/* ui/reader/reader.h — 阅读页给 app.c 的事件接缝(跟手拖动/平移)。
|
||
*
|
||
* app.c 只做最小路由:ACT_READER 时的 on_touch_down/move 转给这里(镜像 library 分支)。
|
||
* 其余入口(on_tap / view on_event / mr_reader_open_dir)仍走 tuku_internal.h 的既有声明。
|
||
*/
|
||
#ifndef TUKU_UI_READER_READER_H
|
||
#define TUKU_UI_READER_READER_H
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
void reader_on_touch_down(int x, int y);
|
||
void reader_on_touch_move(int x, int y);
|
||
|
||
/* 书库 → 阅读器(文件管理器模式用):按目录内图片自然序从 start_index 开始。
|
||
* - start_index >= 册页数:钳到末页;其它负数按 0 处理;
|
||
* - start_index == MR_READER_START_RESUME(-1):沿用该册续读记录(= mr_reader_open_dir)。
|
||
* 显式下标优先于续读记录:用户在列表里点了某张图,就不该被上次的页码带走。 */
|
||
#define MR_READER_START_RESUME (-1)
|
||
void mr_reader_open_dir_at(const char *dir, int start_index);
|
||
|
||
/* 书库 → 阅读器(按文件名定位起始页;M18 评审 P1-1 的首选入口):
|
||
* 打开 dir 后,由阅读器自己的目录册枚举(logic/reader/page_source.c: mr_dir_book_init,
|
||
* 与翻页用的是同一份全量枚举)按 basename 找起始页(先大小写敏感,再大小写不敏感兜底)。
|
||
* 找不到则退回续读记录/首页。这样书库不需要(也不能)从可能被 MR_LIB_SCAN_MAX 截断的
|
||
* 列表里推导下标——目录条目超过 2000 时也不会「点 A 开 B」。name 为 NULL/空则等价续读。 */
|
||
void mr_reader_open_dir_at_name(const char *dir, const char *name);
|
||
|
||
/* 保留旧入口:等价于 mr_reader_open_dir_at(dir, MR_READER_START_RESUME)。 */
|
||
void mr_reader_open_dir(const char *dir);
|
||
|
||
#ifdef MR_READER_HOST_TEST
|
||
/* 宿主集成测试专用:只读观察本页状态(不参与产品逻辑)。 */
|
||
int mr_reader_ui_mode(void); /* MR_MODE_PAGED / MR_MODE_WEBTOON */
|
||
int mr_reader_ui_page(void); /* 当前页(条漫=视口顶端所在页) */
|
||
int mr_reader_ui_count(void); /* 当前册页数 */
|
||
int mr_reader_ui_jump_open(void); /* 1=跳页滑块已展开 */
|
||
int mr_reader_ui_jump_pending(void);/* 1=跳页目标等待解码 */
|
||
long mr_reader_ui_resident_kb(void);/* 驻留页图字节(KB) */
|
||
int mr_reader_ui_failed_pages(void);/* 解码失败/超预算被跳过的页数 */
|
||
int mr_reader_ui_blit_draws(void); /* 累计原生 blit 绘页次数(热路径应为纯 blit) */
|
||
int mr_reader_ui_scaled_draws(void);/* 累计重采样绘页次数(每帧重采样=卡顿) */
|
||
int mr_reader_ui_decode_count(void);/* 累计解码次数(查重解抖动/活锁) */
|
||
int mr_reader_ui_fit(void); /* 当前 fit 档(MR_FIT_*) */
|
||
int mr_reader_ui_chrome(void); /* 1=顶栏可见 */
|
||
/* 直接切模式(绕过顶栏 tap 的命中时序;测试用,产品路径仍走顶栏动作)。 */
|
||
void mr_reader_test_toggle_mode(void);
|
||
/* 浏览根(生产=MR_ROOT_DIR):册间衔接不得越过它。测试可指向合成夹具根。 */
|
||
void mr_reader_test_set_root(const char *root);
|
||
const char *mr_reader_test_root(void);
|
||
#endif
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
#endif /* TUKU_UI_READER_READER_H */
|