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-frame named counters (ES_PROFILE_COUNTER)

esenginef4a652af72ca
diff --git a/sdk/src/wasm.ts b/sdk/src/wasm.ts
index 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.cpp
index 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 viewp
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) {
@@ -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.hpp
index 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.cpp
index 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.hpp
index 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 esengine
diff --git a/src/esengine/renderer/RenderFrame.cpp b/src/esengine/renderer/RenderFrame.cpp
index 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() {