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.

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.cpp
index 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::s
if (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::st
if (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.py
index 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
+ continue
else:
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:
continue
full = f'{comp.namespace}::{comp.name}' if comp.namespace else comp.name
float_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:
continue
cond = '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 += 1
lines.append(' else { return false; }')
lines.append(' return true;')
@@ -321,7 +351,8 @@ class EditorAPIGenerator:
continue
full = f'{comp.namespace}::{comp.name}' if comp.namespace else comp.name
float_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:
continue
cond = '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 += 1
if not first_comp: