# P6.5：1.21.11 主菜单 GLES 像素差异诊断

**状态：正式设备矩阵仍记 FAIL；独立主机负控已复现同位置缺失，强烈支持 trace 不满足目标 GPU 的 UBO 对齐要求；相同 APK 的设备本地对照仍待补。**
本记录不修改源码、trace fixture、golden 或 SSIM 阈值，也不把该失败归入既有 Vulkan 债务。

## 正式失败与可比阳性

| 对照 | 结果 | SSIM / 阈值 | 用时 | 实际 arming |
|---|---|---|---|---|
| Linux client → Android/Adreno TCP+stream，credit=2 | FAIL，完成回放后图像不符 | 0.890161090 / 0.99 | 272.684 s | ARMED，无 lockstep/DISARMED |
| WSL 同 ABI/驱动 TCP+stream loopback，credit=2 | PASS | 0.993474922 / 0.99 | 14.018 s | ARMED，无 lockstep/DISARMED |

两次目标 call 均为 `205347`，分辨率 `854×480`。正式失败的 `statusCode=6`、
`returncode=1`、`timeout_kind=null`，不是 watchdog 超时；其 mismatchPixels 为 79,246。
客户端和服务端没有 `Fatal{`、device loss、Refuse 或握手失败证据。客户端完成 38,884 次 reply wait；
服务端最后一帧计 11,551 draws。没有遗留进程。

目视检查可见背景、标题与文字仍在，主要缺失 Singleplayer、Multiplayer、Realms、Options、Quit
的灰色按钮底图，以及语言/右侧辅助功能按钮的图标或底图。loopback 中这些元素正常。
图中 Mali/Tensor 文字属于捕获的游戏画面，不能据此判定当前服务端 GPU；实际服务端日志为 Adreno。

正式 attempt：
`/home/swung/p65-final-matrix-gles/DirectGLES/credit-2/minecraft-1.21.11-main-menu/attempt-a1c1263d9b814620b04ff4c8b8d6cbf1`。
原始结果、图像和角色日志位于其 `work/output/`，golden 副本位于 `artifacts/`。
loopback 证据索引为 `/home/swung/p65-mainmenu-loopback-control/control-summary.json`。
该索引记录主机 library SHA256 为
`25ca45d756bc5a4e5bd56ad4ce231e4ef89d45ba41131f389575cda0842cd6be`。
仅 loopback 阳性还不能单独区分 ABI/wire 与设备驱动差异。

## 只读 trace 与源码证据

设备 `mobilegl.server.log:145` 及 `:358` 报告
`GL_UNIFORM_BUFFER_OFFSET_ALIGNMENT: 32`（SSBO 为 64）。
trace 的 UBO offset 有 16 字节粒度，但未找到录制时 alignment 查询值；不能声称捕获日志明确报告 16。

`MobileGL/MG_Impl/GLImpl/Buffer/GL_Buffer.cpp:1553` 的
`ValidateBufferRangeOffsetAndSize` 查询当前 context 的 alignment；`:1580` 判断 offset 整除性，
不符合时记录 `InvalidValue` 并返回 false。`:1627` 在 `TouchBufferBindingPoint` 和修改绑定之前返回，
因此保留之前合法的 buffer/range。远端 client 采用远端能力，不能用 WSL 原生 GPU 的较小对齐要求解释该分支。

`MobileGL/MG_State/GLState/ErrorState/Error.cpp:20` 仅以 `MGLOG_D` 打印 GL error。
现有 INFO 日志没有逐次 `RecordError` 文本；下列“应被拒绝”是调用参数加现行代码得到的预测，
不是声称已有逐 call 动态错误日志。

完整只读 `apitrace dump` 中有 14,149 次 `glBindBufferRange`，没有 `glBindBuffersRange`。
其中 **3,878** 次满足 `target=GL_UNIFORM_BUFFER && offset % 32 != 0`，首 call `9683`，
末 call `205116`；全部发生在 program 158（2,808 次）或 program 15（1,070 次）。
program 158/15 的 uniform block 0 都映射到 UBO binding 0（call `6734`/`6661`）。

这两个 program 的顶点 shader 13（call `6651`）明确声明 `SpriteAnimationInfo`，内含
`ProjectionMatrix`、`SpriteMatrix`、`UPadding`、`VPadding`、`MipMapLevel`，并计算
`gl_Position = ProjectionMatrix * SpriteMatrix * vec4(positions[index], 0, 1)`。
program 158 的 fragment shader 157（call `6727`）通过 `textureLod(Sprite, texCoord0, MipMapLevel)`
填充 sprite；program 15 通过两个 sprite 采样做动画插值。由此可将不合对齐的绑定定位到 atlas 生成，
而非笼统归因于最终主菜单 draw。

与缺失按钮直接相关的调用链如下：

| call | 事实 |
|---|---|
| `80415` | FBO 16 的 COLOR_ATTACHMENT0 设为 texture 868，后续 viewport 1024×1024 |
| `80426`, `80428` | UBO buffer 44 / offset 0 / size 140，随后 atlas draw |
| `80434`, `80436` | UBO buffer 44 / offset 144 / size 140（不满足 32），随后 atlas draw |
| `80442`, `80444` | UBO buffer 44 / offset 288 / size 140，随后 atlas draw |
| `205215`, `205221` | program 181 采样 texture 868，DrawElementsBaseVertex count 90 / basevertex 4 |
| `205254`, `205262` | program 181 再采样 texture 868，count 12 / basevertex 68 |

FBO 16 一共 607 次 atlas draw，其中 286 次前置 UBO bind 不满足 32 字节对齐；
该 FBO 最后一次不合对齐绑定为 `197198`（buffer 43 / offset 144 / size 144）。
最终 GUI program 181 使用的 UBO offset 是 0 或 160，本身满足 32。
它的 fragment shader 27 对 `texture(Sampler0, texCoord0)` 的零 alpha 执行 discard。

**获得独立负控支持的机制：** atlas 生成时，非法绑定保留旧 `SpriteMatrix`，新 sprite 仍写入旧区域，目标格留空或错误；
最终 GUI 从 texture 868 采样时因零 alpha 丢弃，从而出现按钮文字正常、底图/图标缺失。
下面的 blob/UV 对应进一步把缺失区域映射到具体 atlas draw。独立负控已复现主要视觉缺陷，
与设备失败图 SSIM 为 0.9987292763；这不声称两个驱动的全部像素完全一致。

只读 `apitrace dump --blobs --calls=80413,205170,205177` 把诊断副本写到
`/tmp/p65-mainmenu-blobs-ub31dw3f`。`80413` 为 buffer 44 的 69,264 字节初始化内容，
每个 `SpriteAnimationInfo` record 以 144 字节步进；`205170`/`205177` 分别是最终 buffer 39
中 15 个按钮底图 quad 和两个图标 quad 的顶点内容（每顶点 24 字节）。
将顶点 UV 乘 atlas 尺寸 1024，再与 UBO 内的 SpriteMatrix 比较，得到：

| GUI 元素 / 最终采样像素区域 | buffer 44 record / atlas 矩形 | 生成调用与对齐 |
|---|---|---|
| 15 个底图 quad，包括三行主按钮及底部四个按钮切片；x=723…923, y=1…21 | record 279，矩形 (722, 0, 202, 22) | bind `82658` offset=40176，余数 16；draw `82660`，源 texture 1168 |
| 语言图标；x=659…674, y=122…137 | record 125，矩形 (658, 121, 17, 17) | bind `81426` offset=18000，余数 16；draw `81428`，源 texture 1014 |
| 右侧辅助功能图标；x=659…674, y=88…103 | record 148，矩形 (658, 87, 17, 17) | bind `81610` offset=21312 合法；draw `81612` 后紧跟 record 149 |

record 149 原定矩形为 (658, 155, 17, 17)，bind `81618` offset=21456 余数 16，
draw `81620` 的源 texture 1038。如果该 bind 被拒绝，它沿用 record 148 的合法矩阵，
因而会覆盖右侧图标刚生成的位置。按钮背景被拒绝时沿用 record 278 的矩形 (376, 194, 22, 22)，
语言图标则沿用 record 124 的矩形 (610, 287, 18, 18)，都不是最终 GUI 预期采样的区域。

## 独立控制与证据边界

原 trace 的同 ABI TCP loopback 已通过。独立代理根据
`/home/swung/p65-mainmenu-ubo32-rejected-calls.json` 的 3,878 个 call 编号，
仅在临时 trace 副本中移除这些本应被设备 client 拒绝的绑定，保留对应 draw，然后做主机 TCP 负控。
该主机结果复现了设备的按钮矩形、语言按钮和右侧图标缺失。

| 图像比较 | 全图 RGB SSIM | 对原 golden 的判断 |
|---|---:|---|
| 原 trace 主机 loopback vs 原 golden | 0.9934749217 | PASS |
| 原 trace 设备 TCP vs 原 golden | 0.8901610899 | FAIL |
| 临时删绑定 trace 主机 TCP vs 原 golden | 0.8892457298 | FAIL；仅诊断负控 |
| 临时删绑定 trace 主机 TCP vs 原 trace 设备 TCP | 0.9987292763 | 比较两张失败图，不是 golden 验收 |

比较使用项目 `trace_replay_core.cpp` 的全图 RGB SSIM（C1=6.5025、C2=58.5225），
不 crop、忽略 alpha，且已校验原设备和原 loopback 的 runner 结果。四张图像的路径与 SHA256
均保存在 `/home/swung/p65-mainmenu-ubo32-diagnostic/comparison-summary.json`。

处理过程和逐 call 验证保存在
`/home/swung/p65-mainmenu-ubo32-diagnostic/preparation-summary.json`。
安装的 apitrace 14.0 不支持 `--exact`；实际使用显式保留 call 补集的
`trim --calls=@keep-calls.txt`，并核实该版本直接写出所选调用，没有增加依赖闭包。
随后完整 dump 两份 trace，逐项比较所有保留调用的顺序、thread、参数和每个 blob 的 SHA；
仅规范化 call 编号前缀和 blob 文件名，确认除名单中的 3,878 个绑定之外没有变化，headers 也一致。
原 trace 共 205,348 个 call，临时 trace 共 201,470 个，最后的 `eglSwapBuffers` 从
`205347` 重编号为 `201469`。临时 trace SHA256 为
`92e47f93ddcb7b5f3eaece05229fa8980e92adc5d24bbff3d6fe1c1b948ef6b4`。

同目录 `replay-summary.json` 记录负控用时 12.188 秒、returncode=6，实际 ARMED，
无 lockstep/DISARMED，双角色均为 TCP+stream 且 Fatal=0；结束后 supervisor 正常停止、
state 移除且端口释放。该负控使用与原 loopback 相同 SHA256 的主机库。
`apitrace-tool-evidence.json` 保留版本和 `--exact` 不支持的实际输出，`README.md` 汇总复现步骤。
原 trace 与 golden 在负控回放后重新计算 SHA256，确认均未改变。

这一负控、远端 alignment=32、frontend 拒绝路径以及精确 UV 对应共同强烈支持
**捕获 trace 对目标 GPU 的 UBO 对齐有效性问题**。它是独立于原设备 TCP 回放的机制复现，
不能把修改后的 trace 当作正式 GLES 阳性，也不能将正式 case 改记 PASS。
**相同 APK/后端的设备本地 inproc/spawn 原 trace 对照尚未执行**；需待正式设备矩阵释放设备后再补，
本记录没有将它写成已完成，也不把负控宣称为完全排除所有跨机器差异。

原 trace 保持不动，SHA256：
`7abd871cce098e93dd15a5e799fdfe093d9c85784716b00fd97c94833b8b83af`。
原 golden SHA256：`ea8db1c1c1414d3b564d65b1559a708277417b06895900bc947644d2f658bb86`。

两条 `GL_STENCIL_INDEX8` NormalizePixelFormat ERROR 及 layered-blit 探测 warning 也见于通过的
1.21.4 startup/main-menu，因此不把它们单独作为此失败原因。历史 P4a 的 1.21.11 depth-sampler
失败有独立的 sampler refusal 证据，现日志没有同一 refusal；不能把旧原因直接套用到本次。