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.

refactor(bindings): the renderer has one camera, and the SDK owns it

yhh83303f7cf062
diff --git a/sdk/esengine.d.ts b/sdk/esengine.d.ts
index 1cf2b558f..e094c858f 100644
--- a/sdk/esengine.d.ts
+++ b/sdk/esengine.d.ts
@@ -146,7 +146,6 @@ export interface ESEngineModule {
initRenderer(): void;
initRendererWithCanvas(canvasSelector: string): boolean;
shutdownRenderer(): void;
- renderFrame(registry: Registry, width: number, height: number): void;
renderFrameWithMatrix(registry: Registry, width: number, height: number, matrixPtr: number): void;
getResourceManager(): ResourceManager;
diff --git a/sdk/etc/wasm.api.md b/sdk/etc/wasm.api.md
index ecc356c5c..3ac6157a8 100644
--- a/sdk/etc/wasm.api.md
+++ b/sdk/etc/wasm.api.md
@@ -344,7 +344,6 @@ registry_getCameraEntities: (registry: CppRegistry) => number[]
registry_getCanvasEntities: ((registry: CppRegistry) => number[]) | undefined
registry_getCanvasEntity: (registry: CppRegistry) => number
registry_getGeneration: (registry: CppRegistry, entity: number) => number
-renderFrame: (registry: CppRegistry, width: number, height: number) => void
renderFrameWithMatrix: (registry: CppRegistry, width: number, height: number, matrixPtr: number) => void
renderer_begin: (matrixPtr: number, targetHandle: number, clearFlags: number, r: number, g: number, b: number, a: number, clearX: number, clearY: number, clearW: number, clearH: number) => void
renderer_beginFrame: (elapsedSec: number) => void
diff --git a/sdk/src/ecs/bridge/nativeEngineApi.generated.ts b/sdk/src/ecs/bridge/nativeEngineApi.generated.ts
index 805dd025f..a64fed944 100644
--- a/sdk/src/ecs/bridge/nativeEngineApi.generated.ts
+++ b/sdk/src/ecs/bridge/nativeEngineApi.generated.ts
@@ -113,7 +113,6 @@ export interface NativeEngineApi {
registry_batchSyncPhysicsTransforms?(registry: unknown, bufferPtr: number, count: number, ppu: number): void;
registry_getCanvasEntity?(registry: unknown): number;
registry_getGeneration?(registry: unknown, entity: number): number;
- renderFrame?(registry: unknown, viewportWidth: number, viewportHeight: number): void;
renderFrameWithMatrix?(registry: unknown, viewportWidth: number, viewportHeight: number, matrixPtr: number): void;
renderer_begin?(matrixPtr: number, targetHandle: number, clearFlags: number, r: number, g: number, b: number, a: number, clearX: number, clearY: number, clearW: number, clearH: number): void;
renderer_beginFrame?(elapsedSec: number): void;
@@ -366,7 +365,6 @@ export function createNativeEngineApi(
bind('registry_batchSyncPhysicsTransforms', 'es_registry_batchSyncPhysicsTransforms', true);
bind('registry_getCanvasEntity', 'es_registry_getCanvasEntity', true);
bind('registry_getGeneration', 'es_registry_getGeneration', true);
- bind('renderFrame', 'es_renderFrame', true);
bind('renderFrameWithMatrix', 'es_renderFrameWithMatrix', true);
bind('renderer_begin', 'es_renderer_begin', false);
bind('renderer_beginFrame', 'es_renderer_beginFrame', false);
diff --git a/sdk/src/wasm.ts b/sdk/src/wasm.ts
index 235d060f3..b8775ad9a 100644
--- a/sdk/src/wasm.ts
+++ b/sdk/src/wasm.ts
@@ -194,7 +194,6 @@ export interface ESEngineModule {
/** Emscripten-internal: texture object pool keyed by handle id. */
textures: Record<number, WebGLTexture>;
};
- renderFrame(registry: CppRegistry, width: number, height: number): void;
renderFrameWithMatrix(registry: CppRegistry, width: number, height: number, matrixPtr: number): void;
getResourceManager(): CppResourceManager;
/**
diff --git a/src/esengine/bindings/RendererBindings.cpp b/src/esengine/bindings/RendererBindings.cpp
index ce847ec95..efe1f8fa4 100644
--- a/src/esengine/bindings/RendererBindings.cpp
+++ b/src/esengine/bindings/RendererBindings.cpp
@@ -432,65 +432,6 @@ void mesh2d_setMesh(ecs::Registry& registry, u32 entity, u32 meshHandle) {
mesh->mesh = resource::MeshHandle(meshHandle);
}
-void renderFrame(ecs::Registry& registry, i32 viewportWidth, i32 viewportHeight) {
- if (!g_initialized || !g_renderFrame) return;
-
- 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) {
- esengine::World w{registry, ctx().services(), 0.0f};
- g_transformSystem->update(w);
- }
-
- ctx().state().viewport_width = static_cast<u32>(viewportWidth);
- ctx().state().viewport_height = static_cast<u32>(viewportHeight);
- g_renderFrame->resize(g_viewportWidth, g_viewportHeight);
-
- g_device->setViewport(0, 0, static_cast<u32>(viewportWidth), static_cast<u32>(viewportHeight));
-
- glm::mat4 viewProjection = glm::mat4(1.0f);
-
- auto cameraView = registry.view<ecs::Camera, ecs::Transform>();
-
- for (auto entity : cameraView) {
- auto& camera = registry.get<ecs::Camera>(entity);
- if (!camera.isActive) continue;
-
- auto& transform = registry.get<ecs::Transform>(entity);
- glm::mat4 view = glm::inverse(glm::translate(glm::mat4(1.0f), transform.position));
-
- glm::mat4 projection;
- f32 aspect = static_cast<f32>(viewportWidth) / static_cast<f32>(viewportHeight);
-
- if (camera.projectionType == ecs::ProjectionType::Orthographic) {
- f32 halfHeight = camera.orthoSize;
- f32 halfWidth = halfHeight * aspect;
- projection = glm::ortho(-halfWidth, halfWidth, -halfHeight, halfHeight,
- camera.nearPlane, camera.farPlane);
- } else {
- projection = glm::perspective(
- glm::radians(camera.fov),
- static_cast<f32>(viewportWidth) / static_cast<f32>(viewportHeight),
- camera.nearPlane, camera.farPlane
- );
- }
-
- viewProjection = projection * view;
- break;
- }
-
- const auto& cc = ctx().state().clear_color;
- g_renderFrame->begin(viewProjection, 0, RenderFrame::PassClear{true, true, cc});
- g_renderFrame->collectAll(registry);
- g_renderFrame->end();
-}
-
void renderFrameWithMatrix(ecs::Registry& registry, i32 viewportWidth, i32 viewportHeight,
uintptr_t matrixPtr) {
if (!g_initialized || !g_renderFrame) return;
diff --git a/src/esengine/bindings/RendererBindings.hpp b/src/esengine/bindings/RendererBindings.hpp
index abff01fb0..87946fd43 100644
--- a/src/esengine/bindings/RendererBindings.hpp
+++ b/src/esengine/bindings/RendererBindings.hpp
@@ -21,7 +21,6 @@ namespace ecs {
class Registry;
}
-void renderFrame(ecs::Registry& registry, i32 viewportWidth, i32 viewportHeight);
void renderFrameWithMatrix(ecs::Registry& registry, i32 viewportWidth, i32 viewportHeight,
uintptr_t matrixPtr);
diff --git a/src/esengine/bindings/WebSDKEntry.cpp b/src/esengine/bindings/WebSDKEntry.cpp
index a5086b3a5..c08d9225b 100644
--- a/src/esengine/bindings/WebSDKEntry.cpp
+++ b/src/esengine/bindings/WebSDKEntry.cpp
@@ -469,7 +469,6 @@ EMSCRIPTEN_BINDINGS(esengine_renderer) {
// and returns false, so the JS surface never drifts across variants.
emscripten::function("initRendererWebGPU", &esengine::initRendererWebGPU);
emscripten::function("shutdownRenderer", &esengine::shutdownRenderer);
- emscripten::function("renderFrame", &esengine::renderFrame);
emscripten::function("renderFrameWithMatrix", &esengine::renderFrameWithMatrix);
emscripten::function("getResourceManager", &esengine::getResourceManager, emscripten::allow_raw_pointers());
emscripten::function("sdfFromAlpha", &esengine::web_sdfFromAlpha);