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.

fix(bindings): the three hand-written pointer accessors follow their component

yhh77df69745acc
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0ecebd4bc..e902ab795 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -72,7 +72,10 @@ published separately; it ships inside the editor.
**Breaking for code.** A script importing any of these from `esengine` must
import the new name; the data interfaces follow their component
- (`RigidBodyData` → `RigidBody2DData`).
+ (`RigidBodyData` → `RigidBody2DData`). The three hand-written pointer
+ accessors follow their component too — `getRigidBodyPtr` is
+ `getRigidBody2DPtr`, and the box and circle collider ones with it — so the
+ zero-copy path reaches the same names the generated layout table asks for.
- **The SDK's flat physics surface follows, spelled the way `physics3d/` already
spells its own.** `Physics` → `Physics2D`, `PhysicsAPI` → `Physics2DAPI`,
diff --git a/desktop b/desktop
index 2fabb4f89..297202463 160000
--- a/desktop
+++ b/desktop
@@ -1 +1 @@
-Subproject commit 2fabb4f89c8074f289ae9b57565b775f83623d6c
+Subproject commit 29720246319ccb453ef23aac7456864721c03525
diff --git a/sdk/benchmarks/wasm-vs-world.bench.ts b/sdk/benchmarks/wasm-vs-world.bench.ts
index 5c92df0ab..3d9a46135 100644
--- a/sdk/benchmarks/wasm-vs-world.bench.ts
+++ b/sdk/benchmarks/wasm-vs-world.bench.ts
@@ -306,11 +306,11 @@ describe('Ptr-based getter vs embind - Camera', () => {
});
describe('Ptr-based getter vs embind - RigidBody2D', () => {
- bench('embind: getRigidBody x100', () => {
+ bench('embind: getRigidBody2D x100', () => {
const reg = new wasmModule.Registry();
const e = reg.create();
- (reg as any).addRigidBody(e, RIGIDBODY_DATA);
- for (let i = 0; i < 100; i++) (reg as any).getRigidBody(e);
+ (reg as any).addRigidBody2D(e, RIGIDBODY_DATA);
+ for (let i = 0; i < 100; i++) (reg as any).getRigidBody2D(e);
reg.delete();
});
@@ -327,11 +327,11 @@ describe('Ptr-based getter vs embind - RigidBody2D', () => {
});
describe('Ptr-based getter vs embind - BoxCollider2D', () => {
- bench('embind: getBoxCollider x100', () => {
+ bench('embind: getBoxCollider2D x100', () => {
const reg = new wasmModule.Registry();
const e = reg.create();
- (reg as any).addBoxCollider(e, BOXCOLLIDER_DATA);
- for (let i = 0; i < 100; i++) (reg as any).getBoxCollider(e);
+ (reg as any).addBoxCollider2D(e, BOXCOLLIDER_DATA);
+ for (let i = 0; i < 100; i++) (reg as any).getBoxCollider2D(e);
reg.delete();
});
@@ -348,11 +348,11 @@ describe('Ptr-based getter vs embind - BoxCollider2D', () => {
});
describe('Ptr-based getter vs embind - CircleCollider2D', () => {
- bench('embind: getCircleCollider x100', () => {
+ bench('embind: getCircleCollider2D x100', () => {
const reg = new wasmModule.Registry();
const e = reg.create();
- (reg as any).addCircleCollider(e, CIRCLECOLLIDER_DATA);
- for (let i = 0; i < 100; i++) (reg as any).getCircleCollider(e);
+ (reg as any).addCircleCollider2D(e, CIRCLECOLLIDER_DATA);
+ for (let i = 0; i < 100; i++) (reg as any).getCircleCollider2D(e);
reg.delete();
});
@@ -436,11 +436,11 @@ describe('Ptr-based setter vs embind - Velocity write', () => {
});
describe('Ptr-based setter vs embind - RigidBody2D write', () => {
- bench('embind: addRigidBody (set) x100', () => {
+ bench('embind: addRigidBody2D (set) x100', () => {
const reg = new wasmModule.Registry();
const e = reg.create();
- (reg as any).addRigidBody(e, RIGIDBODY_DATA);
- for (let i = 0; i < 100; i++) (reg as any).addRigidBody(e, RIGIDBODY_DATA);
+ (reg as any).addRigidBody2D(e, RIGIDBODY_DATA);
+ for (let i = 0; i < 100; i++) (reg as any).addRigidBody2D(e, RIGIDBODY_DATA);
reg.delete();
});
diff --git a/sdk/etc/wasm.api.md b/sdk/etc/wasm.api.md
index 73e7fad28..5554ff669 100644
--- a/sdk/etc/wasm.api.md
+++ b/sdk/etc/wasm.api.md
@@ -271,12 +271,12 @@ geometry_release: (handle: number) => void
geometry_setIndices16: (handle: number, indicesPtr: number, indexCount: number) => void
geometry_setIndices32: (handle: number, indicesPtr: number, indexCount: number) => void
geometry_updateVertices: (handle: number, verticesPtr: number, vertexCount: number, offset: number) => void
-getBoxColliderPtr: (registry: CppRegistry, entity: number) => number
+getBoxCollider2DPtr: (registry: CppRegistry, entity: number) => number
getCameraPtr: (registry: CppRegistry, entity: number) => number
getChildEntities: (registry: CppRegistry, entity: number) => number[]
-getCircleColliderPtr: (registry: CppRegistry, entity: number) => number
+getCircleCollider2DPtr: (registry: CppRegistry, entity: number) => number
getResourceManager: () => CppResourceManager
-getRigidBodyPtr: (registry: CppRegistry, entity: number) => number
+getRigidBody2DPtr: (registry: CppRegistry, entity: number) => number
getSpritePtr: (registry: CppRegistry, entity: number) => number
getTransformPtr: (registry: CppRegistry, entity: number) => number
getUINodeAlphaInTree: ((registry: CppRegistry, entity: number) => number) | undefined
diff --git a/sdk/src/wasm.ts b/sdk/src/wasm.ts
index d8d795011..8dd801261 100644
--- a/sdk/src/wasm.ts
+++ b/sdk/src/wasm.ts
@@ -562,9 +562,9 @@ export interface ESEngineModule {
getSpritePtr(registry: CppRegistry, entity: number): number;
getVelocityPtr(registry: CppRegistry, entity: number): number;
getCameraPtr(registry: CppRegistry, entity: number): number;
- getRigidBodyPtr(registry: CppRegistry, entity: number): number;
- getBoxColliderPtr(registry: CppRegistry, entity: number): number;
- getCircleColliderPtr(registry: CppRegistry, entity: number): number;
+ getRigidBody2DPtr(registry: CppRegistry, entity: number): number;
+ getBoxCollider2DPtr(registry: CppRegistry, entity: number): number;
+ getCircleCollider2DPtr(registry: CppRegistry, entity: number): number;
_malloc(size: number): number;
_free(ptr: number): void;
diff --git a/src/esengine/bindings/WebSDKEntry.cpp b/src/esengine/bindings/WebSDKEntry.cpp
index d801b7e6d..3da872a2c 100644
--- a/src/esengine/bindings/WebSDKEntry.cpp
+++ b/src/esengine/bindings/WebSDKEntry.cpp
@@ -405,19 +405,19 @@ int getCameraPtr(ecs::Registry& r, u32 e) {
return static_cast<int>(reinterpret_cast<uintptr_t>(c));
}
-int getRigidBodyPtr(ecs::Registry& r, u32 e) {
+int getRigidBody2DPtr(ecs::Registry& r, u32 e) {
auto* rb = r.tryGet<ecs::RigidBody2D>(Entity::fromRaw(e));
if (!rb) return 0;
return static_cast<int>(reinterpret_cast<uintptr_t>(rb));
}
-int getBoxColliderPtr(ecs::Registry& r, u32 e) {
+int getBoxCollider2DPtr(ecs::Registry& r, u32 e) {
auto* bc = r.tryGet<ecs::BoxCollider2D>(Entity::fromRaw(e));
if (!bc) return 0;
return static_cast<int>(reinterpret_cast<uintptr_t>(bc));
}
-int getCircleColliderPtr(ecs::Registry& r, u32 e) {
+int getCircleCollider2DPtr(ecs::Registry& r, u32 e) {
auto* cc = r.tryGet<ecs::CircleCollider2D>(Entity::fromRaw(e));
if (!cc) return 0;
return static_cast<int>(reinterpret_cast<uintptr_t>(cc));
@@ -430,9 +430,9 @@ EMSCRIPTEN_BINDINGS(esengine_ptr_access) {
emscripten::function("getSpritePtr", &esengine::getSpritePtr);
emscripten::function("getVelocityPtr", &esengine::getVelocityPtr);
emscripten::function("getCameraPtr", &esengine::getCameraPtr);
- emscripten::function("getRigidBodyPtr", &esengine::getRigidBodyPtr);
- emscripten::function("getBoxColliderPtr", &esengine::getBoxColliderPtr);
- emscripten::function("getCircleColliderPtr", &esengine::getCircleColliderPtr);
+ emscripten::function("getRigidBody2DPtr", &esengine::getRigidBody2DPtr);
+ emscripten::function("getBoxCollider2DPtr", &esengine::getBoxCollider2DPtr);
+ emscripten::function("getCircleCollider2DPtr", &esengine::getCircleCollider2DPtr);
}
// Engine instancing: expose EstellaContext as