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-frame named counters (ES_PROFILE_COUNTER)
esenginef4a652af72ca
diff --git a/sdk/src/wasm.ts b/sdk/src/wasm.tsindex 70d900228..2ada67006 100644--- a/sdk/src/wasm.ts+++ b/sdk/src/wasm.ts@@ -294,6 +294,8 @@ export interface ESEngineModule {engine_setCpuProfiling?(on: boolean): void;/** Last frame's CPU scopes as a JSON object {"render.submit": ms, …}. */engine_getCpuScopes?(): string;+ /** Last frame's named counters as a JSON object {"render.culled": n, …}. */+ engine_getCounters?(): 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 693da7488..7f219f229 100644--- a/src/esengine/bindings/RendererBindings.cpp+++ b/src/esengine/bindings/RendererBindings.cpp@@ -132,6 +132,10 @@ void renderFrame(ecs::Registry& registry, i32 viewportWidth, i32 viewportHeight)if (auto* rm = ctx().tryGet<resource::ResourceManager>()) {rm->update();+ const auto st = rm->getStats();+ ES_PROFILE_COUNTER("res.textures", st.textureCount);+ ES_PROFILE_COUNTER("res.cacheHits", st.cacheHits);+ ES_PROFILE_COUNTER("res.cacheMisses", st.cacheMisses);}if (g_transformSystem) {@@ -191,6 +195,10 @@ void renderFrameWithMatrix(ecs::Registry& registry, i32 viewportWidth, i32 viewpif (auto* rm = ctx().tryGet<resource::ResourceManager>()) {rm->update();+ const auto st = rm->getStats();+ ES_PROFILE_COUNTER("res.textures", st.textureCount);+ ES_PROFILE_COUNTER("res.cacheHits", st.cacheHits);+ ES_PROFILE_COUNTER("res.cacheMisses", st.cacheMisses);}if (g_transformSystem) {@@ -427,6 +435,10 @@ std::string engine_getCpuScopes() {return FrameProfiler::get().lastJson();}+std::string engine_getCounters() {+ return FrameProfiler::get().lastCountersJson();+}+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 151758d1a..5c86ad061 100644--- a/src/esengine/bindings/RendererBindings.hpp+++ b/src/esengine/bindings/RendererBindings.hpp@@ -109,6 +109,7 @@ u32 renderer_getCulled();f32 renderer_getGpuTimeMs();void engine_setCpuProfiling(bool on);std::string engine_getCpuScopes();+std::string engine_getCounters();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 ea6159b54..33cf3006a 100644--- a/src/esengine/bindings/WebSDKEntry.cpp+++ b/src/esengine/bindings/WebSDKEntry.cpp@@ -521,6 +521,7 @@ EMSCRIPTEN_BINDINGS(esengine_renderer) {emscripten::function("renderer_getGpuTimeMs", &esengine::renderer_getGpuTimeMs);emscripten::function("engine_setCpuProfiling", &esengine::engine_setCpuProfiling);emscripten::function("engine_getCpuScopes", &esengine::engine_getCpuScopes);+ emscripten::function("engine_getCounters", &esengine::engine_getCounters);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 4aa773a72..cfe90f9ac 100644--- a/src/esengine/core/FrameProfiler.hpp+++ b/src/esengine/core/FrameProfiler.hpp@@ -40,19 +40,34 @@ 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 commit() {last_.swap(cur_);cur_.clear();+ counters_last_.swap(counters_cur_);+ counters_cur_.clear();}- std::string lastJson() const {+ std::string lastJson() const { return toJson(last_); }+ std::string lastCountersJson() const { return toJson(counters_last_); }++private:+ struct Entry { const char* name; double ms; };++ static std::string toJson(const std::vector<Entry>& v) {std::string s = "{";- for (std::size_t i = 0; i < last_.size(); ++i) {+ for (std::size_t i = 0; i < v.size(); ++i) {if (i) s += ',';char buf[32];- std::snprintf(buf, sizeof(buf), "%.4f", last_[i].ms);+ std::snprintf(buf, sizeof(buf), "%.4f", v[i].ms);s += '"';- s += last_[i].name;+ s += v[i].name;s += "\":";s += buf;}@@ -60,10 +75,10 @@ public:return s;}-private:- struct Entry { const char* name; double ms; };std::vector<Entry> cur_;std::vector<Entry> last_;+ std::vector<Entry> counters_cur_;+ std::vector<Entry> counters_last_;bool enabled_ = false;};@@ -88,5 +103,7 @@ private:#define ES_PROFILE_CONCAT_(a, b) a##b#define ES_PROFILE_CONCAT(a, b) ES_PROFILE_CONCAT_(a, b)#define ES_PROFILE_SCOPE(name) ::esengine::ScopeTimer ES_PROFILE_CONCAT(es_scope_, __LINE__)(name)+#define ES_PROFILE_COUNTER(name, value) \+ do { if (::esengine::FrameProfiler::get().enabled()) ::esengine::FrameProfiler::get().counter(name, static_cast<double>(value)); } while (0)} // namespace esenginediff --git a/src/esengine/renderer/RenderFrame.cpp b/src/esengine/renderer/RenderFrame.cppindex 7ea62faaf..6ec7ecf54 100644--- a/src/esengine/renderer/RenderFrame.cpp+++ b/src/esengine/renderer/RenderFrame.cpp@@ -289,6 +289,14 @@ void RenderFrame::flush() {default: break;}}++ ES_PROFILE_COUNTER("render.culled", stats_.culled);+ ES_PROFILE_COUNTER("render.sprites", stats_.sprites);+ ES_PROFILE_COUNTER("render.text", stats_.text);+ ES_PROFILE_COUNTER("render.shapes", stats_.shapes);+#ifdef ES_ENABLE_PARTICLES+ ES_PROFILE_COUNTER("render.particles", stats_.particles);+#endif}void RenderFrame::end() {