# S-24F · F4 读数（draw calls / triangles / 帧率）

> 本机渲染环境：**Headless Chromium + SwiftShader 软件渲染**
> （`ANGLE (Google, Vulkan 1.3.0 (SwiftShader Device (Subzero) (0x0000C0DE)), SwiftShader driver)`）。
> ⇒ **软件渲染的数字不是真机帧率**，55fps 这类手感红线在 SwiftShader 上不可达（0.3.3 平常态基线也只有 53.7）；
> 真机帧率结论**以老板验收为准**，这里的数字只用于「同机前后对比 / 有无退化」。
> 构建指纹与跑测时刻见 `logs/seal-fingerprint.txt`，每套日志首行都写了 bundle + mtime + md5。

## 1. 三档几何读数（`info()`，390×844，`?debug=1` 内部包）

| 档位 | height | t | framing (scale/dy) | draw calls | triangles | materials | 备注 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| peek | 60 | 0.000 | 1.000 / 0.000 | 46 | 43,481（info 口径 46,638） | 19 | 与 0.3.3 平常态相当 |
| 半拖 50%（held） | 220 | 0.250 | 1.195 / −0.030 | 47 | 49,322 | 19 | 拉开途中，世界按 framing 拉近/下移 |
| half（松手吸附） | 380 | 0.500 | 1.390 / −0.060 | 46–47 | 49,320–49,322 | 19 | 契约锚点 |
| full | 743 | 1.000 | 1.820 / −0.385 | 49–50 | 57,776–57,778 | 19 | 视野最大 ⇒ 三角形最多 |
| 聚焦建筑（half） | 380 | 0.500 | 1.390 / −0.060 | 46 | 40,341 | 19 | 相机拉近单栋楼，视锥内更少 |
| 经典模式对照 | 380 | – | 1.000 / 0.000 | 47 | 49,408 | 19 | 同页切 `setHudMode('classic')`（hm033 同款 HUD） |
| 320×568 half | 256 | 0.500 | 1.390 / −0.060 | 48 | 51,897 | 19 | 极窄屏 |
| 320×568 full | 500 | 1.000 | 1.820 / −0.385 | 50 | 57,778 | 19 | 极窄屏 |

交叉核对（Lead 报的 ≈48 calls / 51,897 tri）：与我方 320×568 half 档一致；390×844 各档见上表。

## 2. 与基线对比（同一台机器、同为 SwiftShader）

| 项 | 0.3.3 基线（hm033 `evidence/perf.json`） | 0.3.4 抽屉前（hm034 `evidence/perf.json`，01:27 记录） | 本轮封版（抽屉模式） |
| --- | --- | --- | --- |
| draw calls | 44 | 44 | 46–50（随档位；见 §1） |
| triangles | 46,159 | 46,159 | 43,481–57,778（随档位；peek 最省、full 最多） |
| materials | 19 | 19 | 19（**不变**，无新增材质） |
| fpsSwiftShader | 53.7 | 29.5 | 见 §3（软件渲染，仅作同机对比） |

结论：
- **材质数 19 三档恒定**，抽屉化没有引入新材质/新贴图；
- 三角形与 draw calls 随 framing 变化是**预期**（framing 拉远 ⇒ 视野里世界更多；聚焦单楼 ⇒ 更少），不是泄漏；
- 抽屉自身的覆盖层（面板/文字/把手）全部画在同一张 canvas 2D 覆盖层上，不增加 WebGL 材质。

## 3. 三档渲染预算（封版 `info()` 完整读数，390×844，`?debug=1`，lowFx=true）

| 档位 | draw calls | triangles | geometries | textures | programs | materials |
| --- | --- | --- | --- | --- | --- | --- |
| peek | 46 | 46,638 | 39 | 14 | 11 | 19 |
| half | 46 | 49,320 | 39 | 14 | 11 | 19 |
| full | 49 | 57,776 | 39 | 14 | 11 | 19 |

⇒ **geometries / textures / programs / materials 三档完全一致**（39/14/11/19），只有 calls 与 triangles 随取景变化；
抽屉覆盖层是 canvas 2D，不进 WebGL 预算。

## 4. 拖动帧率（80 步 peek→full，页面内 rAF 计时）

> 原始数据：`logs/seal-t-drawer-fps.log` + `logs/fps-readings.json`。
> **安静窗口**：02:16 起（Team Lead 确认我方是唯一浏览器），跑前 loadavg **11.34 23.34 27.38**、跑后 **12.94 22.93 27.15**
>（机器上另有常驻 qemu/VM 等背景负载，非纯空机 ⇒ 读数偏保守）。
> 方法：page 内 `pointerdown` 落把手 → 每帧 1 次 `pointermove` 连续拉高 **80 步** → `pointerup`；
> 用页面 `requestAnimationFrame` 时间戳算帧间隔；同页静止基线（peek 静止 / full 静止）各采 90 帧对比。

| 项 | 拖动片段 | peek 静止基线 | full 静止基线（同画面最重档） |
| --- | --- | --- | --- |
| rAF 帧数 | **79 帧**（80 步，末帧即松手） | 89 | 89 |
| avg fps | **33.4** | 42.4 | 31.6 |
| mean 帧间隔 | 29.96ms | 23.6ms | 31.65ms |
| p50 / p95 帧间隔 | 33.3 / 33.4ms | – / – | 33.3 / **50ms** |
| >100ms 长帧 | 0 | 0 | 0 |

判定：
- `FPS-NOREGRESS`（封版通过口径）：拖动 mean 29.96ms vs full 静止 31.65ms ⇒ **劣化 −5.3%**（限 ≤+35%）、p95 33.4ms ≤ 33.4ms ⇒ **PASS**
- `FPS-P95-REL`（相对判据）：拖动 p95 / full 静止 p95 = **0.67×**（限 ≤1.35×）⇒ **PASS**（拖动没有额外制造长帧，full 静止反而有 50ms 的 p95）
- `FPS-PROGRESS`：高度 [128.3 → 743] 单调不减、松手吸附 full（743）、t=1 ⇒ **PASS**
- `FPS-SPIKES`：长帧 0 个 ⇒ **PASS**
- `FPS-MAIN`（55fps 红线）：**FAIL**，实测 33.4fps ⇒ **红因 = SwiftShader 软件渲染上限，不是产品回归**。
  参照：**0.3.3 在同机同软渲染下平常态基线也只有 53.7fps**（`frontend-rebuild-hm033/evidence/perf.json`，测量方法同为 headless Chromium + SwiftShader + rAF 帧间隔）⇒ **退回 0.3.3 也不会更快**，55fps 只能上真机验。

> ⚠️ **明确声明：本机是 SwiftShader 软件渲染（renderer=`ANGLE (Google, Vulkan 1.3.0 (SwiftShader Device (Subzero)), SwiftShader driver)`），
> 上表所有 fps 数字都不是真机帧率，不构成「55fps 达标」的结论；真机帧率以老板验收为准。**
> 可用 `F4_FPS_MIN=<阈值> node test/t-drawer-fps.mjs` 在真机/有线设备上按同一判据复跑。

## 5. 复现命令

```bash
export PATH=/mnt/ssd/apps/nodejs_v24/bin:$PATH
cd /vol1/ai/projects/wyszz-new/frontend-rebuild-hm034
node test/t-drawer-fps.mjs        # 拖动 80~100 帧 rAF + 静止基线 + calls/triangles
node test/t-drawer-shots.mjs      # 8 张证据图 + shots/readings.json（含三档 info 读数）
```
