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.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
docs(bench): the frame-share notes carry the corrected numbers
esengine45de38a423e7
diff --git a/bench/aot-stage0/README.md b/bench/aot-stage0/README.mdindex 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`。-两个是同一类错误:**一个报零的测量,看起来像一个好消息。**+三个是同一类错误:**一个报低的测量,看起来像一个好消息。**