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: generate PTR_LAYOUTS from C++ struct layout and replace timeline magic numbers

esengine82e7d7465e12
diff --git a/sdk/src/ptrLayouts.generated.ts b/sdk/src/ptrLayouts.generated.ts
new file mode 100644
index 000000000..fa6270e81
--- /dev/null
+++ b/sdk/src/ptrLayouts.generated.ts
@@ -0,0 +1,347 @@
+/**
+ * @file ptrLayouts.generated.ts
+ * @brief Auto-generated component pointer layouts
+ * @details Generated by EHT - DO NOT EDIT
+ */
+
+type PtrFieldType = 'f32' | 'i32' | 'u32' | 'bool' | 'u8' | 'vec2' | 'vec3' | 'vec4' | 'quat' | 'color';
+
+interface PtrFieldDesc {
+ readonly name: string;
+ readonly type: PtrFieldType;
+ readonly offset: number;
+}
+
+export interface PtrLayout {
+ readonly ptrFn: string;
+ readonly fields: readonly PtrFieldDesc[];
+}
+
+export const PTR_LAYOUTS: Record<string, PtrLayout> = {
+ UIRect: {
+ ptrFn: 'getUIRectPtr',
+ fields: [
+ { name: 'anchorMin', type: 'vec2', offset: 0 },
+ { name: 'anchorMax', type: 'vec2', offset: 8 },
+ { name: 'offsetMin', type: 'vec2', offset: 16 },
+ { name: 'offsetMax', type: 'vec2', offset: 24 },
+ { name: 'size', type: 'vec2', offset: 32 },
+ { name: 'pivot', type: 'vec2', offset: 40 },
+ ],
+ },
+ FlexItem: {
+ ptrFn: 'getFlexItemPtr',
+ fields: [
+ { name: 'flexGrow', type: 'f32', offset: 0 },
+ { name: 'flexShrink', type: 'f32', offset: 4 },
+ { name: 'flexBasis', type: 'f32', offset: 8 },
+ { name: 'order', type: 'i32', offset: 12 },
+ { name: 'alignSelf', type: 'u8', offset: 16 },
+ { name: 'minWidth', type: 'f32', offset: 20 },
+ { name: 'minHeight', type: 'f32', offset: 24 },
+ { name: 'maxWidth', type: 'f32', offset: 28 },
+ { name: 'maxHeight', type: 'f32', offset: 32 },
+ { name: 'widthPercent', type: 'f32', offset: 36 },
+ { name: 'heightPercent', type: 'f32', offset: 40 },
+ ],
+ },
+ BoxCollider: {
+ ptrFn: 'getBoxColliderPtr',
+ fields: [
+ { name: 'halfExtents', type: 'vec2', offset: 0 },
+ { name: 'offset', type: 'vec2', offset: 8 },
+ { name: 'density', type: 'f32', offset: 16 },
+ { name: 'friction', type: 'f32', offset: 20 },
+ { name: 'restitution', type: 'f32', offset: 24 },
+ { name: 'isSensor', type: 'bool', offset: 28 },
+ { name: 'enabled', type: 'bool', offset: 29 },
+ { name: 'categoryBits', type: 'u32', offset: 32 },
+ { name: 'maskBits', type: 'u32', offset: 36 },
+ ],
+ },
+ CircleCollider: {
+ ptrFn: 'getCircleColliderPtr',
+ fields: [
+ { name: 'radius', type: 'f32', offset: 0 },
+ { name: 'offset', type: 'vec2', offset: 4 },
+ { name: 'density', type: 'f32', offset: 12 },
+ { name: 'friction', type: 'f32', offset: 16 },
+ { name: 'restitution', type: 'f32', offset: 20 },
+ { name: 'isSensor', type: 'bool', offset: 24 },
+ { name: 'enabled', type: 'bool', offset: 25 },
+ { name: 'categoryBits', type: 'u32', offset: 28 },
+ { name: 'maskBits', type: 'u32', offset: 32 },
+ ],
+ },
+ CapsuleCollider: {
+ ptrFn: 'getCapsuleColliderPtr',
+ fields: [
+ { name: 'radius', type: 'f32', offset: 0 },
+ { name: 'halfHeight', type: 'f32', offset: 4 },
+ { name: 'offset', type: 'vec2', offset: 8 },
+ { name: 'density', type: 'f32', offset: 16 },
+ { name: 'friction', type: 'f32', offset: 20 },
+ { name: 'restitution', type: 'f32', offset: 24 },
+ { name: 'isSensor', type: 'bool', offset: 28 },
+ { name: 'enabled', type: 'bool', offset: 29 },
+ { name: 'categoryBits', type: 'u32', offset: 32 },
+ { name: 'maskBits', type: 'u32', offset: 36 },
+ ],
+ },
+ SegmentCollider: {
+ ptrFn: 'getSegmentColliderPtr',
+ fields: [
+ { name: 'point1', type: 'vec2', offset: 0 },
+ { name: 'point2', type: 'vec2', offset: 8 },
+ { name: 'density', type: 'f32', offset: 16 },
+ { name: 'friction', type: 'f32', offset: 20 },
+ { name: 'restitution', type: 'f32', offset: 24 },
+ { name: 'isSensor', type: 'bool', offset: 28 },
+ { name: 'enabled', type: 'bool', offset: 29 },
+ { name: 'categoryBits', type: 'u32', offset: 32 },
+ { name: 'maskBits', type: 'u32', offset: 36 },
+ ],
+ },
+ FanLayout: {
+ ptrFn: 'getFanLayoutPtr',
+ fields: [
+ { name: 'radius', type: 'f32', offset: 0 },
+ { name: 'maxSpreadAngle', type: 'f32', offset: 4 },
+ { name: 'maxCardAngle', type: 'f32', offset: 8 },
+ { name: 'tiltFactor', type: 'f32', offset: 12 },
+ { name: 'cardSpacing', type: 'f32', offset: 16 },
+ { name: 'direction', type: 'i32', offset: 20 },
+ ],
+ },
+ ParticleEmitter: {
+ ptrFn: 'getParticleEmitterPtr',
+ fields: [
+ { name: 'rate', type: 'f32', offset: 0 },
+ { name: 'burstCount', type: 'i32', offset: 4 },
+ { name: 'burstInterval', type: 'f32', offset: 8 },
+ { name: 'duration', type: 'f32', offset: 12 },
+ { name: 'looping', type: 'bool', offset: 16 },
+ { name: 'playOnStart', type: 'bool', offset: 17 },
+ { name: 'maxParticles', type: 'i32', offset: 20 },
+ { name: 'lifetimeMin', type: 'f32', offset: 24 },
+ { name: 'lifetimeMax', type: 'f32', offset: 28 },
+ { name: 'shape', type: 'i32', offset: 32 },
+ { name: 'shapeRadius', type: 'f32', offset: 36 },
+ { name: 'shapeSize', type: 'vec2', offset: 40 },
+ { name: 'shapeAngle', type: 'f32', offset: 48 },
+ { name: 'speedMin', type: 'f32', offset: 52 },
+ { name: 'speedMax', type: 'f32', offset: 56 },
+ { name: 'angleSpreadMin', type: 'f32', offset: 60 },
+ { name: 'angleSpreadMax', type: 'f32', offset: 64 },
+ { name: 'startSizeMin', type: 'f32', offset: 68 },
+ { name: 'startSizeMax', type: 'f32', offset: 72 },
+ { name: 'endSizeMin', type: 'f32', offset: 76 },
+ { name: 'endSizeMax', type: 'f32', offset: 80 },
+ { name: 'sizeEasing', type: 'i32', offset: 84 },
+ { name: 'startColor', type: 'color', offset: 88 },
+ { name: 'endColor', type: 'color', offset: 104 },
+ { name: 'colorEasing', type: 'i32', offset: 120 },
+ { name: 'rotationMin', type: 'f32', offset: 124 },
+ { name: 'rotationMax', type: 'f32', offset: 128 },
+ { name: 'angularVelocityMin', type: 'f32', offset: 132 },
+ { name: 'angularVelocityMax', type: 'f32', offset: 136 },
+ { name: 'gravity', type: 'vec2', offset: 140 },
+ { name: 'damping', type: 'f32', offset: 148 },
+ { name: 'texture', type: 'u32', offset: 152 },
+ { name: 'spriteColumns', type: 'i32', offset: 156 },
+ { name: 'spriteRows', type: 'i32', offset: 160 },
+ { name: 'spriteFPS', type: 'f32', offset: 164 },
+ { name: 'spriteLoop', type: 'bool', offset: 168 },
+ { name: 'blendMode', type: 'i32', offset: 172 },
+ { name: 'layer', type: 'i32', offset: 176 },
+ { name: 'material', type: 'u32', offset: 180 },
+ { name: 'simulationSpace', type: 'i32', offset: 184 },
+ { name: 'enabled', type: 'bool', offset: 188 },
+ ],
+ },
+ Transform: {
+ ptrFn: 'getTransformPtr',
+ fields: [
+ { name: 'position', type: 'vec3', offset: 0 },
+ { name: 'rotation', type: 'quat', offset: 12 },
+ { name: 'scale', type: 'vec3', offset: 28 },
+ { name: 'worldPosition', type: 'vec3', offset: 40 },
+ { name: 'worldRotation', type: 'quat', offset: 52 },
+ { name: 'worldScale', type: 'vec3', offset: 68 },
+ ],
+ },
+ UIRenderer: {
+ ptrFn: 'getUIRendererPtr',
+ fields: [
+ { name: 'visualType', type: 'u8', offset: 0 },
+ { name: 'texture', type: 'u32', offset: 4 },
+ { name: 'color', type: 'color', offset: 8 },
+ { name: 'uvOffset', type: 'vec2', offset: 24 },
+ { name: 'uvScale', type: 'vec2', offset: 32 },
+ { name: 'sliceBorder', type: 'vec4', offset: 40 },
+ { name: 'material', type: 'u32', offset: 56 },
+ { name: 'enabled', type: 'bool', offset: 60 },
+ ],
+ },
+ GridLayout: {
+ ptrFn: 'getGridLayoutPtr',
+ fields: [
+ { name: 'direction', type: 'i32', offset: 0 },
+ { name: 'crossAxisCount', type: 'i32', offset: 4 },
+ { name: 'itemSize', type: 'vec2', offset: 8 },
+ { name: 'spacing', type: 'vec2', offset: 16 },
+ ],
+ },
+ Velocity: {
+ ptrFn: 'getVelocityPtr',
+ fields: [
+ { name: 'linear', type: 'vec3', offset: 0 },
+ { name: 'angular', type: 'vec3', offset: 12 },
+ ],
+ },
+ SpineAnimation: {
+ ptrFn: 'getSpineAnimationPtr',
+ fields: [
+ { name: 'timeScale', type: 'f32', offset: 0 },
+ { name: 'loop', type: 'bool', offset: 4 },
+ { name: 'playing', type: 'bool', offset: 5 },
+ { name: 'flipX', type: 'bool', offset: 6 },
+ { name: 'flipY', type: 'bool', offset: 7 },
+ { name: 'color', type: 'color', offset: 8 },
+ { name: 'layer', type: 'i32', offset: 24 },
+ { name: 'skeletonScale', type: 'f32', offset: 28 },
+ { name: 'material', type: 'u32', offset: 32 },
+ { name: 'enabled', type: 'bool', offset: 36 },
+ ],
+ },
+ Interactable: {
+ ptrFn: 'getInteractablePtr',
+ fields: [
+ { name: 'enabled', type: 'bool', offset: 0 },
+ { name: 'blockRaycast', type: 'bool', offset: 1 },
+ { name: 'raycastTarget', type: 'bool', offset: 2 },
+ ],
+ },
+ UIInteraction: {
+ ptrFn: 'getUIInteractionPtr',
+ fields: [
+ { name: 'hovered', type: 'bool', offset: 0 },
+ { name: 'pressed', type: 'bool', offset: 1 },
+ { name: 'justPressed', type: 'bool', offset: 2 },
+ { name: 'justReleased', type: 'bool', offset: 3 },
+ ],
+ },
+ RigidBody: {
+ ptrFn: 'getRigidBodyPtr',
+ fields: [
+ { name: 'bodyType', type: 'u8', offset: 0 },
+ { name: 'gravityScale', type: 'f32', offset: 4 },
+ { name: 'linearDamping', type: 'f32', offset: 8 },
+ { name: 'angularDamping', type: 'f32', offset: 12 },
+ { name: 'fixedRotation', type: 'bool', offset: 16 },
+ { name: 'bullet', type: 'bool', offset: 17 },
+ { name: 'enabled', type: 'bool', offset: 18 },
+ ],
+ },
+ BitmapText: {
+ ptrFn: 'getBitmapTextPtr',
+ fields: [
+ { name: 'color', type: 'color', offset: 0 },
+ { name: 'fontSize', type: 'f32', offset: 16 },
+ { name: 'align', type: 'u8', offset: 20 },
+ { name: 'spacing', type: 'f32', offset: 24 },
+ { name: 'layer', type: 'i32', offset: 28 },
+ { name: 'font', type: 'u32', offset: 32 },
+ { name: 'enabled', type: 'bool', offset: 36 },
+ ],
+ },
+ Sprite: {
+ ptrFn: 'getSpritePtr',
+ fields: [
+ { name: 'texture', type: 'u32', offset: 0 },
+ { name: 'color', type: 'color', offset: 4 },
+ { name: 'size', type: 'vec2', offset: 20 },
+ { name: 'pivot', type: 'vec2', offset: 28 },
+ { name: 'uvOffset', type: 'vec2', offset: 36 },
+ { name: 'uvScale', type: 'vec2', offset: 44 },
+ { name: 'layer', type: 'i32', offset: 52 },
+ { name: 'flipX', type: 'bool', offset: 56 },
+ { name: 'flipY', type: 'bool', offset: 57 },
+ { name: 'material', type: 'u32', offset: 60 },
+ { name: 'enabled', type: 'bool', offset: 64 },
+ ],
+ },
+ UIMask: {
+ ptrFn: 'getUIMaskPtr',
+ fields: [
+ { name: 'enabled', type: 'bool', offset: 0 },
+ { name: 'mode', type: 'u8', offset: 1 },
+ ],
+ },
+ FlexContainer: {
+ ptrFn: 'getFlexContainerPtr',
+ fields: [
+ { name: 'direction', type: 'u8', offset: 0 },
+ { name: 'wrap', type: 'u8', offset: 1 },
+ { name: 'justifyContent', type: 'u8', offset: 2 },
+ { name: 'alignItems', type: 'u8', offset: 3 },
+ { name: 'alignContent', type: 'u8', offset: 4 },
+ { name: 'gap', type: 'vec2', offset: 8 },
+ ],
+ },
+ ShapeRenderer: {
+ ptrFn: 'getShapeRendererPtr',
+ fields: [
+ { name: 'shapeType', type: 'u8', offset: 0 },
+ { name: 'color', type: 'color', offset: 4 },
+ { name: 'size', type: 'vec2', offset: 20 },
+ { name: 'cornerRadius', type: 'f32', offset: 28 },
+ { name: 'layer', type: 'i32', offset: 32 },
+ { name: 'enabled', type: 'bool', offset: 36 },
+ ],
+ },
+ Selectable: {
+ ptrFn: 'getSelectablePtr',
+ fields: [
+ { name: 'selected', type: 'bool', offset: 0 },
+ { name: 'group', type: 'i32', offset: 4 },
+ ],
+ },
+ LayoutGroup: {
+ ptrFn: 'getLayoutGroupPtr',
+ fields: [
+ { name: 'direction', type: 'u8', offset: 0 },
+ { name: 'spacing', type: 'f32', offset: 4 },
+ { name: 'childAlignment', type: 'u8', offset: 8 },
+ { name: 'reverseOrder', type: 'bool', offset: 9 },
+ ],
+ },
+ Canvas: {
+ ptrFn: 'getCanvasPtr',
+ fields: [
+ { name: 'designResolution', type: 'vec2', offset: 0 },
+ { name: 'pixelsPerUnit', type: 'f32', offset: 8 },
+ { name: 'scaleMode', type: 'u8', offset: 12 },
+ { name: 'matchWidthOrHeight', type: 'f32', offset: 16 },
+ { name: 'backgroundColor', type: 'color', offset: 20 },
+ ],
+ },
+ Camera: {
+ ptrFn: 'getCameraPtr',
+ fields: [
+ { name: 'projectionType', type: 'u8', offset: 0 },
+ { name: 'fov', type: 'f32', offset: 4 },
+ { name: 'orthoSize', type: 'f32', offset: 8 },
+ { name: 'nearPlane', type: 'f32', offset: 12 },
+ { name: 'farPlane', type: 'f32', offset: 16 },
+ { name: 'aspectRatio', type: 'f32', offset: 20 },
+ { name: 'isActive', type: 'bool', offset: 24 },
+ { name: 'priority', type: 'i32', offset: 28 },
+ { name: 'viewportX', type: 'f32', offset: 32 },
+ { name: 'viewportY', type: 'f32', offset: 36 },
+ { name: 'viewportW', type: 'f32', offset: 40 },
+ { name: 'viewportH', type: 'f32', offset: 44 },
+ { name: 'clearFlags', type: 'i32', offset: 48 },
+ ],
+ },
+};
diff --git a/sdk/src/timeline/TimelineRuntime.ts b/sdk/src/timeline/TimelineRuntime.ts
index 368f562eb..52c6d326d 100644
--- a/sdk/src/timeline/TimelineRuntime.ts
+++ b/sdk/src/timeline/TimelineRuntime.ts
@@ -6,6 +6,14 @@ import type { TimelineAsset } from './TimelineTypes';
import type { ESEngineModule } from '../wasm';
import type { Entity } from '../types';
+const TimelineEventType = {
+ SpinePlay: 0,
+ SpineStop: 1,
+ SpriteAnimPlay: 2,
+ AudioPlay: 3,
+ ActivationSet: 4,
+} as const;
+
export function setNestedProperty(obj: Record<string, any>, path: string, value: number): boolean {
const parts = path.split('.');
let target = obj;
@@ -100,7 +108,7 @@ export function processTimelineEvents(world: any, module: ESEngineModule): void
const entity = module._tl_getEventEntity(i);
switch (type) {
- case 0: { // SpinePlay
+ case TimelineEventType.SpinePlay: {
const animName = decodeEventString(module, i);
const loop = module._tl_getEventIntParam(i) !== 0;
if (world.has(entity, SpineAnimation)) {
@@ -112,7 +120,7 @@ export function processTimelineEvents(world: any, module: ESEngineModule): void
}
break;
}
- case 1: { // SpineStop
+ case TimelineEventType.SpineStop: {
if (world.has(entity, SpineAnimation)) {
const current = world.get(entity, SpineAnimation);
current.playing = false;
@@ -120,7 +128,7 @@ export function processTimelineEvents(world: any, module: ESEngineModule): void
}
break;
}
- case 2: { // SpriteAnimPlay
+ case TimelineEventType.SpriteAnimPlay: {
const clipName = decodeEventString(module, i);
if (world.has(entity, SpriteAnimator)) {
const current = world.get(entity, SpriteAnimator);
@@ -132,7 +140,7 @@ export function processTimelineEvents(world: any, module: ESEngineModule): void
}
break;
}
- case 3: { // AudioPlay
+ case TimelineEventType.AudioPlay: {
const clipPath = decodeEventString(module, i);
const volume = module._tl_getEventFloatParam(i);
if (clipPath) {
@@ -140,7 +148,7 @@ export function processTimelineEvents(world: any, module: ESEngineModule): void
}
break;
}
- case 4: { // ActivationSet
+ case TimelineEventType.ActivationSet: {
const active = module._tl_getEventIntParam(i) !== 0;
if (world.has(entity, SpineAnimation)) {
const current = world.get(entity, SpineAnimation);
diff --git a/sdk/src/world.ts b/sdk/src/world.ts
index be29985b1..f8b5d2331 100644
--- a/sdk/src/world.ts
+++ b/sdk/src/world.ts
@@ -43,7 +43,10 @@ function convertForWasm(
// Pointer-based Field Layout Descriptors
// =============================================================================
-type PtrFieldType = 'f32' | 'i32' | 'u32' | 'bool' | 'u8' | 'vec2' | 'vec3' | 'quat' | 'color';
+import { PTR_LAYOUTS, type PtrLayout } from './ptrLayouts.generated';
+export { PTR_LAYOUTS };
+
+type PtrFieldType = 'f32' | 'i32' | 'u32' | 'bool' | 'u8' | 'vec2' | 'vec3' | 'vec4' | 'quat' | 'color';
interface PtrFieldDesc {
readonly name: string;
@@ -51,116 +54,6 @@ interface PtrFieldDesc {
readonly offset: number;
}
-interface PtrLayout {
- readonly ptrFn: string;
- readonly fields: readonly PtrFieldDesc[];
-}
-
-const PTR_LAYOUTS: Record<string, PtrLayout> = {
- Transform: {
- ptrFn: 'getTransformPtr',
- fields: [
- { name: 'position', type: 'vec3', offset: 0 },
- { name: 'rotation', type: 'quat', offset: 12 },
- { name: 'scale', type: 'vec3', offset: 28 },
- { name: 'worldPosition', type: 'vec3', offset: 40 },
- { name: 'worldRotation', type: 'quat', offset: 52 },
- { name: 'worldScale', type: 'vec3', offset: 68 },
- ],
- },
- Sprite: {
- ptrFn: 'getSpritePtr',
- fields: [
- { name: 'texture', type: 'u32', offset: 0 },
- { name: 'color', type: 'color', offset: 4 },
- { name: 'size', type: 'vec2', offset: 20 },
- { name: 'uvOffset', type: 'vec2', offset: 28 },
- { name: 'uvScale', type: 'vec2', offset: 36 },
- { name: 'layer', type: 'i32', offset: 44 },
- { name: 'flipX', type: 'bool', offset: 48 },
- { name: 'flipY', type: 'bool', offset: 49 },
- { name: 'material', type: 'u32', offset: 52 },
- { name: 'enabled', type: 'bool', offset: 56 },
- ],
- },
- Velocity: {
- ptrFn: 'getVelocityPtr',
- fields: [
- { name: 'linear', type: 'vec3', offset: 0 },
- { name: 'angular', type: 'vec3', offset: 12 },
- ],
- },
- Camera: {
- ptrFn: 'getCameraPtr',
- fields: [
- { name: 'projectionType', type: 'u8', offset: 0 },
- { name: 'fov', type: 'f32', offset: 4 },
- { name: 'orthoSize', type: 'f32', offset: 8 },
- { name: 'nearPlane', type: 'f32', offset: 12 },
- { name: 'farPlane', type: 'f32', offset: 16 },
- { name: 'aspectRatio', type: 'f32', offset: 20 },
- { name: 'isActive', type: 'bool', offset: 24 },
- { name: 'priority', type: 'i32', offset: 28 },
- { name: 'viewportX', type: 'f32', offset: 32 },
- { name: 'viewportY', type: 'f32', offset: 36 },
- { name: 'viewportW', type: 'f32', offset: 40 },
- { name: 'viewportH', type: 'f32', offset: 44 },
- { name: 'clearFlags', type: 'i32', offset: 48 },
- ],
- },
- UIRect: {
- ptrFn: 'getUIRectPtr',
- fields: [
- { name: 'anchorMin', type: 'vec2', offset: 0 },
- { name: 'anchorMax', type: 'vec2', offset: 8 },
- { name: 'offsetMin', type: 'vec2', offset: 16 },
- { name: 'offsetMax', type: 'vec2', offset: 24 },
- { name: 'size', type: 'vec2', offset: 32 },
- { name: 'pivot', type: 'vec2', offset: 40 },
- ],
- },
- RigidBody: {
- ptrFn: 'getRigidBodyPtr',
- fields: [
- { name: 'bodyType', type: 'u8', offset: 0 },
- { name: 'gravityScale', type: 'f32', offset: 4 },
- { name: 'linearDamping', type: 'f32', offset: 8 },
- { name: 'angularDamping', type: 'f32', offset: 12 },
- { name: 'fixedRotation', type: 'bool', offset: 16 },
- { name: 'bullet', type: 'bool', offset: 17 },
- { name: 'enabled', type: 'bool', offset: 18 },
- ],
- },
- BoxCollider: {
- ptrFn: 'getBoxColliderPtr',
- fields: [
- { name: 'halfExtents', type: 'vec2', offset: 0 },
- { name: 'offset', type: 'vec2', offset: 8 },
- { name: 'density', type: 'f32', offset: 16 },
- { name: 'friction', type: 'f32', offset: 20 },
- { name: 'restitution', type: 'f32', offset: 24 },
- { name: 'isSensor', type: 'bool', offset: 28 },
- { name: 'enabled', type: 'bool', offset: 29 },
- { name: 'categoryBits', type: 'u32', offset: 32 },
- { name: 'maskBits', type: 'u32', offset: 36 },
- ],
- },
- CircleCollider: {
- ptrFn: 'getCircleColliderPtr',
- fields: [
- { name: 'radius', type: 'f32', offset: 0 },
- { name: 'offset', type: 'vec2', offset: 4 },
- { name: 'density', type: 'f32', offset: 12 },
- { name: 'friction', type: 'f32', offset: 16 },
- { name: 'restitution', type: 'f32', offset: 20 },
- { name: 'isSensor', type: 'bool', offset: 24 },
- { name: 'enabled', type: 'bool', offset: 25 },
- { name: 'categoryBits', type: 'u32', offset: 28 },
- { name: 'maskBits', type: 'u32', offset: 32 },
- ],
- },
-};
-
function readPtrField(
f32: Float32Array, u32: Uint32Array, u8: Uint8Array,
ptr: number, field: PtrFieldDesc,
@@ -175,6 +68,7 @@ function readPtrField(
case 'u8': return u8[byteOff];
case 'vec2': return { x: f32[idx], y: f32[idx + 1] };
case 'vec3': return { x: f32[idx], y: f32[idx + 1], z: f32[idx + 2] };
+ case 'vec4':
case 'quat': return { x: f32[idx], y: f32[idx + 1], z: f32[idx + 2], w: f32[idx + 3] };
case 'color': return { r: f32[idx], g: f32[idx + 1], b: f32[idx + 2], a: f32[idx + 3] };
}
@@ -204,6 +98,7 @@ function fillPtrFields(
v.x = f32[idx]; v.y = f32[idx + 1]; v.z = f32[idx + 2];
break;
}
+ case 'vec4':
case 'quat': {
const v = target[field.name] as any;
v.x = f32[idx]; v.y = f32[idx + 1]; v.z = f32[idx + 2]; v.w = f32[idx + 3];
@@ -224,6 +119,7 @@ function createPreallocatedResult(fields: readonly PtrFieldDesc[]): Record<strin
switch (f.type) {
case 'vec2': obj[f.name] = { x: 0, y: 0 }; break;
case 'vec3': obj[f.name] = { x: 0, y: 0, z: 0 }; break;
+ case 'vec4':
case 'quat': obj[f.name] = { x: 0, y: 0, z: 0, w: 0 }; break;
case 'color': obj[f.name] = { r: 0, g: 0, b: 0, a: 0 }; break;
default: obj[f.name] = null; break;
@@ -246,6 +142,7 @@ function writePtrField(
case 'u8': u8[byteOff] = value; break;
case 'vec2': f32[idx] = value.x; f32[idx + 1] = value.y; break;
case 'vec3': f32[idx] = value.x; f32[idx + 1] = value.y; f32[idx + 2] = value.z; break;
+ case 'vec4':
case 'quat': f32[idx] = value.x; f32[idx + 1] = value.y; f32[idx + 2] = value.z; f32[idx + 3] = value.w; break;
case 'color': f32[idx] = value.r; f32[idx + 1] = value.g; f32[idx + 2] = value.b; f32[idx + 3] = value.a; break;
}
diff --git a/tools/eht.py b/tools/eht.py
index 4bb17c017..2abd7f514 100644
--- a/tools/eht.py
+++ b/tools/eht.py
@@ -1131,6 +1131,145 @@ class AnimTargetGenerator:
return '\n'.join(lines)
+class PtrLayoutGenerator:
+ """Generates ptrLayouts.generated.ts with computed struct field offsets."""
+
+ TYPE_SIZES = {
+ 'bool': 1, 'u8': 1, 'i8': 1,
+ 'u16': 2, 'i16': 2,
+ 'f32': 4, 'i32': 4, 'u32': 4, 'float': 4, 'int': 4, 'unsigned': 4,
+ 'f64': 8, 'i64': 8, 'u64': 8, 'double': 8,
+ 'glm::vec2': 8, 'glm::uvec2': 8,
+ 'glm::vec3': 12,
+ 'glm::vec4': 16, 'glm::quat': 16,
+ 'Padding': 16,
+ }
+
+ TYPE_ALIGNS = {
+ 'bool': 1, 'u8': 1, 'i8': 1,
+ 'u16': 2, 'i16': 2,
+ 'f32': 4, 'i32': 4, 'u32': 4, 'float': 4, 'int': 4, 'unsigned': 4,
+ 'f64': 4, 'i64': 4, 'u64': 4, 'double': 4,
+ 'glm::vec2': 4, 'glm::uvec2': 4,
+ 'glm::vec3': 4,
+ 'glm::vec4': 4, 'glm::quat': 4,
+ 'Padding': 4,
+ }
+
+ CPP_TO_PTR_TYPE = {
+ 'bool': 'bool', 'u8': 'u8', 'i8': 'u8',
+ 'f32': 'f32', 'float': 'f32',
+ 'i32': 'i32', 'int': 'i32',
+ 'u32': 'u32', 'unsigned': 'u32',
+ 'glm::vec2': 'vec2', 'glm::uvec2': 'vec2',
+ 'glm::vec3': 'vec3',
+ 'glm::vec4': 'color', 'glm::quat': 'quat',
+ }
+
+ def __init__(self, components: List[Component], enums: List[Enum]):
+ self.components = components
+ self.types = TypeSystem(enums)
+ self.layouts: List[Dict] = []
+ self._compute()
+
+ def _get_size(self, cpp_type: str) -> Optional[int]:
+ t = self.types.clean_type(cpp_type)
+ if t in self.TYPE_SIZES:
+ return self.TYPE_SIZES[t]
+ if self.types.is_handle(t):
+ return 4
+ if self.types.is_enum(t):
+ return 1
+ return None
+
+ def _get_align(self, cpp_type: str) -> int:
+ t = self.types.clean_type(cpp_type)
+ if t in self.TYPE_ALIGNS:
+ return self.TYPE_ALIGNS[t]
+ if self.types.is_handle(t) or self.types.is_enum(t):
+ return 4 if self.types.is_handle(t) else 1
+ return 4
+
+ def _get_ptr_type(self, cpp_type: str, prop: Property) -> Optional[str]:
+ t = self.types.clean_type(cpp_type)
+ if t in self.CPP_TO_PTR_TYPE:
+ if t == 'glm::vec4':
+ is_color = any(pat in prop.name for pat in MetadataGenerator.COLOR_FIELD_PATTERNS)
+ return 'color' if is_color else 'vec4'
+ return self.CPP_TO_PTR_TYPE[t]
+ if self.types.is_handle(t):
+ return 'u32'
+ if self.types.is_enum(t):
+ return 'u8'
+ return None
+
+ def _compute(self):
+ for comp in self.components:
+ fields = []
+ offset = 0
+ for prop in comp.properties:
+ size = self._get_size(prop.cpp_type)
+ if size is None:
+ continue
+ ptr_type = self._get_ptr_type(prop.cpp_type, prop)
+ if ptr_type is None:
+ continue
+
+ align = self._get_align(prop.cpp_type)
+ if offset % align != 0:
+ offset += align - (offset % align)
+
+ fields.append({
+ 'name': prop.name,
+ 'type': ptr_type,
+ 'offset': offset,
+ })
+ offset += size
+
+ if fields:
+ self.layouts.append({
+ 'name': comp.name,
+ 'ptrFn': f'get{comp.name}Ptr',
+ 'fields': fields,
+ })
+
+ def generate(self) -> str:
+ lines = [
+ '/**',
+ ' * @file ptrLayouts.generated.ts',
+ ' * @brief Auto-generated component pointer layouts',
+ ' * @details Generated by EHT - DO NOT EDIT',
+ ' */',
+ '',
+ "type PtrFieldType = 'f32' | 'i32' | 'u32' | 'bool' | 'u8' | 'vec2' | 'vec3' | 'vec4' | 'quat' | 'color';",
+ '',
+ 'interface PtrFieldDesc {',
+ ' readonly name: string;',
+ ' readonly type: PtrFieldType;',
+ ' readonly offset: number;',
+ '}',
+ '',
+ 'export interface PtrLayout {',
+ ' readonly ptrFn: string;',
+ ' readonly fields: readonly PtrFieldDesc[];',
+ '}',
+ '',
+ 'export const PTR_LAYOUTS: Record<string, PtrLayout> = {',
+ ]
+
+ for layout in self.layouts:
+ lines.append(f' {layout["name"]}: {{')
+ lines.append(f" ptrFn: '{layout['ptrFn']}',")
+ lines.append(' fields: [')
+ for f in layout['fields']:
+ lines.append(f" {{ name: '{f['name']}', type: '{f['type']}', offset: {f['offset']} }},")
+ lines.append(' ],')
+ lines.append(' },')
+
+ lines.extend(['};', ''])
+ return '\n'.join(lines)
+
+
def main():
parser = argparse.ArgumentParser(description='EHT - ESEngine Header Tool')
parser.add_argument('--input', '-i', type=Path, nargs='+',
@@ -1199,6 +1338,12 @@ def main():
print(f"Generating: {anim_ts_path}")
anim_ts_path.write_text(anim_gen.generate_ts(), encoding='utf-8')
+ ptr_gen = PtrLayoutGenerator(cpp_parser.components, cpp_parser.enums)
+ ptr_path = args.ts_output / 'src' / 'ptrLayouts.generated.ts'
+ if ptr_path.parent.exists():
+ print(f"Generating: {ptr_path}")
+ ptr_path.write_text(ptr_gen.generate(), encoding='utf-8')
+
print("[OK] Done!")
return 0