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.

feat(engine): per-pass GPU timing (submit / postprocess)

esengine29dd11a8bbee
diff --git a/sdk/src/wasm.ts b/sdk/src/wasm.ts
index 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.cpp
index 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.hpp
index 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.cpp
index 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.hpp
index 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.cpp
index 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_POSTPROCESS
ES_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.hpp
index 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;