feat(wayland-cursor): 客户端自己的鼠标指针 —— fork 的第六个也是最后一个成员

[Sunrisepeak]

Wayland 没有服务端光标:客户端要指针,就得自己加载主题、把图像变成 wl_buffer、附到交给 wl_pointer.set_cursor 的 surface 上。没有这个库,每个应用都得自己解析 XCursor 文件格式。

⚠ 不要和 compat.xcursor 搞混:那是 X11 的 libXcursor.so.1,要和 X 服务器说话。

配套 fork PR:mcpplibs/wayland#2(已合)。至此 fork 建齐了上游发布的每一个库,没有第七个。

又一处编译期宿主路径,同样置空

xcursor.c:493 写死 "~/.icons:/usr/share/icons:/usr/share/pixmaps:…" —— 重定位之后指的是宿主的主题。而 xcursor_library_path() 先读 getenv("XCURSOR_PATH") 且设置了就原样返回(xcursor.c:515),所以这是兜底不是唯一入口,和 LIBINPUT_QUIRKS_DIR / XKB_CONFIG_ROOT 完全对称。

fork CI 里 grep 二进制确认路径真没被编进去 —— 这条只能这么查,因为值错了的失败方式是在恰好有 /usr/share/icons 的机器上静默正常工作。

一份 tarball 六个条目,tag 仍未动

发 wayland-1.26.0-mcpp3.tar.gz 作为 release 资产,六个描述符在同一个提交里换指向。旧资产原样保留,没有任何窗口里 main 是坏的。

GLOBAL/CN  b95537b21b0df211…  1032352 bytes   逐字节一致

测试成员:第一版段错误了

我以为传 null wl_shm 只会跑到主题解析器。实际 wayland-cursor.c:410 的 shm_pool_create(shm, …) 直达 wl_shm_create_pool 并无保护解引用,exit 139。

wl_shm 只能来自合成器的 registry,所以这个库的 buffer 那半属于有合成器的程序 —— 正如打开 /dev/input/event* 不属于 tests/examples/libinput。

改成断言仍然承载打包风险的部分:

• 模块导出全部六个名字
• 两个公共结构能当值用 —— 不是不透明句柄。导出成不透明会在这里编过、在调用者第一个 image->hotspot_x 上炸,所以测试碰字段而不只是命名类型
• 真的链了 client(wl_shm_create_pool)—— 这正是 §3 的主题加载器需要活 wl_shm 的原因
• wl_cursor_frame 系列 —— 纯粹是 images 数组上的算术,无需 shm,是本测试唯一能跑的真实行为

13 项断言全过
wayland      2 passed; 0 failed     ← 新 tarball 上无退化
wayland-egl  1 passed; 0 failed