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
feat(engine): per-pass GPU timing (submit / postprocess)
esengine29dd11a8bbee
diff --git a/sdk/src/wasm.ts b/sdk/src/wasm.tsindex 2ada67006..faa754570 100644--- a/sdk/src/wasm.ts+++ b/sdk/src/wasm.ts@@ -296,6 +296,8 @@ export interface ESEngineModule {engine_getCpuScopes?(): string;/** Last frame's named counters as a JSON object {"render.culled": n, …}. */engine_getCounters?(): string;+ /** Last frame's per-pass GPU times as a JSON object {"submit": ms, …}. */+ engine_getGpuScopes?(): string;/** Resident texture VRAM (RGBA8 estimate, bytes) for the profiler's memory pillar. */renderer_getTextureBytes?(): number;renderer_setClearColor(r: number, g: number, b: number, a: number): void;diff --git a/src/esengine/bindings/RendererBindings.cpp b/src/esengine/bindings/RendererBindings.cppindex 7f219f229..81764697d 100644--- a/src/esengine/bindings/RendererBindings.cpp+++ b/src/esengine/bindings/RendererBindings.cpp@@ -439,6 +439,10 @@ std::string engine_getCounters() {return FrameProfiler::get().lastCountersJson();}+std::string engine_getGpuScopes() {+ return FrameProfiler::get().lastGpuJson();+}+f64 renderer_getTextureBytes() {if (auto* rm = ctx().tryGet<resource::ResourceManager>()) {return static_cast<f64>(rm->getStats().textureBytes);diff --git a/src/esengine/bindings/RendererBindings.hpp b/src/esengine/bindings/RendererBindings.hppindex 5c86ad061..0bc0caa9e 100644--- a/src/esengine/bindings/RendererBindings.hpp+++ b/src/esengine/bindings/RendererBindings.hpp@@ -110,6 +110,7 @@ f32 renderer_getGpuTimeMs();void engine_setCpuProfiling(bool on);std::string engine_getCpuScopes();std::string engine_getCounters();+std::string engine_getGpuScopes();f64 renderer_getTextureBytes();void renderer_setDeltaTime(f32 dt);void renderer_setClearColor(f32 r, f32 g, f32 b, f32 a);diff --git a/src/esengine/bindings/WebSDKEntry.cpp b/src/esengine/bindings/WebSDKEntry.cppindex 33cf3006a..f181d2daf 100644--- a/src/esengine/bindings/WebSDKEntry.cpp+++ b/src/esengine/bindings/WebSDKEntry.cpp@@ -522,6 +522,7 @@ EMSCRIPTEN_BINDINGS(esengine_renderer) {emscripten::function("engine_setCpuProfiling", &esengine::engine_setCpuProfiling);emscripten::function("engine_getCpuScopes", &esengine::engine_getCpuScopes);emscripten::function("engine_getCounters", &esengine::engine_getCounters);+ emscripten::function("engine_getGpuScopes", &esengine::engine_getGpuScopes);emscripten::function("renderer_getTextureBytes", &esengine::renderer_getTextureBytes);emscripten::function("renderer_setDeltaTime", &esengine::renderer_setDeltaTime);emscripten::function("renderer_setClearColor", &esengine::renderer_setClearColor);diff --git a/src/esengine/core/FrameProfiler.hpp b/src/esengine/core/FrameProfiler.hppindex cfe90f9ac..1f784798e 100644--- a/src/esengine/core/FrameProfiler.hpp+++ b/src/esengine/core/FrameProfiler.hpp@@ -40,26 +40,32 @@ public:cur_.push_back({name, ms});}- void counter(const char* name, double value) {- for (auto& e : counters_cur_) {- if (std::strcmp(e.name, name) == 0) { e.ms = value; return; }- }- counters_cur_.push_back({name, value});- }+ void counter(const char* name, double value) { setEntry(counters_cur_, name, value); }+ void gpuScope(const char* name, double ms) { setEntry(gpu_cur_, name, ms); }void commit() {last_.swap(cur_);cur_.clear();counters_last_.swap(counters_cur_);counters_cur_.clear();+ gpu_last_.swap(gpu_cur_);+ gpu_cur_.clear();}std::string lastJson() const { return toJson(last_); }std::string lastCountersJson() const { return toJson(counters_last_); }+ std::string lastGpuJson() const { return toJson(gpu_last_); }private:struct Entry { const char* name; double ms; };+ static void setEntry(std::vector<Entry>& v, const char* name, double value) {+ for (auto& e : v) {+ if (std::strcmp(e.name, name) == 0) { e.ms = value; return; }+ }+ v.push_back({name, value});+ }+static std::string toJson(const std::vector<Entry>& v) {std::string s = "{";for (std::size_t i = 0; i < v.size(); ++i) {@@ -79,6 +85,8 @@ private:std::vector<Entry> last_;std::vector<Entry> counters_cur_;std::vector<Entry> counters_last_;+ std::vector<Entry> gpu_cur_;+ std::vector<Entry> gpu_last_;bool enabled_ = false;};diff --git a/src/esengine/renderer/RenderFrame.cpp b/src/esengine/renderer/RenderFrame.cppindex 6ec7ecf54..937c71a17 100644--- a/src/esengine/renderer/RenderFrame.cpp+++ b/src/esengine/renderer/RenderFrame.cpp@@ -265,7 +265,7 @@ void RenderFrame::flush() {draw_list_.execute(device_, pool_, context_.materials(), &frame_capture_);gpu_timer_.end();}- stats_.gpu_time_ms = gpu_timer_.lastMs();+ FrameProfiler::get().gpuScope("submit", gpu_timer_.lastMs());stats_.draw_calls = draw_list_.mergedDrawCallCount();for (u32 i = 0; i < draw_list_.commandCount(); ++i) {@@ -316,7 +316,11 @@ void RenderFrame::end() {if (usePostProcess) {#ifdef ES_ENABLE_POSTPROCESSES_PROFILE_SCOPE("render.postprocess");+ gpu_timer_pp_.poll();+ gpu_timer_pp_.begin();post_process_->end();+ gpu_timer_pp_.end();+ FrameProfiler::get().gpuScope("postprocess", gpu_timer_pp_.lastMs());#endif} else if (current_target_ != RenderTargetManager::INVALID_HANDLE) {auto* rt = target_manager_.get(current_target_);@@ -325,6 +329,10 @@ void RenderFrame::end() {}}+ const f32 submitMs = gpu_timer_.lastMs();+ const f32 ppMs = usePostProcess ? gpu_timer_pp_.lastMs() : 0.0f;+ stats_.gpu_time_ms = submitMs < 0.0f ? -1.0f : submitMs + (ppMs > 0.0f ? ppMs : 0.0f);+frame_capture_.endCapture();in_frame_ = false;flushed_ = false;diff --git a/src/esengine/renderer/RenderFrame.hpp b/src/esengine/renderer/RenderFrame.hppindex 35e750840..9dbe89a2d 100644--- a/src/esengine/renderer/RenderFrame.hpp+++ b/src/esengine/renderer/RenderFrame.hpp@@ -192,6 +192,7 @@ private:Stats stats_;GpuTimer gpu_timer_;+ GpuTimer gpu_timer_pp_;FrameCapture frame_capture_;std::vector<u8> snapshot_pixels_;RenderTargetManager::Handle replay_rt_ = 0;