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.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
feat: expose rotation as euler angles X/Y/Z in editor API
esenginec766ed50a78f
diff --git a/src/esengine/bindings/EditorAPI.generated.cpp b/src/esengine/bindings/EditorAPI.generated.cppindex 1a3f5bf15..a5824fc00 100644--- a/src/esengine/bindings/EditorAPI.generated.cpp+++ b/src/esengine/bindings/EditorAPI.generated.cpp@@ -34,12 +34,21 @@#include "../ecs/components/UIRect.hpp"#include "../ecs/components/UIRenderer.hpp"#include "../ecs/components/Velocity.hpp"+#include <glm/gtc/quaternion.hpp>using namespace esengine;using namespace esengine::ecs;namespace {+// Euler (degrees) ↔ Quaternion conversion helpers+inline glm::vec3 quatToEulerDeg(const glm::quat& q) {+ return glm::degrees(glm::eulerAngles(q));+}+inline glm::quat eulerDegToQuat(const glm::vec3& deg) {+ return glm::quat(glm::radians(deg));+}+// ── Component Name List ──std::vector<std::string> editor_getComponentNames() {@@ -358,6 +367,8 @@ std::string editor_getComponentSchema(const std::string& name) {{"key":"position.x","type":"float","group":"Transform"},{"key":"position.y","type":"float","group":"Transform"},{"key":"position.z","type":"float","group":"Transform"},+ {"key":"rotation.x","type":"float","group":"Transform"},+ {"key":"rotation.y","type":"float","group":"Transform"},{"key":"rotation.z","type":"float","group":"Transform"},{"key":"scale.x","type":"float","group":"Transform"},{"key":"scale.y","type":"float","group":"Transform"},@@ -853,10 +864,24 @@ bool editor_setFloat(Registry& reg, u32 e, const std::string& comp, const std::sif (field == "position.x") { c.position.x = value; }else if (field == "position.y") { c.position.y = value; }else if (field == "position.z") { c.position.z = value; }- else if (field == "rotation.z") { c.rotation.z = value; }else if (field == "scale.x") { c.scale.x = value; }else if (field == "scale.y") { c.scale.y = value; }else if (field == "scale.z") { c.scale.z = value; }+ else if (field == "rotation.x") {+ auto euler = quatToEulerDeg(c.rotation);+ euler.x = value;+ c.rotation = eulerDegToQuat(euler);+ }+ else if (field == "rotation.y") {+ auto euler = quatToEulerDeg(c.rotation);+ euler.y = value;+ c.rotation = eulerDegToQuat(euler);+ }+ else if (field == "rotation.z") {+ auto euler = quatToEulerDeg(c.rotation);+ euler.z = value;+ c.rotation = eulerDegToQuat(euler);+ }else { return false; }return true;} else if (comp == "UIRect") {@@ -1084,10 +1109,12 @@ f32 editor_getFloat(Registry& reg, u32 e, const std::string& comp, const std::stif (field == "position.x") { return c.position.x; }else if (field == "position.y") { return c.position.y; }else if (field == "position.z") { return c.position.z; }- else if (field == "rotation.z") { return c.rotation.z; }else if (field == "scale.x") { return c.scale.x; }else if (field == "scale.y") { return c.scale.y; }else if (field == "scale.z") { return c.scale.z; }+ else if (field == "rotation.x") { return quatToEulerDeg(c.rotation).x; }+ else if (field == "rotation.y") { return quatToEulerDeg(c.rotation).y; }+ else if (field == "rotation.z") { return quatToEulerDeg(c.rotation).z; }} else if (comp == "UIRect") {if (!reg.has<esengine::ecs::UIRect>(entity)) return 0.0f;const auto& c = reg.get<esengine::ecs::UIRect>(entity);diff --git a/tools/eht/generators/editor_api.py b/tools/eht/generators/editor_api.pyindex 4b662e13a..466fdd868 100644--- a/tools/eht/generators/editor_api.py+++ b/tools/eht/generators/editor_api.py@@ -60,12 +60,21 @@ class EditorAPIGenerator:lines.extend(sorted(headers))lines.extend([+ '#include <glm/gtc/quaternion.hpp>','','using namespace esengine;','using namespace esengine::ecs;','','namespace {','',+ '// Euler (degrees) ↔ Quaternion conversion helpers',+ 'inline glm::vec3 quatToEulerDeg(const glm::quat& q) {',+ ' return glm::degrees(glm::eulerAngles(q));',+ '}',+ 'inline glm::quat eulerDegToQuat(const glm::vec3& deg) {',+ ' return glm::quat(glm::radians(deg));',+ '}',+ '',])return lines@@ -142,7 +151,9 @@ class EditorAPIGenerator:if is_color_field(prop, self.types):fields.append((prop.name, 'color', comp.name))elif t == 'glm::quat':- # Quaternion: expose only rotation.z as a single float (2D rotation angle)+ # Quaternion: expose as Euler angles X/Y/Z (degrees) in editor+ fields.append((f'{prop.name}.x', 'float', comp.name))+ fields.append((f'{prop.name}.y', 'float', comp.name))fields.append((f'{prop.name}.z', 'float', comp.name))elif len(subs) == 1 and subs[0][0] == '':fields.append((prop.name, editor_type, comp.name))@@ -254,8 +265,8 @@ class EditorAPIGenerator:t = self.types.clean_type(prop.cpp_type)if t == 'glm::quat':- # Only rotation.z for editor- float_fields.append((f'{prop.name}.z', f'{prop.name}.z'))+ # Quaternion: handled separately via euler conversion+ continueelse:subs = get_sub_components(prop, self.types)if len(subs) == 1 and subs[0][0] == '':@@ -266,6 +277,11 @@ class EditorAPIGenerator:float_fields.append((f'{prop.name}.{label}', f'{prop.name}.{member}'))return float_fields+ def _collect_quat_fields(self, comp: Component) -> list:+ """Collect quat property names that should be exposed as euler X/Y/Z."""+ return [p.name for p in comp.properties+ if not self._is_readonly(p) and self.types.clean_type(p.cpp_type) == 'glm::quat']+def _gen_set_float(self) -> List[str]:lines = ['// ── Set Float Property ──',@@ -281,7 +297,8 @@ class EditorAPIGenerator:continuefull = f'{comp.namespace}::{comp.name}' if comp.namespace else comp.namefloat_fields = self._collect_float_fields(comp)- if not float_fields:+ quat_fields = self._collect_quat_fields(comp)+ if not float_fields and not quat_fields:continuecond = 'if' if first_comp else '} else if'@@ -290,9 +307,22 @@ class EditorAPIGenerator:lines.append(f' if (!reg.has<{full}>(entity)) return false;')lines.append(f' auto& c = reg.get<{full}>(entity);')- for i, (key, cpp_path) in enumerate(float_fields):- prefix = 'if' if i == 0 else 'else if'+ idx = 0+ for key, cpp_path in float_fields:+ prefix = 'if' if idx == 0 else 'else if'lines.append(f' {prefix} (field == "{key}") {{ c.{cpp_path} = value; }}')+ idx += 1++ # Quaternion fields: set euler angle then convert to quaternion+ for qname in quat_fields:+ for axis in ['x', 'y', 'z']:+ prefix = 'if' if idx == 0 else 'else if'+ lines.append(f' {prefix} (field == "{qname}.{axis}") {{')+ lines.append(f' auto euler = quatToEulerDeg(c.{qname});')+ lines.append(f' euler.{axis} = value;')+ lines.append(f' c.{qname} = eulerDegToQuat(euler);')+ lines.append(f' }}')+ idx += 1lines.append(' else { return false; }')lines.append(' return true;')@@ -321,7 +351,8 @@ class EditorAPIGenerator:continuefull = f'{comp.namespace}::{comp.name}' if comp.namespace else comp.namefloat_fields = self._collect_float_fields(comp)- if not float_fields:+ quat_fields = self._collect_quat_fields(comp)+ if not float_fields and not quat_fields:continuecond = 'if' if first_comp else '} else if'@@ -330,9 +361,18 @@ class EditorAPIGenerator:lines.append(f' if (!reg.has<{full}>(entity)) return 0.0f;')lines.append(f' const auto& c = reg.get<{full}>(entity);')- for i, (key, cpp_path) in enumerate(float_fields):- prefix = 'if' if i == 0 else 'else if'+ idx = 0+ for key, cpp_path in float_fields:+ prefix = 'if' if idx == 0 else 'else if'lines.append(f' {prefix} (field == "{key}") {{ return c.{cpp_path}; }}')+ idx += 1++ # Quaternion fields: convert to euler and return axis+ for qname in quat_fields:+ for axis in ['x', 'y', 'z']:+ prefix = 'if' if idx == 0 else 'else if'+ lines.append(f' {prefix} (field == "{qname}.{axis}") {{ return quatToEulerDeg(c.{qname}).{axis}; }}')+ idx += 1if not first_comp: