AskaEth
e896a28fba
P1-1 内存账没算全：高档解码时低档还占着槽，但门控/预留只按新图算。 - 高档请求携带发起时的常驻快照（page_req.resident），解码前按 「常驻 + reader_estimate_peak()」算这次操作的总峰值，上限 MR_TIER_TOTAL_CAP （12MB，与 page_source 的绝对上限同值；常态 3MB 只约束 stb 回退路径， 后端页本来就超 3MB 且已被 M27 放行），超了跳过高档、保留低档（skip=coexist）。 - 峰值本身靠调度压回基线：分页模式焦点页还是低档时不预取邻居（预取来会被 换清晰腾掉），换清晰前 slots_reserve 腾掉非可见页，高档只与焦点低档共存。 B8（--wrap malloc，两实例并行）：max_live_delta 3250KB→550KB， 绝对峰值 5279KB→3932KB（基线 3929KB）。 P1-2 换清晰挤掉预取：换清晰后不重跑窗口，邻居洞留到下次翻页（0/8 命中、4 次/页）。 - 新增每页 in-flight 去重（g_req_inflight）：请求被 worker 取走后不再被窗口刷新重排， 这是重复解码/挤掉邻居的根因之一。 - 高档落位后按最近一次翻页方向补回邻居（sharpen_refill）；反方向不补（3MB 常驻 上限下放不下，必然再被挤掉）。 - 真机几何探针（480×720，1280×2275 JPEG，8 次 700ms/页）：0/8→8/8 命中， 4→1.5 次解码/页。B8 顺序 100 页：100/100 命中、149 次解码（1.49/页）。 P2-1：B8 改成 101 页册顺序前翻 100 次（每页都是不同的下一页），4MP/12MP 夹具 真正成为焦点页；断言最后一页=100、命中率 ≥90%、解码 ≤2/页+余量。 P2-2：B10 去掉恒真的 slot_kb 比较，改断言「总常驻不增加」+「高档操作增量 ≤3MB」+ 「两档共存绝对峰值有界」；补双击放大后换清晰不重置缩放/平移、条漫滚动位置不变。 P2-3：B10 整串生命周期解码次数 ≤12（实测 7）；B8 解码次数上限。 夹具用硬链接（同文件系统），避免多页册真拷贝几百 MB。 顺带：MR_SHARPEN_MS 200→150（任务允许 150–300ms，给「换清晰→补邻居」留翻页余量）； 新增宿主观察口 flip_hits/misses、zoom/pan/woff（只读）。
90 lines
5.6 KiB
C
90 lines
5.6 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
|
||
|
||
/* 两级清晰度档位（M31）：低档=先上屏的过渡图，高档=停稳后替换的目标档位。
|
||
* 同时供宿主测试断言槽内档位用（mr_reader_ui_slot_tier / mr_reader_ui_focus_tier）。 */
|
||
#define MR_TIER_LOW 0
|
||
#define MR_TIER_HIGH 1
|
||
|
||
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_skipped_pages(void);/* 被内存预算跳过（可重试）的页数 */
|
||
/* 注入 /proc/meminfo 读数（kB）；-1 = 恢复真实读取。用于确定性验证内存门控与放宽档。 */
|
||
void mr_reader_ui_test_set_mem(long free_kb, long avail_kb);
|
||
/* 峰值模型自检：用产品代码里的同一个模型算预估峰值（kB），供宿主测试与 --wrap malloc
|
||
* 实测对照。0=探测失败。 */
|
||
long long mr_reader_ui_decode_peak_kb(const char *path, int step, int box_w, int box_h);
|
||
long mr_reader_ui_peak_cap_kb(void); /* 常态峰值上限（kB） */
|
||
long mr_reader_ui_peak_budget_kb(void); /* 当前 MemFree 下的实际预算（kB） */
|
||
long mr_reader_ui_resident_cap_kb(void); /* 常驻上限（kB） */
|
||
int mr_reader_ui_blit_draws(void); /* 累计原生 blit 绘页次数（热路径应为纯 blit） */
|
||
int mr_reader_ui_scaled_draws(void);/* 累计重采样绘页次数（每帧重采样=卡顿） */
|
||
int mr_reader_ui_decode_count(void);/* 累计解码次数（查重解抖动/活锁） */
|
||
/* ---- M31 两级清晰度（先低档秒出，停稳再换档）---- */
|
||
int mr_reader_ui_focus_tier(void); /* 焦点页档位：-1=无图，0=低档过渡图，1=目标档位 */
|
||
int mr_reader_ui_slot_tier(int idx);/* 指定页档位：-1=不在槽内，否则同上 */
|
||
long mr_reader_ui_slot_kb(int idx); /* 指定槽内页图的常驻字节（KB）；0=不在槽内 */
|
||
int mr_reader_ui_low_decodes(void); /* 低档解码次数 */
|
||
int mr_reader_ui_high_decodes(void);/* 目标档位解码次数 */
|
||
int mr_reader_ui_high_canceled(void);/* 被取消（拖动/换页/未停稳）的高档请求数 */
|
||
int mr_reader_ui_sharpen_idx(void); /* 当前允许升级的页；-1=拖动/未停稳/无需升级 */
|
||
int mr_reader_ui_flip_hits(void); /* 翻页时目标页已在槽（预取命中，不用等解码）次数 */
|
||
int mr_reader_ui_flip_misses(void); /* 翻页时目标页还没解好（要等解码）次数 */
|
||
int mr_reader_ui_zoom_pct(void); /* 当前缩放档（100=未放大） */
|
||
int mr_reader_ui_pan_x(void); /* 当前平移（px） */
|
||
int mr_reader_ui_pan_y(void);
|
||
int mr_reader_ui_woff(void); /* 条漫滚动偏移（px） */
|
||
/* 改写「停稳」窗口（默认 MR_SHARPEN_MS=150ms）：0=立刻允许高档，很大=冻结高档。 */
|
||
void mr_reader_ui_test_set_sharpen_ms(int ms);
|
||
/* 绕过停稳判定强排一个「换清晰」请求（验证拖动中会被 M22 的取消通道作废）。 */
|
||
void mr_reader_ui_test_queue_high(int idx);
|
||
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 */
|