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(particle): take entity as u32 across the wasm boundary in the Particle API

yhhf52aa8073fab
diff --git a/src/esengine/bindings/RendererBindings.cpp b/src/esengine/bindings/RendererBindings.cpp
index 8e85a2487..de01e19b1 100644
--- a/src/esengine/bindings/RendererBindings.cpp
+++ b/src/esengine/bindings/RendererBindings.cpp
@@ -310,27 +310,30 @@ void particle_update(ecs::Registry& registry, f32 dt) {
g_particleSystem->update(registry, dt);
}
-void particle_play(ecs::Registry& registry, Entity entity) {
+// The entity crosses the wasm boundary as a raw u32 (Embind has no registered
+// binding for esengine::Entity — calling with it throws "unbound types"). Rebuild
+// the Entity C++-side, matching particle_set_color_lut/set_size_lut below.
+void particle_play(ecs::Registry& registry, u32 entity) {
if (!g_particleSystem) return;
(void)registry;
- g_particleSystem->play(entity);
+ g_particleSystem->play(Entity::fromRaw(entity));
}
-void particle_stop(ecs::Registry& registry, Entity entity) {
+void particle_stop(ecs::Registry& registry, u32 entity) {
if (!g_particleSystem) return;
(void)registry;
- g_particleSystem->stop(entity);
+ g_particleSystem->stop(Entity::fromRaw(entity));
}
-void particle_reset(ecs::Registry& registry, Entity entity) {
+void particle_reset(ecs::Registry& registry, u32 entity) {
if (!g_particleSystem) return;
(void)registry;
- g_particleSystem->reset(entity);
+ g_particleSystem->reset(Entity::fromRaw(entity));
}
-u32 particle_getAliveCount(Entity entity) {
+u32 particle_getAliveCount(u32 entity) {
if (!g_particleSystem) return 0;
- return g_particleSystem->aliveCount(entity);
+ return g_particleSystem->aliveCount(Entity::fromRaw(entity));
}
void particle_set_color_lut(u32 entity, uintptr_t ptr, i32 count) {
diff --git a/src/esengine/bindings/RendererBindings.hpp b/src/esengine/bindings/RendererBindings.hpp
index f8bcea13c..e18d500ee 100644
--- a/src/esengine/bindings/RendererBindings.hpp
+++ b/src/esengine/bindings/RendererBindings.hpp
@@ -85,10 +85,10 @@ void renderer_updateTransforms(ecs::Registry& registry);
void renderer_submitAll(ecs::Registry& registry, u32 skipFlags, i32 vpX, i32 vpY, i32 vpW, i32 vpH);
#ifdef ES_ENABLE_PARTICLES
void particle_update(ecs::Registry& registry, f32 dt);
-void particle_play(ecs::Registry& registry, Entity entity);
-void particle_stop(ecs::Registry& registry, Entity entity);
-void particle_reset(ecs::Registry& registry, Entity entity);
-u32 particle_getAliveCount(Entity entity);
+void particle_play(ecs::Registry& registry, u32 entity);
+void particle_stop(ecs::Registry& registry, u32 entity);
+void particle_reset(ecs::Registry& registry, u32 entity);
+u32 particle_getAliveCount(u32 entity);
void particle_set_color_lut(u32 entity, uintptr_t ptr, i32 count);
void particle_set_size_lut(u32 entity, uintptr_t ptr, i32 count);
#endif