fix(ncm): 列表首行标题不显示 — 行高按字体行高派生（M12）
根因（真机 seated，非数据/颜色/遮挡）：SDK meow_listview 双行渲染把 「2*行高 + 2」的文本块在行内垂直居中，且标题只在 ty >= 视口顶时才画 （meow_ui_widget.c:2061 的越界守卫）。真机 source_han_serif 20px 面 ascent 24 + descent 6 → 行高 30 → 文本块 62px，而 ncm 行高 APP_ROW_H=56 → ty = 行顶 - 3；首行行顶 == 视口顶 → ty < 视口顶 → 标题被整条跳过， 副标题（ty+32）仍在视口内照画。两类列表同用该路径 + 同一行高，故症状一致。 修复（不动 SDK）：ncm_app_internal.h 新增 ncm_row_h()/ncm_row_h_for_line_h()， 行高 = max(56, 2*字体行高 + 2 + 8)（偶数；本机 30 → 70，卡高 62 == 文本块）； home/playlist/queue/cache/search 在 page create 取一次 g_item_h，统一用于 set_item_h 与卡片几何/可见行/页脚/补载视口换算。 回归： - app/test/test_meow_row_text_fit.c（新）：真机字库行高矩阵 14/21/26/27/30 48 断言（文本块 ≤ 行高、首行 ty ≥ 0、卡高 ≥ 文本块、旧 56 哨兵）。 - app/test/test_first_row_title_render.c（新）：--wrap 行高=30 驱动真实 SDK 渲染 + 读回 PPM 像素计数：旧 56 → 首行标题 0 像素/副标题 186；新 70 → 标题 84/副标题 100。 - test_meow_row_gap、plpage_sim 全 PASS；ncm_host 7 页出图与改动前逐字节相同 （宿主行高 14 → 行高仍 56，证重构无视觉回归）；5 页自检 PASS；0 warning。 - plpage_sim 临时目录改 $TMPDIR（Termux /tmp 不可写，原写死无法运行）。 - REPORT §43：根因/排除方向/修复/验证/真机验收要点。
This commit is contained in:
AskaEth committed
1 parent
98b9169b86
commit
22f9dab2ce
11 files changed
+440
-34
No files matched your search
@@ -0,0 +1,174 @@
|
||||
/* app/test/test_first_row_title_render.c — 宿主渲染回归（M12）：列表首行标题必须真正画出来。
|
||||
*
|
||||
* 目的：在宿主上用**真实 SDK listview 双行渲染**复现/验证真机根因，而不只是验几何公式。
|
||||
* 真机字体（source_han_serif 20px，font.idx: ascent 24 + descent 6）行高 = 30，
|
||||
* 双行文本块 = 2*30 + 2 = 62。旧固定行高 56 < 62 → SDK 的 2 行分支
|
||||
* ty = 行顶 + (item - block)/2 = 行顶 - 3
|
||||
* 而标题只在 `ty >= 视口顶` 时才画 → 第一行（行顶 == 视口顶）标题被整条跳过、副标题仍在。
|
||||
*
|
||||
* 宿主 5x7 字体的行高是 14（gfx 回退），照原样渲染永远复现不了。故用链接期
|
||||
* `-Wl,--wrap=meow_ui_text_height` 把行高替换成真机实测的 30，驱动同一份 SDK 代码：
|
||||
* A 旧行高 56 → 首行标题带无文字像素（bug 形态）
|
||||
* B ncm_row_h_for_line_h(30) = 70 → 首行标题带/副标题带都有文字像素（修复形态）
|
||||
* 断言直接读回 MEOW_UI_DUMP 写出的 PPM（按像素计数）。
|
||||
*
|
||||
* 编译/运行（先跑 build_ncm_host.sh 产出 out/host/sdk_*.o）：
|
||||
* gcc -O2 -Wall -Wextra -DMEOW_UI_HOST_TEST -DJSMN_HEADER -I. -I../sdk -I../meow_launcherd \
|
||||
* -Icore -Ivendor/jsmn -Ivendor/mbedtls/include -Ivendor/minimp3 -Ivendor/dr_flac \
|
||||
* app/test/test_first_row_title_render.c out/host/sdk_*.o \
|
||||
* -Wl,--wrap=meow_ui_text_height -lz -lpthread -lm -o test_first_row_title_render
|
||||
* ./test_first_row_title_render # 产物落 $TMPDIR/first_row_*.ppm
|
||||
*
|
||||
* 断言：
|
||||
* ① 行高替换生效（meow_ui_text_height(20) == 30）；
|
||||
* ② A：首行标题带零文字像素、副标题带有 → 复现「只有副标题」；
|
||||
* ③ B：首行标题带与副标题带都有像素 → 修复后首行标题正常；
|
||||
* ④ A/B 副标题带像素数都不为 0（副标题路径未受影响）。
|
||||
*/
|
||||
#include "../ncm_app_internal.h"
|
||||
#include <stdio.h>
|
||||
#include <stdlib.h>
|
||||
#include <string.h>
|
||||
#include <unistd.h>
|
||||
|
||||
/* --wrap 的替换实现：真机 source_han_serif 20px 实测行高（font.idx ascent+descent）。 */
|
||||
int __wrap_meow_ui_text_height(int size)
|
||||
{
|
||||
(void)size;
|
||||
return 30;
|
||||
}
|
||||
|
||||
#define LV_X 16
|
||||
#define LV_Y 40
|
||||
#define LV_W 448
|
||||
#define LV_H 300
|
||||
|
||||
static int src2(int idx, meow_list_item *out, void *ctx)
|
||||
{
|
||||
(void)ctx;
|
||||
static char title[32], sub[32];
|
||||
if (idx < 0 || idx >= 5) return 0;
|
||||
snprintf(title, sizeof title, "T%d", idx + 1);
|
||||
snprintf(sub, sizeof sub, "S%d", idx + 1);
|
||||
memset(out, 0, sizeof *out);
|
||||
out->icon_kind = MEOW_LIST_ICON_NONE;
|
||||
out->title = title;
|
||||
out->subtitle = sub;
|
||||
out->right = MEOW_LIST_RIGHT_NONE;
|
||||
out->enabled = 1;
|
||||
return 1;
|
||||
}
|
||||
|
||||
/* ---- 极简 PPM(P6) 读取 + 区域文字像素计数 ---- */
|
||||
static unsigned char *ppm_load(const char *path, int *w, int *h)
|
||||
{
|
||||
FILE *f = fopen(path, "rb");
|
||||
if (!f) { fprintf(stderr, "open %s failed\n", path); return NULL; }
|
||||
char magic[3] = {0};
|
||||
int maxv = 0;
|
||||
if (fscanf(f, "%2s %d %d %d", magic, w, h, &maxv) != 4 ||
|
||||
strcmp(magic, "P6") != 0 || *w <= 0 || *h <= 0) {
|
||||
fclose(f); fprintf(stderr, "bad ppm %s\n", path); return NULL;
|
||||
}
|
||||
if (fgetc(f) < 0) { fclose(f); fprintf(stderr, "truncated ppm %s\n", path); return NULL; } /* 单个空白 */
|
||||
size_t n = (size_t)*w * (size_t)*h * 3u;
|
||||
unsigned char *buf = (unsigned char *)malloc(n);
|
||||
if (!buf || fread(buf, 1, n, f) != n) { free(buf); fclose(f); return NULL; }
|
||||
fclose(f);
|
||||
return buf;
|
||||
}
|
||||
|
||||
/* 区域内「与页底色不同」的像素数。页底色取 (470,700)（远离列表控件）。 */
|
||||
static int ink_count(const unsigned char *img, int w, int x0, int y0, int x1, int y1)
|
||||
{
|
||||
const unsigned char *bg = img + ((size_t)700 * (size_t)w + 470u) * 3u;
|
||||
int n = 0;
|
||||
for (int y = y0; y < y1; y++)
|
||||
for (int x = x0; x < x1; x++) {
|
||||
const unsigned char *p = img + ((size_t)y * (size_t)w + (size_t)x) * 3u;
|
||||
int d = abs((int)p[0] - (int)bg[0]) + abs((int)p[1] - (int)bg[1]) +
|
||||
abs((int)p[2] - (int)bg[2]);
|
||||
if (d > 24) n++;
|
||||
}
|
||||
return n;
|
||||
}
|
||||
|
||||
/* 造一个双行列表（容器=关、无图标/右尾件）并整帧绘制（paint_full 内部 flush → dump PPM）。 */
|
||||
static void render_once(int item)
|
||||
{
|
||||
meow_widget *lv = meow_listview_create(LV_X, LV_Y, LV_W, LV_H, 5,
|
||||
src2, NULL, MEOW_LIST_SEL_NONE);
|
||||
meow_listview_set_container(lv, 0);
|
||||
meow_listview_set_item_renderer(lv, 2, 0, 0);
|
||||
meow_listview_set_item_h(lv, item);
|
||||
meow_listview_set_count(lv, 5);
|
||||
meow_ui_set_page_bg(meow_theme_get()->bg);
|
||||
meow_ui_paint_full(); /* 画 + meow_ui_flush → MEOW_UI_DUMP 落 PPM */
|
||||
meow_widget_free(lv);
|
||||
}
|
||||
|
||||
static char g_dump[256];
|
||||
|
||||
int main(void)
|
||||
{
|
||||
const char *td = getenv("TMPDIR");
|
||||
if (!td || !td[0]) td = "/tmp";
|
||||
snprintf(g_dump, sizeof g_dump, "%s/first_row.ppm", td);
|
||||
setenv("MEOW_UI_DUMP", g_dump, 1);
|
||||
|
||||
meow_ui_opts o = { APP_W, APP_H };
|
||||
if (meow_ui_init(&o) != 0) { fprintf(stderr, "init failed\n"); return 1; }
|
||||
meow_theme_set_mode(MEOW_THEME_DARK);
|
||||
|
||||
int fail = 0;
|
||||
if (meow_ui_text_height(20) != 30) {
|
||||
printf(" FAIL 行高替换未生效（expected 30，got %d）\n", meow_ui_text_height(20));
|
||||
fail = 1;
|
||||
}
|
||||
|
||||
const int lh = 30;
|
||||
const int block = 2 * lh + NCM_ROW_SUB_GAP; /* 62 */
|
||||
const int fixed = ncm_row_h_for_line_h(lh); /* 70 */
|
||||
const int ty_legacy = (APP_ROW_H - block) / 2; /* -3 */
|
||||
const int ty_fixed = (fixed - block) / 2; /* +4 */
|
||||
|
||||
int n_title_a = 0, n_sub_a = 0, n_title_b = 0, n_sub_b = 0;
|
||||
|
||||
/* A：旧固定行高 56（bug 形态）。标题带取「文本行顶 ∩ 控件视口」（ty<0 时从 0 起），
|
||||
* 这样「被裁剪守卫整条跳过」与「只画出上半截」也能区分开。 */
|
||||
render_once(APP_ROW_H);
|
||||
{
|
||||
int pw = 0, ph = 0;
|
||||
unsigned char *img = ppm_load(g_dump, &pw, &ph);
|
||||
if (!img) return 1;
|
||||
int ty0 = (ty_legacy > 0) ? ty_legacy : 0;
|
||||
n_title_a = ink_count(img, pw, LV_X + 16, LV_Y + ty0,
|
||||
LV_X + 16 + 40, LV_Y + ty_legacy + lh);
|
||||
n_sub_a = ink_count(img, pw, LV_X + 16, LV_Y + ty_legacy + lh + NCM_ROW_SUB_GAP,
|
||||
LV_X + 16 + 40, LV_Y + ty_legacy + 2 * lh + NCM_ROW_SUB_GAP);
|
||||
free(img);
|
||||
}
|
||||
|
||||
/* B：修复后的行高（ncm_row_h_for_line_h） */
|
||||
render_once(fixed);
|
||||
{
|
||||
int pw = 0, ph = 0;
|
||||
unsigned char *img = ppm_load(g_dump, &pw, &ph);
|
||||
if (!img) return 1;
|
||||
n_title_b = ink_count(img, pw, LV_X + 16, LV_Y + ty_fixed,
|
||||
LV_X + 16 + 40, LV_Y + ty_fixed + lh);
|
||||
n_sub_b = ink_count(img, pw, LV_X + 16, LV_Y + ty_fixed + lh + NCM_ROW_SUB_GAP,
|
||||
LV_X + 16 + 40, LV_Y + ty_fixed + 2 * lh + NCM_ROW_SUB_GAP);
|
||||
free(img);
|
||||
}
|
||||
|
||||
printf("legacy item=%d ty=%d: title_ink=%d sub_ink=%d\n", APP_ROW_H, ty_legacy, n_title_a, n_sub_a);
|
||||
printf("fixed item=%d ty=%d: title_ink=%d sub_ink=%d\n", fixed, ty_fixed, n_title_b, n_sub_b);
|
||||
|
||||
if (!(n_title_a == 0 && n_sub_a > 0)) fail = 1; /* ② 旧行高首行标题被跳过（bug 复现） */
|
||||
if (!(n_title_b > 0 && n_sub_b > 0)) fail = 1; /* ③ 修复后首行标题/副标题都在 */
|
||||
|
||||
printf("%s: first-row title render (legacy skipped=%d, fixed drawn=%d)\n",
|
||||
fail ? "FAIL" : "PASS", n_title_a == 0, n_title_b > 0);
|
||||
return fail ? 1 : 0;
|
||||
}
|
||||
@@ -9,10 +9,12 @@
|
||||
* test_meow_row_gap.c -o test_meow_row_gap && ./test_meow_row_gap
|
||||
*
|
||||
* 断言集（对应「相邻 item 顶之间 = item 高 + gap」的可见形式）：
|
||||
* ① 相邻卡顶间距 = APP_ROW_H（= 卡高 + gap；SDK 行距不变）；
|
||||
* ① 相邻卡顶间距 = item 高（= 卡高 + gap；SDK 行距不变）；
|
||||
* ② 卡片间可见外距 = NCM_ROW_GAP；
|
||||
* ③ 卡在其行高内上下对称内缩 → SDK 文本（按 APP_ROW_H 垂直居中）落卡中心；
|
||||
* ③ 卡在其行高内上下对称内缩 → SDK 文本（按行高垂直居中）落卡中心；
|
||||
* ④ 滚动偏移只整体平移，不改变上述间距/对称。
|
||||
* 行高在这里固定用 APP_ROW_H（几何对任意 item 成立；M12 起真机行高由 ncm_row_h() 按字体
|
||||
* 行高派生，文本块必须装得下，见 test_meow_row_text_fit.c）。
|
||||
*/
|
||||
#include "../ncm_app_internal.h" /* APP_ROW_H / NCM_ROW_GAP / ncm_row_card_y / ncm_row_card_h */
|
||||
#include <stdio.h>
|
||||
@@ -20,7 +22,7 @@
|
||||
|
||||
int main(void)
|
||||
{
|
||||
const int item = APP_ROW_H; /* 行距（SDK listview item_h，不变） */
|
||||
const int item = APP_ROW_H; /* 几何取固定行高（对任意 item 成立） */
|
||||
const int gap = NCM_ROW_GAP;
|
||||
const int list_y = 100;
|
||||
|
||||
|
||||
@@ -0,0 +1,93 @@
|
||||
/* app/test/test_meow_row_text_fit.c — 宿主回归（M12）：两行列表行高必须容纳行文本块。
|
||||
*
|
||||
* 背景（真机根因）：SDK meow_listview 的双行渲染（sdk/meow_ui_widget.c 的 2 行分支）把
|
||||
* block = 2 * meow_ui_text_height(font_body) + 2 （标题行 + 2px 行距 + 副标题行）
|
||||
* 在行内垂直居中：ty = 行顶 + (item - block) / 2；且标题只在 `ty >= 视口顶` 时才画（越界钳制）。
|
||||
* 行高 item < block 时 ty < 行顶 → **第一行（行顶 == 视口顶）标题被整条跳过**、副标题仍在，
|
||||
* 即用户报的「歌单列表/歌曲列表第 1 行只有副标题，名字空白」。
|
||||
* 真机字库实测（source_han_serif 20px：ascent 24 + descent 6 → 行高 30）block = 62，旧固定
|
||||
* 行高 56 → ty = 行顶 - 3。
|
||||
*
|
||||
* 本测试只验 app 侧行高派生（ncm_row_h_for_line_h，纯整数、不链 SDK）：
|
||||
* 行高 = max(APP_ROW_H, block + NCM_ROW_GAP)（偶数）→ 卡高 == 文本块，文本完整落在卡内。
|
||||
*
|
||||
* 编译/运行（同 test_meow_row_gap.c，需仓库根 ROOT 下的 SDK 头）：
|
||||
* gcc -O2 -Wall -Wextra -I. -I../sdk -I../meow_launcherd -Icore \
|
||||
* -Ivendor/mbedtls/include -Ivendor/jsmn -Ivendor/qrcodegen/c \
|
||||
* -Ivendor/minimp3 -Ivendor/dr_flac \
|
||||
* test_meow_row_text_fit.c -o test_meow_row_text_fit && ./test_meow_row_text_fit
|
||||
*
|
||||
* 断言矩阵 = 真机已装字库 20px 面实测行高（font.idx 的 ascent+descent）：
|
||||
* source_han_serif 30（当前生效）、misans/default 27、google_sans/meslo 26、
|
||||
* source_han_sans 21；14 = 宿主 5x7 回退。逐项断言：
|
||||
* ① block ≤ item（否则居中偏移为负）
|
||||
* ② 首行 ty ≥ 行顶（绝对：ty_abs ≥ 视口顶）→ 标题不被裁剪守卫跳过
|
||||
* ③ 副标题底边 sy + 行高 ≤ item（副标题不越行）
|
||||
* ④ 卡高（item - NCM_ROW_GAP）≥ block（两行文本全落在圆角卡内）
|
||||
* ⑤ item ≥ APP_ROW_H 下限且为偶数（卡上下对称内缩 gap/2）
|
||||
* ⑥ 旧固定行高 56 在行高 30 下 ty < 0（bug 形态复现，防止再写死 56）
|
||||
*/
|
||||
#include "../ncm_app_internal.h"
|
||||
#include <stdio.h>
|
||||
|
||||
static int g_checks, g_fail;
|
||||
|
||||
static void chk(int cond, int line_h, const char *what)
|
||||
{
|
||||
g_checks++;
|
||||
if (!cond) {
|
||||
g_fail++;
|
||||
printf(" FAIL lh=%d: %s\n", line_h, what);
|
||||
}
|
||||
}
|
||||
|
||||
int main(void)
|
||||
{
|
||||
static const int lh_all[] = { 14, 21, 26, 27, 30 };
|
||||
const int n = (int)(sizeof lh_all / sizeof lh_all[0]);
|
||||
const int list_y = 120; /* 任意列表顶（只验相对几何） */
|
||||
|
||||
for (int k = 0; k < n; k++) {
|
||||
int lh = lh_all[k];
|
||||
int item = ncm_row_h_for_line_h(lh);
|
||||
int block = 2 * lh + NCM_ROW_SUB_GAP;
|
||||
int ty = (item - block) / 2; /* SDK 双行文本块居中偏移 */
|
||||
int sy = ty + lh + NCM_ROW_SUB_GAP; /* 副标题行顶 */
|
||||
int card_h = ncm_row_card_h(item);
|
||||
|
||||
printf("lh=%2d item=%3d block=%3d ty=%d sy=%d card_h=%3d\n",
|
||||
lh, item, block, ty, sy, card_h);
|
||||
|
||||
chk(block <= item, lh, "文本块必须 <= 行高（否则首行标题被视口顶裁剪）");
|
||||
chk(ty >= 0, lh, "首行标题 y 不得高于行顶/视口顶");
|
||||
chk(sy + lh <= item, lh, "副标题底边仍在行内");
|
||||
chk(card_h >= block, lh, "两行文本块必须完整落在圆角卡内");
|
||||
chk(item >= APP_ROW_H, lh, "行高不得小于 APP_ROW_H 下限");
|
||||
chk((item & 1) == 0, lh, "行高必须偶数（卡上下对称内缩 gap/2）");
|
||||
|
||||
/* 首行（scroll=0 → 行顶 == 视口顶）的绝对坐标 */
|
||||
int ty_abs = list_y + ty;
|
||||
chk(ty_abs >= list_y, lh, "首行标题绝对 y 不得被视口顶裁掉");
|
||||
chk(ty_abs + lh <= list_y + item, lh, "首行标题底边在行内");
|
||||
|
||||
/* 卡在行内对称 → 卡中心 == 行中心 */
|
||||
int cy = ncm_row_card_y(item, 0, 0, list_y);
|
||||
chk(cy + card_h / 2 == list_y + item / 2, lh, "卡中心 == 行中心");
|
||||
}
|
||||
|
||||
/* 行高随字体行高单调不减 */
|
||||
chk(ncm_row_h_for_line_h(30) >= ncm_row_h_for_line_h(26), 30, "行高随字体行高单调不减");
|
||||
|
||||
/* ⑥ 回归哨兵：旧固定行高 56 + 当前默认字体（行高 30）就是 bug 形态 */
|
||||
{
|
||||
const int lh = 30;
|
||||
int block = 2 * lh + NCM_ROW_SUB_GAP; /* 62 */
|
||||
int ty_legacy = (APP_ROW_H - block) / 2; /* -3 */
|
||||
chk(ty_legacy < 0, lh, "旧行高 56 + 行高 30 → ty<0（首行标题被跳过，bug 复现）");
|
||||
chk(ncm_row_h_for_line_h(lh) > APP_ROW_H, lh, "默认字体下行高必须大于旧值 56");
|
||||
}
|
||||
|
||||
printf("%s: %d checks, %d fail (font line-height matrix: %d)\n",
|
||||
g_fail ? "FAIL" : "PASS", g_checks, g_fail, n);
|
||||
return g_fail ? 1 : 0;
|
||||
}
|
||||
Reference in new issue
Block a user