Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

docs(bench): the frame-share notes carry the corrected numbers

esengine45de38a423e7
diff --git a/bench/aot-stage0/README.md b/bench/aot-stage0/README.md
index 7ff8f5cb4..5d7f0c396 100644
--- a/bench/aot-stage0/README.md
+++ b/bench/aot-stage0/README.md
@@ -1,14 +1,14 @@
# Stage 0 — 编译系统循环,到底值不值
-`docs/REARCH_AOT.md` §10 把 Stage 0 定为 go/no-go,§11 写明它要退役的那条风险:
-**加速可能主要来自边界拷贝,而不是解释器**——而边界拷贝有个只花 5% 成本的修法(§12.B)。
+Stage 0 是这条线的 go/no-go,它要退役的风险是:
+**加速可能主要来自边界拷贝,而不是解释器**——而边界拷贝有个只花 5% 成本的 SDK 侧修法(下表的 B)。
一个只报一个数字的 benchmark 分不开这两者。所以这个装置把同一个系统跑四遍:
| 变体 | 是什么 |
|---|---|
| **A** | 今天的 SDK 路径 —— `fillTransform` → 系统体 → `writeTransform` |
-| **B** | 就地视图 —— 访问器直接落在组件字节上,不拷进也不回写(§12.B) |
+| **B** | 就地视图 —— 访问器直接落在组件字节上,不拷进也不回写 |
| **B2** | 裸下标 —— 解释执行的地板,完全没有对象层 |
| **C** | 原生 C++ —— AOT 的天花板 |
@@ -137,38 +137,51 @@ node bench/aot-stage0/frame-share-rendered.mjs
只开一侧「看起来像一个不花钱的引擎,而不是一个没被量的引擎」。缺的是 render host 上的
一扇门,不是一个 harness。
-| | ms/帧 |
-|---|---|
-| TS 系统 | 1.30(56.5%) |
-| C++ scope | 1.00(**c = 43.5%**) |
-| GPU | 4.07(设备的,编译脚本碰不到) |
+### 一个系统的 ms 里**包含**它调用的 C++
+
+这份装置最容易搞错的就是这一件事,第一版就错了。系统的 ms 是绕着函数体量的墙钟,而引擎的
+`ES_PROFILE_SCOPE` 跑在**它里面**——`submitScene` 是三次 wasm 调用,所以 `render.collect`
+与 `render.finalize` 都坐在 `RenderSystem` 的 1.58 ms 之内。把「系统合计」加上「native
+scope 合计」,就是把同一段时间数了两遍,并且记在 TypeScript 名下。
-`render.collect` 0.74 / `.finalize` 0.31 / `.graph` 0.04 / `.submit` 0.01。
+**一帧就是那些系统;TS 是把它们里面的 C++ 扣掉之后剩下的那部分。** 装置现在直接读 SDK 的
+`buildFrameProfile`——编辑器的 profiler 面板和导入的 capture 读的是同一个答案——不再自己
+推导第二遍。
+
+| | |
+|---|---|
+| `c`(C++ 占 CPU 帧) | **73.3%** |
+| 帧里最热的一项 | `render.collect` 0.63 ms —— **已经是 C++**,编译脚本碰不到它 |
### 不要用 Stage 0 的 396× 去乘整个 TS
-第一版这么干了,打印出 231×。**那是错的**:396× 是在组件字节上的数值循环量的(AOT 最好情形),
-而这里 94% 的 TS 是 `RenderSystem` —— draw 提交和过桥调用,不是算术。改用两个实测输入:
+396× 是在组件字节上的数值循环量的(AOT 最好情形),而这里 94% 的 TS 是 `RenderSystem`
+—— draw 提交和过桥调用,不是算术。改用两个实测输入:
- `K` = QuickJS/V8 在真实 SDK 代码上 = **12×**
-- 无 JIT 帧 = `K·TS + C++` = **16.6 ms CPU**,其中 TS 占 94%
+- 无 JIT 帧 = `K·TS + C++`
| 编译后的 TS | 帧加速 |
|---|---|
-| 只追平 JIT(下界) | **7.2×** |
-| 跑到原生速度(上界) | **16.0×** |
+| 只追平 JIT(下界) | **3.7×** |
+| 跑到原生速度(上界) | **4.9×** |
+
+### 一个数字回答不了这个问题
-### 两个与 AOT 无关的发现
+`scale-sprites` 一行游戏逻辑都没有(`VelocitySystem` 只有 0.01 ms,那些副本没有 Velocity),
+所以 73.3% 是 `c` 的**渲染那一端**;headless 全是游戏逻辑、没有渲染器,是另一端的 ~4%。
+收益跟着 `c` 走,在这段区间上从 **145×** 到 **2.3×**。
-1. **`RenderSystem` 占 CPU 帧的 53%。** 一帧里最烫的是脚本,而且不是游戏代码,
- 是 SDK 自己的 draw 提交。
-2. **无 JIT 下这一帧要 16.6 ms CPU**,正好是 60fps 预算。原生宿主在 9801 精灵上已经贴边跑。
+**可用的结论是:AOT 的收益与「一帧里有多少是游戏逻辑」成正比** —— 逻辑重的游戏一个数量级,
+以精灵为主的场景 3–5×。两端都过门槛,而它们相差 30 倍。
-### 路上修的两个「报零」bug
+### 路上修的三个「测量报低」bug
- `es_profile_now_ms()` 在非 Emscripten 下 `return 0.0` —— 那四个 render scope 在
桌面 / Android / iOS 上**从来就是 0**。已修成 `std::chrono::steady_clock`。
- `nativeScopes` 是 `{name, ms}[]` 不是 Record,按 Record 读会得到安静的 `(none recorded)`,
报出 `c = 0%`。
+- 上面那条双计。它把 `c` 报成 43.5% 而不是 73.3%,帧加速报成 7.2–16.0× 而不是 3.7–4.9×,
+ 而且它带的结论是**反的**:「一帧里最烫的是脚本」不成立,最烫的是 `render.collect`。
-两个是同一类错误:**一个报零的测量,看起来像一个好消息。**
+三个是同一类错误:**一个报低的测量,看起来像一个好消息。**