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(engine): 26 entry points the engine offered and no host asked for

esengine544c6814c7bb
diff --git a/CHANGELOG.md b/CHANGELOG.md
index fa9812143..0c1d04d94 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -16,6 +16,23 @@ published separately; it ships inside the editor.
### Changed
+- **Removed: 26 engine entry points no host called.** Five of them
+ (`renderer_submitSprites` / `submitUIElements` / `submitBitmapText` /
+ `submitShapes` / `submitParticles`) had bodies that were `(void)registry;` —
+ collection moved to `renderer_submitAll` and the per-type doors were left
+ standing. The rest were an internal mechanism exposed twice (the seven
+ clip-rect / stencil entries: UI masks are resolved inside the frame, never from
+ JS), a set of incremental post-process calls under a pipeline the SDK rebuilds
+ whole (`removePass` / `setPassEnabled` / `isPassEnabled` / `getPassCount` /
+ `isBypassed` / `setOutputTarget`), superseded entries (`initRendererWithCanvas`,
+ `renderFrameWithMatrix`, `mesh_create`, the per-entity `meshRenderer_setMesh` /
+ `makeResident` beside their `…All` forms), and three queries nothing read.
+
+ New gate `check-engine-exports`: every `emscripten::function` must have a
+ caller in the SDK, the editor, the tools or the tests — the pointer accessors
+ are exempted from the generated layout table itself, so a new component cannot
+ make one look dead.
+
- **Removed: three machines nothing ever drove.** `SubmitSkipFlags` named two
render plugins to skip — one of which (`Spine`) has had no plugin to skip
since spine moved to side modules — and the only `submitAll` in the engine
diff --git a/sdk/etc/wasm.api.md b/sdk/etc/wasm.api.md
index 8fc7b7d6c..436c31fb8 100644
--- a/sdk/etc/wasm.api.md
+++ b/sdk/etc/wasm.api.md
@@ -283,13 +283,11 @@ getUINodeAlphaInTree: ((registry: CppRegistry, entity: number) => number) | unde
getUINodeComputedHeight: ((registry: CppRegistry, entity: number) => number) | undefined
getUINodeComputedWidth: ((registry: CppRegistry, entity: number) => number) | undefined
getUINodeHiddenInTree: ((registry: CppRegistry, entity: number) => boolean) | undefined
-getUINodePointerBlockedInTree: ((registry: CppRegistry, entity: number) => boolean) | undefined
getVelocityPtr: (registry: CppRegistry, entity: number) => number
gl_checkErrors: (context: string) => number
gl_enableErrorCheck: (enabled: boolean) => void
initRenderer: () => void
initRendererWebGPU: (canvasSelector: string, width: number, height: number, readback: boolean, preferBGRA: boolean) => boolean
-initRendererWithCanvas: (canvasSelector: string) => boolean
initRendererWithContext: (contextHandle: number) => boolean
markDeviceRestored: (() => number) | undefined
material_compileEsshader: (source: string, featuresCsv: string) => number
@@ -299,12 +297,9 @@ material_setUniform: (materialId: number, name: string, arity: number, v0: numbe
material_undefine: (materialId: number) => void
meshRenderer_localBounds: ((registry: CppRegistry, entity: number) => { minX: number; minY: number; maxX: number; maxY: number; } | null) | undefined
meshRenderer_makeAllResident: ((registry: CppRegistry) => number) | undefined
-meshRenderer_makeResident: ((registry: CppRegistry, entity: number) => number) | undefined
meshRenderer_setGeometry: ((registry: CppRegistry, entity: number, posUvPtr: number, vertexCount: number, colorsPtr: number, indicesPtr: number, indexCount: number) => void) | undefined
meshRenderer_setMaterialAll: ((registry: CppRegistry, materialId: number) => number) | undefined
-meshRenderer_setMesh: ((registry: CppRegistry, entity: number, meshHandle: number) => void) | undefined
meshRenderer_setMeshAll: ((registry: CppRegistry, meshHandle: number) => number) | undefined
-mesh_create: ((posUvPtr: number, vertexCount: number, colorsPtr: number, indicesPtr: number, indexCount: number) => number) | undefined
mesh_createFromChannels: ((channelsPtr: number, channelCount: number, vertexStride: number, vertexPtr: number, vertexBytes: number, indexPtr: number, indexCount: number, minX: number, minY: number, minZ: number, maxX: number, maxY: number, maxZ: number, bindPtr: number, bindFloats: number) => number) | undefined
mesh_release: ((meshHandle: number) => void) | undefined
notifyDeviceLost: ((reason: number, message: string) => void) | undefined
@@ -324,17 +319,11 @@ postprocess_clearScreenPasses: () => void
postprocess_end: () => void
postprocess_endScreenCapture: () => void
postprocess_executeScreenPasses: () => void
-postprocess_getPassCount: () => number
postprocess_init: (width: number, height: number) => boolean
-postprocess_isBypassed: () => boolean
postprocess_isInitialized: () => boolean
-postprocess_isPassEnabled: (name: string) => boolean
-postprocess_removePass: (name: string) => void
postprocess_resize: (width: number, height: number) => void
postprocess_setBypass: (bypass: boolean) => void
-postprocess_setOutputTarget: (fboId: number) => void
postprocess_setOutputViewport: (x: number, y: number, w: number, h: number) => void
-postprocess_setPassEnabled: (name: string, enabled: boolean) => void
postprocess_setPassTexture: (passName: string, uniform: string, textureHandle: number) => void
postprocess_setScreenUniformFloat: (passName: string, uniform: string, value: number) => void
postprocess_setScreenUniformVec4: (passName: string, uniform: string, x: number, y: number, z: number, w: number) => void
@@ -348,15 +337,10 @@ registry_getCameraEntities: (registry: CppRegistry) => number[]
registry_getCanvasEntities: ((registry: CppRegistry) => number[]) | undefined
registry_getCanvasEntity: (registry: CppRegistry) => number
registry_getGeneration: (registry: CppRegistry, entity: number) => number
-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
renderer_captureFrame: ((w: number, h: number) => number) | undefined
renderer_captureNextFrame: () => void
-renderer_clearAllClipRects: () => void
-renderer_clearAllStencilMasks: () => void
-renderer_clearEntityClipRect: (entity: number) => void
-renderer_clearEntityStencilMask: (entity: number) => void
renderer_createTarget: (width: number, height: number, flags: number) => number
renderer_diagnose: () => void
renderer_end: () => void
@@ -400,22 +384,14 @@ renderer_setClearColor: (r: number, g: number, b: number, a: number) => void
renderer_setColorSpace: ((linear: number) => void) | undefined
renderer_setCullingMask: ((mask: number) => void) | undefined
renderer_setDepthLayers: ((mask: number) => void) | undefined
-renderer_setEntityClipRect: (entity: number, x: number, y: number, w: number, h: number) => void
renderer_setEntityDrawOrder: ((registry: CppRegistry, entitiesPtr: number, count: number) => void) | undefined
-renderer_setEntityStencilMask: (entity: number, refValue: number) => void
-renderer_setEntityStencilTest: (entity: number, refValue: number) => void
renderer_setStage: (stage: number) => void
renderer_setTextureParams: (textureId: number, minFilter: number, magFilter: number, wrapS: number, wrapT: number) => void
renderer_setViewport: (x: number, y: number, w: number, h: number) => void
renderer_setYSortLayers: ((mask: number) => void) | undefined
renderer_submitAll: (registry: CppRegistry, vpX: number, vpY: number, vpW: number, vpH: number) => void
-renderer_submitBitmapText: (registry: CppRegistry) => void
-renderer_submitParticles: ((registry: CppRegistry) => void) | undefined
-renderer_submitShapes: ((registry: CppRegistry) => void) | undefined
renderer_submitSkeletalBatchByEntity: ((registry: CppRegistry, verticesPtr: number, vertexCount: number, indicesPtr: number, indexCount: number, textureId: number, blendMode: number, entity: number, skelScale: number, flipX: boolean, flipY: boolean, layer: number, depth: number, materialId: number) => void) | undefined
-renderer_submitSprites: (registry: CppRegistry) => void
renderer_submitTextBatch: ((verticesPtr: number, vertexCount: number, indicesPtr: number, indexCount: number, textureId: number, transformPtr: number, entity: number, layer: number, depth: number, sdf: number, cullBit: number) => void) | undefined
-renderer_submitUIElements: (registry: CppRegistry) => void
renderer_takeFrameCapture: ((handle: number, dest: number, destSize: number) => boolean) | undefined
renderer_updateTransforms: (registry: CppRegistry) => void
sdfFromAlpha: ((alphaPtr: number, outPtr: number, width: number, height: number, spread: number) => void) | undefined
@@ -433,10 +409,8 @@ tilemap_setTile: ((entity: number, x: number, y: number, tileId: number) => void
tilemap_setTiles: ((entity: number, tilesPtr: number, count: number) => void) | undefined
trail_clear: ((registry: CppRegistry, entity: number) => void) | undefined
trail_update: ((registry: CppRegistry, dt: number) => void) | undefined
-transform_patchPosition: (registry: CppRegistry, entity: number, x: number, y: number, z: number) => void
transform_update: (registry: CppRegistry) => void
uiHitTest_getHitEntity: () => number
-uiHitTest_getHitEntityPrev: () => number
uiHitTest_pick: ((registry: CppRegistry, worldX: number, worldY: number) => number) | undefined
uiHitTest_pickAll: ((registry: CppRegistry, worldX: number, worldY: number) => number) | undefined
uiHitTest_pickResult: ((index: number) => number) | undefined
diff --git a/sdk/src/ecs/bridge/nativeEngineApi.generated.ts b/sdk/src/ecs/bridge/nativeEngineApi.generated.ts
index b1017c2fc..849127695 100644
--- a/sdk/src/ecs/bridge/nativeEngineApi.generated.ts
+++ b/sdk/src/ecs/bridge/nativeEngineApi.generated.ts
@@ -60,7 +60,6 @@ export interface NativeEngineApi {
getUINodeComputedHeight?(registry: unknown, entity: number): number;
getUINodeComputedWidth?(registry: unknown, entity: number): number;
getUINodeHiddenInTree?(registry: unknown, entity: number): boolean;
- getUINodePointerBlockedInTree?(registry: unknown, entity: number): boolean;
gl_checkErrors?(context: string): number;
gl_enableErrorCheck?(enabled: boolean): void;
material_compileEsshader?(source: string, featuresCsv: string): number;
@@ -69,12 +68,9 @@ export interface NativeEngineApi {
material_setUniform?(materialId: number, name: string, arity: number, v0: number, v1: number, v2: number, v3: number): void;
material_undefine?(materialId: number): void;
meshRenderer_makeAllResident?(registry: unknown): number;
- meshRenderer_makeResident?(registry: unknown, entity: number): number;
meshRenderer_setGeometry?(registry: unknown, entity: number, posUvPtr: number, vertexCount: number, colorsPtr: number, indicesPtr: number, indexCount: number): void;
meshRenderer_setMaterialAll?(registry: unknown, materialId: number): number;
- meshRenderer_setMesh?(registry: unknown, entity: number, meshHandle: number): void;
meshRenderer_setMeshAll?(registry: unknown, meshHandle: number): number;
- mesh_create?(posUvPtr: number, vertexCount: number, colorsPtr: number, indicesPtr: number, indexCount: number): number;
mesh_createFromChannels?(channelsPtr: number, channelCount: number, vertexStride: number, vertexPtr: number, vertexBytes: number, indexPtr: number, indexCount: number, minX: number, minY: number, minZ: number, maxX: number, maxY: number, maxZ: number, bindPtr: number, bindFloats: number): number;
mesh_release?(meshHandle: number): void;
particle_getAliveCount?(entity: number): number;
@@ -93,17 +89,11 @@ export interface NativeEngineApi {
postprocess_end?(): void;
postprocess_endScreenCapture?(): void;
postprocess_executeScreenPasses?(): void;
- postprocess_getPassCount?(): number;
postprocess_init?(width: number, height: number): boolean;
- postprocess_isBypassed?(): boolean;
postprocess_isInitialized?(): boolean;
- postprocess_isPassEnabled?(name: string): boolean;
- postprocess_removePass?(name: string): void;
postprocess_resize?(width: number, height: number): void;
postprocess_setBypass?(bypass: boolean): void;
- postprocess_setOutputTarget?(fboId: number): void;
postprocess_setOutputViewport?(x: number, y: number, w: number, h: number): void;
- postprocess_setPassEnabled?(name: string, enabled: boolean): void;
postprocess_setPassTexture?(passName: string, uniform: string, textureHandle: number): void;
postprocess_setScreenUniformFloat?(passName: string, uniform: string, value: number): void;
postprocess_setScreenUniformVec4?(passName: string, uniform: string, x: number, y: number, z: number, w: number): void;
@@ -113,15 +103,10 @@ 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;
- 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;
renderer_captureFrame?(w: number, h: number): number;
renderer_captureNextFrame?(): void;
- renderer_clearAllClipRects?(): void;
- renderer_clearAllStencilMasks?(): void;
- renderer_clearEntityClipRect?(entity: number): void;
- renderer_clearEntityStencilMask?(entity: number): void;
renderer_createTarget?(width: number, height: number, flags: number): number;
renderer_diagnose?(): void;
renderer_end?(): void;
@@ -160,22 +145,14 @@ export interface NativeEngineApi {
renderer_setColorSpace?(linear: number): void;
renderer_setCullingMask?(mask: number): void;
renderer_setDepthLayers?(mask: number): void;
- renderer_setEntityClipRect?(entity: number, x: number, y: number, w: number, h: number): void;
renderer_setEntityDrawOrder?(registry: unknown, entitiesPtr: number, count: number): void;
- renderer_setEntityStencilMask?(entity: number, refValue: number): void;
- renderer_setEntityStencilTest?(entity: number, refValue: number): void;
renderer_setStage?(stage: number): void;
renderer_setTextureParams?(textureId: number, minFilter: number, magFilter: number, wrapS: number, wrapT: number): void;
renderer_setViewport?(x: number, y: number, w: number, h: number): void;
renderer_setYSortLayers?(mask: number): void;
renderer_submitAll?(registry: unknown, vpX: number, vpY: number, vpW: number, vpH: number): void;
- renderer_submitBitmapText?(registry: unknown): void;
- renderer_submitParticles?(registry: unknown): void;
- renderer_submitShapes?(registry: unknown): void;
renderer_submitSkeletalBatchByEntity?(registry: unknown, verticesPtr: number, vertexCount: number, indicesPtr: number, indexCount: number, textureId: number, blendMode: number, entity: number, skelScale: number, flipX: boolean, flipY: boolean, layer: number, depth: number, materialId: number): void;
- renderer_submitSprites?(registry: unknown): void;
renderer_submitTextBatch?(verticesPtr: number, vertexCount: number, indicesPtr: number, indexCount: number, textureId: number, transformPtr: number, entity: number, layer: number, depth: number, sdf: number, cullBit: number): void;
- renderer_submitUIElements?(registry: unknown): void;
renderer_takeFrameCapture?(handle: number, dest: number, destSize: number): boolean;
renderer_updateTransforms?(registry: unknown): void;
rm_acquireTextureByPath?(rm: unknown, path: string): number;
@@ -234,10 +211,8 @@ export interface NativeEngineApi {
tilemap_worldToTile?(entity: number, wx: number, wy: number, originX: number, originY: number): number;
trail_clear?(registry: unknown, entity: number): void;
trail_update?(registry: unknown, dt: number): void;
- transform_patchPosition?(registry: unknown, entity: number, x: number, y: number, z: number): void;
transform_update?(registry: unknown): void;
uiHitTest_getHitEntity?(): number;
- uiHitTest_getHitEntityPrev?(): number;
uiHitTest_pick?(registry: unknown, worldX: number, worldY: number): number;
uiHitTest_pickAll?(registry: unknown, worldX: number, worldY: number): number;
uiHitTest_pickResult?(index: number): number;
@@ -310,7 +285,6 @@ export function createNativeEngineApi(
bind('getUINodeComputedHeight', 'es_getUINodeComputedHeight', true);
bind('getUINodeComputedWidth', 'es_getUINodeComputedWidth', true);
bind('getUINodeHiddenInTree', 'es_getUINodeHiddenInTree', true);
- bind('getUINodePointerBlockedInTree', 'es_getUINodePointerBlockedInTree', true);
bind('gl_checkErrors', 'es_gl_checkErrors', false);
bind('gl_enableErrorCheck', 'es_gl_enableErrorCheck', false);
bind('material_compileEsshader', 'es_material_compileEsshader', false);
@@ -319,12 +293,9 @@ export function createNativeEngineApi(
bind('material_setUniform', 'es_material_setUniform', false);
bind('material_undefine', 'es_material_undefine', false);
bind('meshRenderer_makeAllResident', 'es_meshRenderer_makeAllResident', true);
- bind('meshRenderer_makeResident', 'es_meshRenderer_makeResident', true);
bind('meshRenderer_setGeometry', 'es_meshRenderer_setGeometry', true);
bind('meshRenderer_setMaterialAll', 'es_meshRenderer_setMaterialAll', true);
- bind('meshRenderer_setMesh', 'es_meshRenderer_setMesh', true);
bind('meshRenderer_setMeshAll', 'es_meshRenderer_setMeshAll', true);
- bind('mesh_create', 'es_mesh_create', false);
bind('mesh_createFromChannels', 'es_mesh_createFromChannels', false);
bind('mesh_release', 'es_mesh_release', false);
bind('particle_getAliveCount', 'es_particle_getAliveCount', false);
@@ -343,17 +314,11 @@ export function createNativeEngineApi(
bind('postprocess_end', 'es_postprocess_end', false);
bind('postprocess_endScreenCapture', 'es_postprocess_endScreenCapture', false);
bind('postprocess_executeScreenPasses', 'es_postprocess_executeScreenPasses', false);
- bind('postprocess_getPassCount', 'es_postprocess_getPassCount', false);
bind('postprocess_init', 'es_postprocess_init', false);
- bind('postprocess_isBypassed', 'es_postprocess_isBypassed', false);
bind('postprocess_isInitialized', 'es_postprocess_isInitialized', false);
- bind('postprocess_isPassEnabled', 'es_postprocess_isPassEnabled', false);
- bind('postprocess_removePass', 'es_postprocess_removePass', false);
bind('postprocess_resize', 'es_postprocess_resize', false);
bind('postprocess_setBypass', 'es_postprocess_setBypass', false);
- bind('postprocess_setOutputTarget', 'es_postprocess_setOutputTarget', false);
bind('postprocess_setOutputViewport', 'es_postprocess_setOutputViewport', false);
- bind('postprocess_setPassEnabled', 'es_postprocess_setPassEnabled', false);
bind('postprocess_setPassTexture', 'es_postprocess_setPassTexture', false);
bind('postprocess_setScreenUniformFloat', 'es_postprocess_setScreenUniformFloat', false);
bind('postprocess_setScreenUniformVec4', 'es_postprocess_setScreenUniformVec4', false);
@@ -363,15 +328,10 @@ 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('renderFrameWithMatrix', 'es_renderFrameWithMatrix', true);
bind('renderer_begin', 'es_renderer_begin', false);
bind('renderer_beginFrame', 'es_renderer_beginFrame', false);
bind('renderer_captureFrame', 'es_renderer_captureFrame', false);
bind('renderer_captureNextFrame', 'es_renderer_captureNextFrame', false);
- bind('renderer_clearAllClipRects', 'es_renderer_clearAllClipRects', false);
- bind('renderer_clearAllStencilMasks', 'es_renderer_clearAllStencilMasks', false);
- bind('renderer_clearEntityClipRect', 'es_renderer_clearEntityClipRect', false);
- bind('renderer_clearEntityStencilMask', 'es_renderer_clearEntityStencilMask', false);
bind('renderer_createTarget', 'es_renderer_createTarget', false);
bind('renderer_diagnose', 'es_renderer_diagnose', false);
bind('renderer_end', 'es_renderer_end', false);
@@ -410,22 +370,14 @@ export function createNativeEngineApi(
bind('renderer_setColorSpace', 'es_renderer_setColorSpace', false);
bind('renderer_setCullingMask', 'es_renderer_setCullingMask', false);
bind('renderer_setDepthLayers', 'es_renderer_setDepthLayers', false);
- bind('renderer_setEntityClipRect', 'es_renderer_setEntityClipRect', false);
bind('renderer_setEntityDrawOrder', 'es_renderer_setEntityDrawOrder', true);
- bind('renderer_setEntityStencilMask', 'es_renderer_setEntityStencilMask', false);
- bind('renderer_setEntityStencilTest', 'es_renderer_setEntityStencilTest', false);
bind('renderer_setStage', 'es_renderer_setStage', false);
bind('renderer_setTextureParams', 'es_renderer_setTextureParams', false);
bind('renderer_setViewport', 'es_renderer_setViewport', false);
bind('renderer_setYSortLayers', 'es_renderer_setYSortLayers', false);
bind('renderer_submitAll', 'es_renderer_submitAll', true);
- bind('renderer_submitBitmapText', 'es_renderer_submitBitmapText', true);
- bind('renderer_submitParticles', 'es_renderer_submitParticles', true);
- bind('renderer_submitShapes', 'es_renderer_submitShapes', true);
bind('renderer_submitSkeletalBatchByEntity', 'es_renderer_submitSkeletalBatchByEntity', true);
- bind('renderer_submitSprites', 'es_renderer_submitSprites', true);
bind('renderer_submitTextBatch', 'es_renderer_submitTextBatch', false);
- bind('renderer_submitUIElements', 'es_renderer_submitUIElements', true);
bind('renderer_takeFrameCapture', 'es_renderer_takeFrameCapture', false);
bind('renderer_updateTransforms', 'es_renderer_updateTransforms', true);
bind('rm_acquireTextureByPath', 'es_rm_acquireTextureByPath', true);
@@ -484,10 +436,8 @@ export function createNativeEngineApi(
bind('tilemap_worldToTile', 'es_tilemap_worldToTile', false);
bind('trail_clear', 'es_trail_clear', true);
bind('trail_update', 'es_trail_update', true);
- bind('transform_patchPosition', 'es_transform_patchPosition', true);
bind('transform_update', 'es_transform_update', true);
bind('uiHitTest_getHitEntity', 'es_uiHitTest_getHitEntity', false);
- bind('uiHitTest_getHitEntityPrev', 'es_uiHitTest_getHitEntityPrev', false);
bind('uiHitTest_pick', 'es_uiHitTest_pick', true);
bind('uiHitTest_pickAll', 'es_uiHitTest_pickAll', true);
bind('uiHitTest_pickResult', 'es_uiHitTest_pickResult', false);
diff --git a/sdk/src/wasm.ts b/sdk/src/wasm.ts
index 520b82763..d8d795011 100644
--- a/sdk/src/wasm.ts
+++ b/sdk/src/wasm.ts
@@ -161,7 +161,6 @@ export interface ESEngineModule {
FS: EmscriptenFS;
initRenderer(): void;
- initRendererWithCanvas(canvasSelector: string): boolean;
initRendererWithContext(contextHandle: number): boolean;
/**
* Boot on the WebGPU backend. The host must acquire a GPUDevice and pass it
@@ -194,7 +193,6 @@ export interface ESEngineModule {
/** Emscripten-internal: texture object pool keyed by handle id. */
textures: Record<number, WebGLTexture>;
};
- renderFrameWithMatrix(registry: CppRegistry, width: number, height: number, matrixPtr: number): void;
getResourceManager(): CppResourceManager;
/**
* Convert a Canvas2D-rasterized alpha bitmap to a signed distance field for
@@ -218,19 +216,6 @@ export interface ESEngineModule {
* on its own next poll. Reason codes match GfxDeviceLostReason.
*/
notifyDeviceLost?(reason: number, message: string): void;
- /**
- * Rebuild the renderer after a loss. False means "not yet" — a browser
- * restores a context when it is ready, so this is expected to be retried.
- * On success the device is Recovering: drawing, with placeholder textures.
- */
- /**
- * Upload geometry that STAYS on the GPU: interleaved f32 [x,y,z,u,v] per
- * vertex, optional RGBA8 colors, u32 triangle indices. Any number of entities
- * can draw the result, each with its own transform. Where the inline
- * `meshRenderer_setGeometry` payload is rewritten per frame, this is uploaded once.
- */
- mesh_create?(posUvPtr: number, vertexCount: number, colorsPtr: number,
- indicesPtr: number, indexCount: number): number;
/**
* Upload geometry described by an .esmesh channel table — 8 bytes per channel
* (semantic, components, type, normalized, offset) in the file's own layout,
@@ -254,14 +239,6 @@ export interface ESEngineModule {
mipCount: number, maxRange: number): number;
/** Release an environment; its atlas is an ordinary texture and outlives it. */
environment_release?(environmentHandle: number): void;
- /** Point a MeshRenderer at a resident mesh; 0 returns it to its inline payload. */
- meshRenderer_setMesh?(registry: CppRegistry, entity: number, meshHandle: number): void;
- /**
- * Freeze a MeshRenderer's inline geometry onto the GPU — the same vertices, uploaded
- * once and drawn with a per-object transform. Returns the mesh handle, 0 if
- * the entity had no geometry to freeze.
- */
- meshRenderer_makeResident?(registry: CppRegistry, entity: number): number;
/** The same for every MeshRenderer in the world; returns how many were frozen. */
meshRenderer_makeAllResident?(registry: CppRegistry): number;
/**
@@ -399,20 +376,14 @@ export interface ESEngineModule {
postprocess_shutdown(): void;
postprocess_resize(width: number, height: number): void;
postprocess_addPass(name: string, shaderHandle: number): number;
- postprocess_removePass(name: string): void;
- postprocess_setPassEnabled(name: string, enabled: boolean): void;
- postprocess_isPassEnabled(name: string): boolean;
postprocess_setUniformFloat(passName: string, uniform: string, value: number): void;
postprocess_setPassTexture(passName: string, uniform: string, textureHandle: number): void;
postprocess_setUniformVec4(passName: string, uniform: string, x: number, y: number, z: number, w: number): void;
postprocess_begin(): void;
postprocess_end(): void;
- postprocess_getPassCount(): number;
postprocess_isInitialized(): boolean;
postprocess_setBypass(bypass: boolean): void;
- postprocess_isBypassed(): boolean;
postprocess_clearPasses(): void;
- postprocess_setOutputTarget(fboId: number): void;
postprocess_setOutputViewport(x: number, y: number, w: number, h: number): void;
postprocess_beginScreenCapture(): void;
postprocess_endScreenCapture(): void;
@@ -435,11 +406,6 @@ export interface ESEngineModule {
clearX: number, clearY: number, clearW: number, clearH: number): void;
renderer_flush(): void;
renderer_end(): void;
- renderer_submitSprites(registry: CppRegistry): void;
- renderer_submitUIElements(registry: CppRegistry): void;
- renderer_submitBitmapText(registry: CppRegistry): void;
- renderer_submitShapes?(registry: CppRegistry): void;
- renderer_submitParticles?(registry: CppRegistry): void;
renderer_submitAll(registry: CppRegistry, vpX: number, vpY: number, vpW: number, vpH: number): void;
particle_update?(registry: CppRegistry, dt: number): void;
particle_play?(registry: CppRegistry, entity: number): void;
@@ -513,16 +479,7 @@ export interface ESEngineModule {
engine_setRandomSeed?(seed: number): void;
renderer_setTextureParams(textureId: number, minFilter: number, magFilter: number, wrapS: number, wrapT: number): void;
- // Clip Rect API
- renderer_setEntityClipRect(entity: number, x: number, y: number, w: number, h: number): void;
- renderer_clearEntityClipRect(entity: number): void;
- renderer_clearAllClipRects(): void;
- // Stencil API
- renderer_setEntityStencilMask(entity: number, refValue: number): void;
- renderer_setEntityStencilTest(entity: number, refValue: number): void;
- renderer_clearEntityStencilMask(entity: number): void;
- renderer_clearAllStencilMasks(): void;
// ECS Query API
registry_getCanvasEntity(registry: CppRegistry): number;
@@ -572,7 +529,6 @@ export interface ESEngineModule {
uiLayout_update(registry: CppRegistry, boxLeft: number, boxBottom: number, boxRight: number, boxTop: number, propertyDirty: boolean): void;
uiHitTest_update(registry: CppRegistry, mouseWorldX: number, mouseWorldY: number): void;
uiHitTest_getHitEntity(): number;
- uiHitTest_getHitEntityPrev(): number;
uiHitTest_pick?(registry: CppRegistry, worldX: number, worldY: number): number;
uiHitTest_pickAll?(registry: CppRegistry, worldX: number, worldY: number): number;
uiHitTest_pickResult?(index: number): number;
@@ -584,10 +540,7 @@ export interface ESEngineModule {
getUINodeHiddenInTree?(registry: CppRegistry, entity: number): boolean;
/** Subtree opacity resolved by the layout pass (UINode.opacity multiplied down). */
getUINodeAlphaInTree?(registry: CppRegistry, entity: number): number;
- /** True when this node or an ancestor set pointerEvents = None. */
- getUINodePointerBlockedInTree?(registry: CppRegistry, entity: number): boolean;
transform_update(registry: CppRegistry): void;
- transform_patchPosition(registry: CppRegistry, entity: number, x: number, y: number, z: number): void;
// Animation (Tween) API
anim_createTween(registry: CppRegistry, entity: number, targetProp: number,
diff --git a/src/esengine/bindings/PostProcessBindings.cpp b/src/esengine/bindings/PostProcessBindings.cpp
index fa11a346f..486b3324e 100644
--- a/src/esengine/bindings/PostProcessBindings.cpp
+++ b/src/esengine/bindings/PostProcessBindings.cpp
@@ -65,23 +65,6 @@ u32 postprocess_addPass(const std::string& name, u32 shaderHandle) {
return g_postProcessPipeline->addPass(name, resource::ShaderHandle(shaderHandle));
}
-void postprocess_removePass(const std::string& name) {
- if (g_postProcessPipeline) {
- g_postProcessPipeline->removePass(name);
- }
-}
-
-void postprocess_setPassEnabled(const std::string& name, bool enabled) {
- if (g_postProcessPipeline) {
- g_postProcessPipeline->setPassEnabled(name, enabled);
- }
-}
-
-bool postprocess_isPassEnabled(const std::string& name) {
- if (!g_postProcessPipeline) return false;
- return g_postProcessPipeline->isPassEnabled(name);
-}
-
void postprocess_setUniformFloat(const std::string& passName,
const std::string& uniform, f32 value) {
if (g_postProcessPipeline) {
@@ -123,11 +106,6 @@ void postprocess_end() {
}
}
-u32 postprocess_getPassCount() {
- if (!g_postProcessPipeline) return 0;
- return g_postProcessPipeline->getPassCount();
-}
-
bool postprocess_isInitialized() {
if (!g_postProcessPipeline) return false;
return g_postProcessPipeline->isInitialized();
@@ -139,23 +117,12 @@ void postprocess_setBypass(bool bypass) {
}
}
-bool postprocess_isBypassed() {
- if (!g_postProcessPipeline) return true;
- return g_postProcessPipeline->isBypassed();
-}
-
void postprocess_clearPasses() {
if (g_postProcessPipeline) {
g_postProcessPipeline->clearPasses();
}
}
-void postprocess_setOutputTarget(u32 fboId) {
- if (g_postProcessPipeline) {
- g_postProcessPipeline->setOutputTarget(FramebufferHandle{fboId});
- }
-}
-
void postprocess_setOutputViewport(u32 x, u32 y, u32 w, u32 h) {
if (g_postProcessPipeline) {
g_postProcessPipeline->setOutputViewport(x, y, w, h);
diff --git a/src/esengine/bindings/PostProcessBindings.hpp b/src/esengine/bindings/PostProcessBindings.hpp
index 9415db262..c2b7e141f 100644
--- a/src/esengine/bindings/PostProcessBindings.hpp
+++ b/src/esengine/bindings/PostProcessBindings.hpp
@@ -12,9 +12,6 @@ bool postprocess_init(u32 width, u32 height);
void postprocess_shutdown();
void postprocess_resize(u32 width, u32 height);
u32 postprocess_addPass(const std::string& name, u32 shaderHandle);
-void postprocess_removePass(const std::string& name);
-void postprocess_setPassEnabled(const std::string& name, bool enabled);
-bool postprocess_isPassEnabled(const std::string& name);
void postprocess_setUniformFloat(const std::string& passName,
const std::string& uniform, f32 value);
void postprocess_setPassTexture(const std::string& passName,
@@ -24,12 +21,9 @@ void postprocess_setUniformVec4(const std::string& passName,
f32 x, f32 y, f32 z, f32 w);
void postprocess_begin();
void postprocess_end();
-u32 postprocess_getPassCount();
bool postprocess_isInitialized();
void postprocess_setBypass(bool bypass);
-bool postprocess_isBypassed();
void postprocess_clearPasses();
-void postprocess_setOutputTarget(u32 fboId);
void postprocess_setOutputViewport(u32 x, u32 y, u32 w, u32 h);
void postprocess_beginScreenCapture();
diff --git a/src/esengine/bindings/RendererBindings.cpp b/src/esengine/bindings/RendererBindings.cpp
index 466c449b7..364bfa1ac 100644
--- a/src/esengine/bindings/RendererBindings.cpp
+++ b/src/esengine/bindings/RendererBindings.cpp
@@ -193,47 +193,6 @@ void meshRenderer_setGeometry(ecs::Registry& registry, u32 entity,
// Geometry that STAYS on the GPU: interleaved f32 [x,y,z,u,v] plus optional RGBA8
// colors, validated exactly as the inline path is. createMesh appends the
// per-object transform, so nothing here knows how a mesh reaches the shader.
-u32 mesh_create(uintptr_t posUvPtr, u32 vertexCount, uintptr_t colorsPtr,
- uintptr_t indicesPtr, u32 indexCount) {
- auto* rm = ctx().tryGet<resource::ResourceManager>();
- if (!rm || posUvPtr == 0 || indicesPtr == 0 || vertexCount == 0 || indexCount == 0) return 0;
- if (indexCount % 3 != 0) {
- ES_LOG_WARN("mesh_create: indexCount {} is not a triangle list; rejected", indexCount);
- return 0;
- }
-
- const f32* posUv = boundarySpan<f32>(posUvPtr, static_cast<u64>(vertexCount) * 5, "mesh_create.posUv");
- const u32* colors = colorsPtr ? boundarySpan<u32>(colorsPtr, vertexCount, "mesh_create.colors") : nullptr;
- const u32* indices = boundarySpan<u32>(indicesPtr, indexCount, "mesh_create.indices");
- if (!posUv || !indices || (colorsPtr && !colors)) return 0;
-
- for (u32 i = 0; i < indexCount; ++i) {
- if (indices[i] >= vertexCount) {
- ES_LOG_WARN("mesh_create: index {} out of range (vertexCount {}); rejected",
- indices[i], vertexCount);
- return 0;
- }
- }
-
- struct MeshVertex { f32 x, y, z, u, v; u32 color; };
- static_assert(sizeof(MeshVertex) == 24, "vertex stride must match the mesh layout");
- std::vector<MeshVertex> verts(vertexCount);
- glm::vec3 mn(posUv[0], posUv[1], posUv[2]);
- glm::vec3 mx = mn;
- for (u32 i = 0; i < vertexCount; ++i) {
- const f32* p = posUv + i * 5;
- verts[i] = { p[0], p[1], p[2], p[3], p[4], colors ? colors[i] : 0xFFFFFFFFu };
- mn = glm::min(mn, glm::vec3(p[0], p[1], p[2]));
- mx = glm::max(mx, glm::vec3(p[0], p[1], p[2]));
- }
-
- auto handle = rm->createMesh(
- ConstSpan<u8>(reinterpret_cast<const u8*>(verts.data()), verts.size() * sizeof(MeshVertex)),
- ConstSpan<u32>(indices, indexCount),
- ConstSpan<GfxVertexAttribute>(kStandardMeshChannels, 3), sizeof(MeshVertex), mn, mx);
- return handle.id();
-}
-
// Geometry from an .esmesh. The channel table arrives in the file's own layout
// (8 bytes each), so the asset layer owns the FORMAT and the engine owns the
// vertex layout it becomes. A channel's semantic is its attribute location.
@@ -362,10 +321,6 @@ u32 freezeMeshGeometry(ecs::MeshRenderer* mesh) {
}
} // namespace
-u32 meshRenderer_makeResident(ecs::Registry& registry, u32 entity) {
- return freezeMeshGeometry(registry.tryGet<ecs::MeshRenderer>(Entity::fromRaw(entity)));
-}
-
u32 meshRenderer_setMeshAll(ecs::Registry& registry, u32 meshHandle) {
u32 pointed = 0;
for (auto entity : registry.view<ecs::MeshRenderer>()) {
@@ -401,49 +356,6 @@ u32 meshRenderer_makeAllResident(ecs::Registry& registry) {
}
/** @brief Points a MeshRenderer at resident geometry; 0 returns it to its inline payload. */
-void meshRenderer_setMesh(ecs::Registry& registry, u32 entity, u32 meshHandle) {
- const Entity ent = Entity::fromRaw(entity);
- auto* mesh = registry.tryGet<ecs::MeshRenderer>(ent);
- if (!mesh) {
- ES_LOG_WARN("meshRenderer_setMesh: entity {} has no MeshRenderer component", entity);
- return;
- }
- mesh->mesh = resource::MeshHandle(meshHandle);
-}
-
-void renderFrameWithMatrix(ecs::Registry& registry, i32 viewportWidth, i32 viewportHeight,
- uintptr_t matrixPtr) {
- 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));
-
- const f32* matrixData = boundarySpan<f32>(matrixPtr, 16, "renderFrameWithMatrix.matrix");
- if (!matrixData) return;
- glm::mat4 viewProjection = glm::make_mat4(matrixData);
-
- 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 renderer_init(u32 width, u32 height) {
if (!g_renderFrame) return;
ctx().state().viewport_width = width;
@@ -505,29 +417,11 @@ static void ensureTransformsUpdated(ecs::Registry& registry) {
}
}
-void renderer_submitSprites(ecs::Registry& registry) {
- (void)registry;
-}
-
-void renderer_submitUIElements(ecs::Registry& registry) {
- (void)registry;
-}
-
#ifdef ES_ENABLE_BITMAP_TEXT
-void renderer_submitBitmapText(ecs::Registry& registry) {
- (void)registry;
-}
#endif
-void renderer_submitShapes(ecs::Registry& registry) {
- (void)registry;
-}
-
#ifdef ES_ENABLE_PARTICLES
-void renderer_submitParticles(ecs::Registry& registry) {
- (void)registry;
-}
#endif
void renderer_updateTransforms(ecs::Registry& registry) {
@@ -824,48 +718,6 @@ void renderer_diagnose() {
ES_LOG_INFO("[Diagnose] No pending GL errors (cleared)");
}
-void renderer_setEntityClipRect(u32 entity, i32 x, i32 y, i32 w, i32 h) {
- if (g_renderFrame) {
- g_renderFrame->setEntityClipRect(entity, x, y, w, h);
- }
-}
-
-void renderer_clearEntityClipRect(u32 entity) {
- if (g_renderFrame) {
- g_renderFrame->clearEntityClipRect(entity);
- }
-}
-
-void renderer_clearAllClipRects() {
- if (g_renderFrame) {
- g_renderFrame->clearAllClipRects();
- }
-}
-
-void renderer_setEntityStencilMask(u32 entity, i32 refValue) {
- if (g_renderFrame) {
- g_renderFrame->setEntityStencilMask(entity, refValue);
- }
-}
-
-void renderer_setEntityStencilTest(u32 entity, i32 refValue) {
- if (g_renderFrame) {
- g_renderFrame->setEntityStencilTest(entity, refValue);
- }
-}
-
-void renderer_clearEntityStencilMask(u32 entity) {
- if (g_renderFrame) {
- g_renderFrame->clearEntityStencilMask(entity);
- }
-}
-
-void renderer_clearAllStencilMasks() {
- if (g_renderFrame) {
- g_renderFrame->clearAllStencilMasks();
- }
-}
-
void gl_enableErrorCheck(bool enabled) {
ctx().state().gl_error_check_enabled = enabled;
if (enabled) {
diff --git a/src/esengine/bindings/RendererBindings.hpp b/src/esengine/bindings/RendererBindings.hpp
index 1a15b2258..e360d2033 100644
--- a/src/esengine/bindings/RendererBindings.hpp
+++ b/src/esengine/bindings/RendererBindings.hpp
@@ -21,8 +21,6 @@ namespace ecs {
class Registry;
}
-void renderFrameWithMatrix(ecs::Registry& registry, i32 viewportWidth, i32 viewportHeight,
- uintptr_t matrixPtr);
void renderer_init(u32 width, u32 height);
void renderer_resize(u32 width, u32 height);
@@ -32,12 +30,8 @@ void renderer_begin(uintptr_t matrixPtr, u32 targetHandle, i32 clearFlags,
i32 clearX, i32 clearY, u32 clearW, u32 clearH);
void renderer_flush();
void renderer_end();
-void renderer_submitSprites(ecs::Registry& registry);
-void renderer_submitUIElements(ecs::Registry& registry);
#ifdef ES_ENABLE_BITMAP_TEXT
-void renderer_submitBitmapText(ecs::Registry& registry);
#endif
-void renderer_submitShapes(ecs::Registry& registry);
/// Geometry posed by a skeletal runtime (Spine, DragonBones): x,y,u,v,r,g,b,a per
/// vertex, drawn as @p entity's, with its material resolved as a Sprite's is.
void renderer_submitSkeletalBatchByEntity(
@@ -76,13 +70,6 @@ u32 environment_create(uintptr_t shPtr, u32 specularHandle, f32 faceSize, u32 mi
/** @brief Releases an environment; its atlas is an ordinary texture and outlives it. */
void environment_release(u32 environmentHandle);
-/** @brief Uploads geometry that stays on the GPU; returns its handle, 0 on failure. */
-u32 mesh_create(uintptr_t posUvPtr, u32 vertexCount, uintptr_t colorsPtr,
- uintptr_t indicesPtr, u32 indexCount);
-/** @brief Points a MeshRenderer at resident geometry; 0 returns it to its inline payload. */
-void meshRenderer_setMesh(ecs::Registry& registry, u32 entity, u32 meshHandle);
-/** @brief Freezes a MeshRenderer's inline geometry onto the GPU; returns its handle. */
-u32 meshRenderer_makeResident(ecs::Registry& registry, u32 entity);
/** @brief Freezes every MeshRenderer in the world; returns how many were frozen. */
u32 meshRenderer_makeAllResident(ecs::Registry& registry);
/** @brief Points every MeshRenderer at one resident mesh; returns how many. */
@@ -90,7 +77,6 @@ u32 meshRenderer_setMeshAll(ecs::Registry& registry, u32 meshHandle);
/** @brief Points every MeshRenderer at one material; returns how many. */
u32 meshRenderer_setMaterialAll(ecs::Registry& registry, u32 materialId);
#ifdef ES_ENABLE_PARTICLES
-void renderer_submitParticles(ecs::Registry& registry);
#endif
void renderer_updateTransforms(ecs::Registry& registry);
void renderer_setEntityDrawOrder(ecs::Registry& registry, uintptr_t entitiesPtr, u32 count);
@@ -145,14 +131,7 @@ void renderer_setCullingMask(u32 mask);
/** Project colorSpace: 1 = linear-light rendering (set before shaders compile). */
void renderer_setColorSpace(u32 linear);
void renderer_diagnose();
-void renderer_setEntityClipRect(u32 entity, i32 x, i32 y, i32 w, i32 h);
-void renderer_clearEntityClipRect(u32 entity);
-void renderer_clearAllClipRects();
-
-void renderer_setEntityStencilMask(u32 entity, i32 refValue);
-void renderer_setEntityStencilTest(u32 entity, i32 refValue);
-void renderer_clearEntityStencilMask(u32 entity);
-void renderer_clearAllStencilMasks();
+
void gl_enableErrorCheck(bool enabled);
u32 gl_checkErrors(const std::string& context);
diff --git a/src/esengine/bindings/UIBindings.cpp b/src/esengine/bindings/UIBindings.cpp
index 53cb49095..fdcdbfe7f 100644
--- a/src/esengine/bindings/UIBindings.cpp
+++ b/src/esengine/bindings/UIBindings.cpp
@@ -40,10 +40,6 @@ u32 uiHitTest_getHitEntity() {
return ctx().require<ecs::UISystem>().getHitEntity();
}
-u32 uiHitTest_getHitEntityPrev() {
- return ctx().require<ecs::UISystem>().getPrevHitEntity();
-}
-
u32 uiHitTest_pick(ecs::Registry& registry, f32 worldX, f32 worldY) {
return ctx().require<ecs::UISystem>().pick(registry, worldX, worldY);
}
@@ -102,11 +98,6 @@ f32 getUINodeAlphaInTree(ecs::Registry& registry, u32 entity) {
return node ? node->alpha_in_tree_ : 1.0f;
}
-bool getUINodePointerBlockedInTree(ecs::Registry& registry, u32 entity) {
- auto* node = registry.tryGet<ecs::UINode>(Entity::fromRaw(entity));
- return node && node->pointer_blocked_in_tree_;
-}
-
f32 getUINodeComputedWidth(ecs::Registry& registry, u32 entity) {
auto* node = registry.tryGet<ecs::UINode>(Entity::fromRaw(entity));
if (!node) return 0.0f;
@@ -129,11 +120,4 @@ void transform_update(ecs::Registry& registry) {
}
}
-void transform_patchPosition(ecs::Registry& registry, u32 entity,
- f32 x, f32 y, f32 z) {
- auto* transform = registry.tryGet<ecs::Transform>(Entity::fromRaw(entity));
- if (!transform) return;
- transform->position = {x, y, z};
-}
-
} // namespace esengine
diff --git a/src/esengine/bindings/UIBindings.hpp b/src/esengine/bindings/UIBindings.hpp
index e416744f3..885b5a7e6 100644
--- a/src/esengine/bindings/UIBindings.hpp
+++ b/src/esengine/bindings/UIBindings.hpp
@@ -30,7 +30,6 @@ void uiLayout_update(ecs::Registry& registry, f32 boxLeft, f32 boxBottom, f32 bo
void uiHitTest_update(ecs::Registry& registry, f32 mouseWorldX, f32 mouseWorldY);
u32 uiHitTest_getHitEntity();
-u32 uiHitTest_getHitEntityPrev();
u32 uiHitTest_pick(ecs::Registry& registry, f32 worldX, f32 worldY);
u32 uiHitTest_pickAll(ecs::Registry& registry, f32 worldX, f32 worldY);
u32 uiHitTest_pickResult(u32 index);
@@ -53,13 +52,10 @@ u32 ui_getCullBit(ecs::Registry& registry, u32 entity);
bool getUINodeHiddenInTree(ecs::Registry& registry, u32 entity);
/** Subtree opacity resolved by the layout pass (UINode.opacity multiplied down). */
f32 getUINodeAlphaInTree(ecs::Registry& registry, u32 entity);
-/** True when this node or an ancestor set pointerEvents = None. */
-bool getUINodePointerBlockedInTree(ecs::Registry& registry, u32 entity);
f32 getUINodeComputedWidth(ecs::Registry& registry, u32 entity);
f32 getUINodeComputedHeight(ecs::Registry& registry, u32 entity);
/** Compose world transforms now (the UI layout pass reads them). */
void transform_update(ecs::Registry& registry);
-void transform_patchPosition(ecs::Registry& registry, u32 entity, f32 x, f32 y, f32 z);
} // namespace esengine
diff --git a/src/esengine/bindings/WebSDKEntry.cpp b/src/esengine/bindings/WebSDKEntry.cpp
index 5c9a8a545..ad4a12922 100644
--- a/src/esengine/bindings/WebSDKEntry.cpp
+++ b/src/esengine/bindings/WebSDKEntry.cpp
@@ -231,10 +231,6 @@ void initRenderer() {
initRendererInternal("#canvas");
}
-bool initRendererWithCanvas(const std::string& canvasSelector) {
- return initRendererInternal(canvasSelector.c_str());
-}
-
bool initRendererWithContext(int contextHandle) {
if (g_initialized) return true;
if (contextHandle <= 0) {
@@ -463,13 +459,11 @@ EMSCRIPTEN_BINDINGS(esengine_context) {
EMSCRIPTEN_BINDINGS(esengine_renderer) {
emscripten::function("initRenderer", &esengine::initRenderer);
- emscripten::function("initRendererWithCanvas", &esengine::initRendererWithCanvas);
emscripten::function("initRendererWithContext", &esengine::initRendererWithContext);
// Registered in every build variant; without ES_ENABLE_WEBGPU it reports
// and returns false, so the JS surface never drifts across variants.
emscripten::function("initRendererWebGPU", &esengine::initRendererWebGPU);
emscripten::function("shutdownRenderer", &esengine::shutdownRenderer);
- emscripten::function("renderFrameWithMatrix", &esengine::renderFrameWithMatrix);
emscripten::function("getResourceManager", &esengine::getResourceManager, emscripten::allow_raw_pointers());
emscripten::function("sdfFromAlpha", &esengine::web_sdfFromAlpha);
emscripten::function("deviceStatus", &esengine::deviceStatus);
@@ -519,14 +513,11 @@ EMSCRIPTEN_BINDINGS(esengine_renderer) {
emscripten::function("renderer_submitSkeletalBatchByEntity", &esengine::renderer_submitSkeletalBatchByEntity);
emscripten::function("renderer_submitTextBatch", &esengine::renderer_submitTextBatch);
emscripten::function("meshRenderer_setGeometry", &esengine::meshRenderer_setGeometry);
- emscripten::function("mesh_create", &esengine::mesh_create);
emscripten::function("mesh_createFromChannels", &esengine::mesh_createFromChannels);
emscripten::function("mesh_release", &esengine::mesh_release);
emscripten::function("environment_create", &esengine::environment_create);
emscripten::function("environment_release", &esengine::environment_release);
- emscripten::function("meshRenderer_setMesh", &esengine::meshRenderer_setMesh);
emscripten::function("meshRenderer_localBounds", &esengine::meshRenderer_localBounds);
- emscripten::function("meshRenderer_makeResident", &esengine::meshRenderer_makeResident);
emscripten::function("meshRenderer_makeAllResident", &esengine::meshRenderer_makeAllResident);
emscripten::function("meshRenderer_setMeshAll", &esengine::meshRenderer_setMeshAll);
emscripten::function("meshRenderer_setMaterialAll", &esengine::meshRenderer_setMaterialAll);
@@ -572,20 +563,14 @@ EMSCRIPTEN_BINDINGS(esengine_renderer) {
emscripten::function("postprocess_shutdown", &esengine::postprocess_shutdown);
emscripten::function("postprocess_resize", &esengine::postprocess_resize);
emscripten::function("postprocess_addPass", &esengine::postprocess_addPass);
- emscripten::function("postprocess_removePass", &esengine::postprocess_removePass);
- emscripten::function("postprocess_setPassEnabled", &esengine::postprocess_setPassEnabled);
- emscripten::function("postprocess_isPassEnabled", &esengine::postprocess_isPassEnabled);
emscripten::function("postprocess_setUniformFloat", &esengine::postprocess_setUniformFloat);
emscripten::function("postprocess_setUniformVec4", &esengine::postprocess_setUniformVec4);
emscripten::function("postprocess_setPassTexture", &esengine::postprocess_setPassTexture);
emscripten::function("postprocess_begin", &esengine::postprocess_begin);
emscripten::function("postprocess_end", &esengine::postprocess_end);
- emscripten::function("postprocess_getPassCount", &esengine::postprocess_getPassCount);
emscripten::function("postprocess_isInitialized", &esengine::postprocess_isInitialized);
emscripten::function("postprocess_setBypass", &esengine::postprocess_setBypass);
- emscripten::function("postprocess_isBypassed", &esengine::postprocess_isBypassed);
emscripten::function("postprocess_clearPasses", &esengine::postprocess_clearPasses);
- emscripten::function("postprocess_setOutputTarget", &esengine::postprocess_setOutputTarget);
emscripten::function("postprocess_setOutputViewport", &esengine::postprocess_setOutputViewport);
emscripten::function("postprocess_beginScreenCapture", &esengine::postprocess_beginScreenCapture);
emscripten::function("postprocess_endScreenCapture", &esengine::postprocess_endScreenCapture);
@@ -635,15 +620,10 @@ EMSCRIPTEN_BINDINGS(esengine_renderer) {
emscripten::function("renderer_begin", &esengine::renderer_begin);
emscripten::function("renderer_flush", &esengine::renderer_flush);
emscripten::function("renderer_end", &esengine::renderer_end);
- emscripten::function("renderer_submitSprites", &esengine::renderer_submitSprites);
- emscripten::function("renderer_submitUIElements", &esengine::renderer_submitUIElements);
#ifdef ES_ENABLE_BITMAP_TEXT
- emscripten::function("renderer_submitBitmapText", &esengine::renderer_submitBitmapText);
#endif
- emscripten::function("renderer_submitShapes", &esengine::renderer_submitShapes);
#ifdef ES_ENABLE_PARTICLES
- emscripten::function("renderer_submitParticles", &esengine::renderer_submitParticles);
#endif
emscripten::function("renderer_updateTransforms", &esengine::renderer_updateTransforms);
emscripten::function("renderer_setEntityDrawOrder", &esengine::renderer_setEntityDrawOrder);
@@ -685,14 +665,7 @@ EMSCRIPTEN_BINDINGS(esengine_renderer) {
emscripten::function("renderer_setDepthLayers", &esengine::renderer_setDepthLayers);
emscripten::function("renderer_setCullingMask", &esengine::renderer_setCullingMask);
emscripten::function("renderer_setColorSpace", &esengine::renderer_setColorSpace);
- emscripten::function("renderer_setEntityClipRect", &esengine::renderer_setEntityClipRect);
- emscripten::function("renderer_clearEntityClipRect", &esengine::renderer_clearEntityClipRect);
- emscripten::function("renderer_clearAllClipRects", &esengine::renderer_clearAllClipRects);
- emscripten::function("renderer_setEntityStencilMask", &esengine::renderer_setEntityStencilMask);
- emscripten::function("renderer_setEntityStencilTest", &esengine::renderer_setEntityStencilTest);
- emscripten::function("renderer_clearEntityStencilMask", &esengine::renderer_clearEntityStencilMask);
- emscripten::function("renderer_clearAllStencilMasks", &esengine::renderer_clearAllStencilMasks);
emscripten::function("registry_getCanvasEntity", &esengine::registry_getCanvasEntity);
emscripten::function("registry_getCanvasEntities", &esengine::registry_getCanvasEntities);
@@ -735,7 +708,6 @@ EMSCRIPTEN_BINDINGS(esengine_ui_systems) {
emscripten::function("uiLayout_update", &esengine::uiLayout_update);
emscripten::function("uiHitTest_update", &esengine::uiHitTest_update);
emscripten::function("uiHitTest_getHitEntity", &esengine::uiHitTest_getHitEntity);
- emscripten::function("uiHitTest_getHitEntityPrev", &esengine::uiHitTest_getHitEntityPrev);
emscripten::function("uiHitTest_pick", &esengine::uiHitTest_pick);
emscripten::function("uiHitTest_pickAll", &esengine::uiHitTest_pickAll);
emscripten::function("uiHitTest_pickResult", &esengine::uiHitTest_pickResult);
@@ -746,11 +718,9 @@ EMSCRIPTEN_BINDINGS(esengine_ui_systems) {
emscripten::function("ui_getCullBit", &esengine::ui_getCullBit);
emscripten::function("getUINodeHiddenInTree", &esengine::getUINodeHiddenInTree);
emscripten::function("getUINodeAlphaInTree", &esengine::getUINodeAlphaInTree);
- emscripten::function("getUINodePointerBlockedInTree", &esengine::getUINodePointerBlockedInTree);
emscripten::function("getUINodeComputedWidth", &esengine::getUINodeComputedWidth);
emscripten::function("getUINodeComputedHeight", &esengine::getUINodeComputedHeight);
emscripten::function("transform_update", &esengine::transform_update);
- emscripten::function("transform_patchPosition", &esengine::transform_patchPosition);
// Tweens (AnimationBindings.hpp) — the same declarations the native
// wrappers are generated from.
diff --git a/src/esengine/renderer/frame/PostProcessPipeline.cpp b/src/esengine/renderer/frame/PostProcessPipeline.cpp
index 77768098b..21d7bd0df 100644
--- a/src/esengine/renderer/frame/PostProcessPipeline.cpp
+++ b/src/esengine/renderer/frame/PostProcessPipeline.cpp
@@ -203,31 +203,6 @@ void PostProcessPipeline::releasePassResources(PostProcessPass& pass) {
}
}
-void PostProcessPipeline::removePass(const std::string& name) {
- auto it = std::find_if(passes_.begin(), passes_.end(),
- [&name](const PostProcessPass& p) { return p.name == name; });
-
- if (it != passes_.end()) {
- releasePassResources(*it);
- passes_.erase(it);
- }
-}
-
-void PostProcessPipeline::setPassEnabled(const std::string& name, bool enabled) {
- if (auto* pass = findPass(name)) {
- pass->enabled = enabled;
- }
-}
-
-bool PostProcessPipeline::isPassEnabled(const std::string& name) const {
- for (const auto& pass : passes_) {
- if (pass.name == name) {
- return pass.enabled;
- }
- }
- return false;
-}
-
void PostProcessPipeline::setPassUniformFloat(const std::string& passName,
const std::string& uniform, f32 value) {
if (auto* pass = findPass(passName)) {
diff --git a/src/esengine/renderer/frame/PostProcessPipeline.hpp b/src/esengine/renderer/frame/PostProcessPipeline.hpp
index bb865074d..987573e1a 100644
--- a/src/esengine/renderer/frame/PostProcessPipeline.hpp
+++ b/src/esengine/renderer/frame/PostProcessPipeline.hpp
@@ -99,20 +99,8 @@ public:
*/
u32 addPass(const std::string& name, resource::ShaderHandle shader);
- /**
- * @brief Removes a pass by name
- */
- void removePass(const std::string& name);
- /**
- * @brief Enables or disables a pass
- */
- void setPassEnabled(const std::string& name, bool enabled);
- /**
- * @brief Checks if a pass is enabled
- */
- bool isPassEnabled(const std::string& name) const;
/**
* @brief Sets a float uniform for a pass
@@ -280,7 +268,7 @@ private:
void runChain(std::vector<PostProcessPass>& passes, TextureHandle sceneTexture);
/// The chain's last pass: the copy into the output target's viewport.
void blitPass();
- /// Frees a pass's GPU-side param UBO (removePass/clearPasses/shutdown).
+ /// Frees a pass's GPU-side param UBO (clearPasses/shutdown).
void releasePassResources(PostProcessPass& pass);
GfxDevice& device_;
diff --git a/src/esengine/renderer/frame/RenderFrame.cpp b/src/esengine/renderer/frame/RenderFrame.cpp
index c7a74506b..ef3b14e00 100644
--- a/src/esengine/renderer/frame/RenderFrame.cpp
+++ b/src/esengine/renderer/frame/RenderFrame.cpp
@@ -591,10 +591,6 @@ void RenderFrame::setEntityClipRect(u32 entity, i32 x, i32 y, i32 w, i32 h) {
clip_rects_[entity] = ScissorRect{x, y, w, h};
}
-void RenderFrame::clearEntityClipRect(u32 entity) {
- clip_rects_.erase(entity);
-}
-
void RenderFrame::clearAllClipRects() {
clip_rects_.clear();
}
@@ -607,10 +603,6 @@ void RenderFrame::setEntityStencilTest(u32 entity, i32 refValue) {
stencil_masks_[entity] = {refValue, false};
}
-void RenderFrame::clearEntityStencilMask(u32 entity) {
- stencil_masks_.erase(entity);
-}
-
void RenderFrame::clearAllStencilMasks() {
stencil_masks_.clear();
}
diff --git a/src/esengine/renderer/frame/RenderFrame.hpp b/src/esengine/renderer/frame/RenderFrame.hpp
index 3db33189f..62b872c17 100644
--- a/src/esengine/renderer/frame/RenderFrame.hpp
+++ b/src/esengine/renderer/frame/RenderFrame.hpp
@@ -142,12 +142,10 @@ public:
void processMasks(ecs::Registry& registry, i32 vpX, i32 vpY, i32 vpW, i32 vpH);
void setEntityClipRect(u32 entity, i32 x, i32 y, i32 w, i32 h);
- void clearEntityClipRect(u32 entity);
void clearAllClipRects();
void setEntityStencilMask(u32 entity, i32 refValue);
void setEntityStencilTest(u32 entity, i32 refValue);
- void clearEntityStencilMask(u32 entity);
void clearAllStencilMasks();
void submitTileQuad(
diff --git a/tools/check-engine-exports.mjs b/tools/check-engine-exports.mjs
new file mode 100644
index 000000000..f8c2eb2f9
--- /dev/null
+++ b/tools/check-engine-exports.mjs
@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
+/**
+ * @file check-engine-exports.mjs
+ * @brief Every entry point the engine offers a host must have a caller.
+ * @details An export nobody calls is a capability that cannot be wrong, because
+ * nothing exercises it — and it reads as one the engine supports. This
+ * found five submit entry points whose bodies were `(void)registry;`.
+ *
+ * Run: node tools/check-engine-exports.mjs (exit 1 on an unreachable export)
+ */
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { listTrackedSources } from './lib/sourceRoots.mjs';
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const ENTRY = 'src/esengine/bindings/WebSDKEntry.cpp';
+
+const entry = readFileSync(path.join(ROOT, ENTRY), 'utf8');
+const exported = [...entry.matchAll(/emscripten::function\("(\w+)"/g)].map((m) => m[1]);
+
+// The pointer accessors are reached by NAME, out of the generated layout table —
+// derived from it rather than listed here, so a new component cannot look dead.
+const layouts = readFileSync(path.join(ROOT, 'sdk/src/wasm/ptrLayouts.generated.ts'), 'utf8');
+const byName = new Set([...layouts.matchAll(/ptrFn:\s*'(\w+)'/g)].map((m) => m[1]));
+
+// Tests count as callers here: what a binding does to a registry can only be
+// read back through another binding. `wasm.ts` declares the surface rather than
+// calling it, and generated files name every entry by construction.
+const { files, missing } = listTrackedSources(
+ ['sdk/src', 'sdk/tests', 'desktop/src', 'desktop/electron', 'desktop/tests', 'tools', 'pipeline/src']);
+if (missing.length) {
+ console.log(`check-engine-exports: no editor checkout — ${missing.join(', ')} not scanned for callers.`);
+}
+const texts = files
+ .filter((f) => /\.(ts|tsx|mjs|js)$/.test(f) && !f.includes('.generated.') && f !== 'sdk/src/wasm.ts')
+ .map((f) => readFileSync(path.join(ROOT, f), 'utf8'));
+
+const unreachable = exported.filter((name) => {
+ if (byName.has(name)) return false;
+ const re = new RegExp(`\\b${name}\\b`);
+ return !texts.some((t) => re.test(t));
+});
+
+if (unreachable.length > 0) {
+ console.error(`${unreachable.length} engine export(s) no host calls:\n`);
+ for (const n of unreachable) console.error(` ${n}`);
+ console.error(`\nEither wire it up or drop it from ${ENTRY}: an export with no caller`
+ + ' is a capability nothing can find wrong.');
+ process.exit(1);
+}
+
+console.log(`check-engine-exports: ${exported.length} export(s), every one of them reachable`
+ + ` (${byName.size} through the generated pointer table).`);
diff --git a/tools/gates.mjs b/tools/gates.mjs
index 6805ef562..f18fc6d61 100644
--- a/tools/gates.mjs
+++ b/tools/gates.mjs
@@ -32,6 +32,7 @@ export const GATES = [
{ id: 'gl-boundary', run: 'node tools/check-gl-boundary.mjs' },
{ id: 'draw-command-boundary', run: 'node tools/check-draw-command-boundary.mjs' },
{ id: 'sidemodule-gates', run: 'node tools/check-sidemodule-gates.mjs' },
+ { id: 'engine-exports', run: 'node tools/check-engine-exports.mjs' },
{
id: 'native-bindings',
run: 'node tools/check-native-bindings.mjs',