npm - reze-engine - Versions diffs - 0.10.0 → 0.10.1 - Mend

reze-engine 0.10.0 → 0.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/README.md CHANGED Viewed

@@ -2,6 +2,8 @@
 A minimal-dependency WebGPU engine for real-time MMD/PMX rendering. Only external dependency is Ammo.js for physics.
+![screenshot](./screenshot.png)
 ## Install
 ```bash
@@ -14,80 +16,113 @@ npm install reze-engine
 - VMD animation with IK solver and Bullet physics
 - Orbit camera with bone-follow mode
 - GPU picking (double-click/tap)
-- Ground plane with PCF shadow mapping, grid lines, and frosted texture
+- Ground plane with PCF shadow mapping
 - Multi-model support
-## Quick Start
+## Usage
 ```javascript
-import { Engine, Vec3 } from "reze-engine"
+import { Engine, Vec3 } from "reze-engine";
 const engine = new Engine(canvas, {
   ambientColor: new Vec3(0.88, 0.92, 0.99),
   cameraDistance: 31.5, // MMD units (1 unit = 8 cm)
-})
-await engine.init()
-const model = await engine.loadModel("hero", "/models/hero/hero.pmx")
-await model.loadAnimation("idle", "/animations/idle.vmd")
-model.show("idle")
-model.play()
-engine.setCameraFollow(model, "センター", new Vec3(0, 3.5, 0))
-engine.addGround({ width: 160, height: 160 })
-engine.runRenderLoop()
+  cameraTarget: new Vec3(0, 11.5, 0),
+});
+await engine.init();
+const model = await engine.loadModel("hero", "/models/hero/hero.pmx");
+await model.loadVmd("idle", "/animations/idle.vmd");
+model.show("idle");
+model.play();
+engine.setCameraFollow(model, "センター", new Vec3(0, 3.5, 0));
+engine.addGround({ width: 160, height: 160 });
+engine.runRenderLoop();
 ```
 ## API
+One WebGPU **Engine** per page (singleton after `init()`). Load models via `engine.loadModel(path)` or `engine.loadModel(name, path)`.
 ### Engine
-| Method | Description |
-|--------|-------------|
-| `new Engine(canvas, options?)` | Create engine with optional config |
-| `engine.init()` | Initialize WebGPU device and context |
-| `engine.loadModel(path)` | Load PMX model (auto-named) |
-| `engine.loadModel(name, path)` | Load PMX model with name |
-| `engine.getModel(name)` | Get model by name |
-| `engine.getModelNames()` | List all model names |
-| `engine.removeModel(name)` | Remove model |
-| `engine.setMaterialVisible(model, mat, visible)` | Show/hide material |
-| `engine.toggleMaterialVisible(model, mat)` | Toggle material visibility |
-| `engine.setIKEnabled(enabled)` | Enable/disable IK globally |
-| `engine.setPhysicsEnabled(enabled)` | Enable/disable physics globally |
-| `engine.setCameraFollow(model, bone?, offset?)` | Orbit center tracks a bone |
-| `engine.setCameraTarget(vec3)` | Static camera target |
-| `engine.setCameraDistance(d)` | Set orbit radius |
-| `engine.setCameraAlpha(a)` | Set horizontal orbit angle |
-| `engine.setCameraBeta(b)` | Set vertical orbit angle |
-| `engine.addGround(options?)` | Add ground plane with shadows |
-| `engine.runRenderLoop(callback?)` | Start render loop |
-| `engine.stopRenderLoop()` | Stop render loop |
-| `engine.getStats()` | Returns `{ fps, frameTime }` |
-| `engine.dispose()` | Clean up all resources |
+```javascript
+engine.init()
+engine.loadModel(name, path)
+engine.getModel(name)
+engine.getModelNames()
+engine.removeModel(name)
+engine.setMaterialVisible(name, material, visible)
+engine.toggleMaterialVisible(name, material)
+engine.isMaterialVisible(name, material)
+engine.setIKEnabled(enabled)
+engine.setPhysicsEnabled(enabled)
+engine.setCameraFollow(model, bone?, offset?)
+engine.setCameraFollow(null)
+engine.setCameraTarget(vec3)
+engine.setCameraDistance(d)
+engine.setCameraAlpha(a)
+engine.setCameraBeta(b)
+engine.addGround(options?)
+engine.runRenderLoop(callback?)
+engine.stopRenderLoop()
+engine.getStats()
+engine.dispose()
+```
 ### Model
-| Method | Description |
-|--------|-------------|
-| `model.loadAnimation(name, url)` | Load VMD animation |
-| `model.loadAnimation(name, clip)` | Load/replace animation clip directly |
-| `model.show(name)` | Set pose at time 0 (resets bones and morphs first) |
-| `model.play(name?)` | Play animation (queued if busy; named play resets bones/morphs first) |
-| `model.play(name, { priority?, loop? })` | Priority-aware play; `loop` wraps at end (`0` default/lowest priority) |
-| `model.pause()` | Pause playback |
-| `model.stop()` | Stop playback |
-| `model.seek(time)` | Seek to time |
-| `model.getAnimationProgress()` | `{ current, duration, percentage, animationName, looping, playing, paused }` — `current`/`duration` are seconds |
-| `model.getAnimationClip(name)` | Get loaded clip by name |
-| `model.rotateBones(rotations, ms?)` | Tween bone rotations |
-| `model.moveBones(translations, ms?)` | Tween bone translations |
-| `model.setMorphWeight(name, weight, ms?)` | Tween morph weight |
-| `model.resetAllBones()` | Reset to bind pose |
-| `model.resetAllMorphs()` | Reset all morph weights |
-| `model.getBoneWorldPosition(name)` | World position of bone |
-`AnimationClip` is frame-based: `frameCount` is the last keyframe frame index, keyframes store `frame`. Engine playback uses fixed 30 FPS. Looping is controlled via `play(name, { loop: true })`, not on the clip.
+```javascript
+await model.loadVmd(name, url)
+model.loadClip(name, clip)
+model.show(name)
+model.play(name)
+model.play(name, { priority: 8 }) // higher number = higher priority (0 default/lowest)
+model.play(name, { loop: true }) // repeat until stop/pause or another play
+model.pause()
+model.stop()
+model.seek(time)
+model.getAnimationProgress()
+model.getClip(name)
+model.exportVmd(name)              // returns ArrayBuffer
+model.rotateBones({ 首: quat, 頭: quat }, ms?)
+model.moveBones({ センター: vec3 }, ms?)
+model.setMorphWeight(name, weight, ms?)
+model.resetAllBones()
+model.resetAllMorphs()
+model.getBoneWorldPosition(name)
+```
+#### Animation data
+`AnimationClip` holds keyframes only: bone/morph tracks keyed by `frame`, and `frameCount` (last keyframe index). Time advances at fixed `FPS` (see package export `FPS`, default 30).
+#### VMD Export
+`model.exportVmd(name)` serialises a loaded clip back to the VMD binary format and returns an `ArrayBuffer`. Bone and morph names are Shift-JIS encoded for compatibility with standard MMD tools.
+```javascript
+const buffer = model.exportVmd("idle")
+const blob = new Blob([buffer], { type: "application/octet-stream" })
+const link = document.createElement("a")
+link.href = URL.createObjectURL(blob)
+link.download = "idle.vmd"
+link.click()
+```
+#### Playback
+Call `model.play(name, options?)` to start or switch motion. `loop: true` makes the playhead wrap at the end of the clip until you stop, pause, or call `play` with something else. `priority` chooses which request wins when several clips compete.
+#### Progress
+`getAnimationProgress()` reports `current` and `duration` in seconds, plus `playing`, `paused`, `looping`, and related fields.
 ### Engine Options
@@ -112,25 +147,6 @@ engine.runRenderLoop()
 `constraintSolverKeywords` — joints whose name contains any keyword use the Bullet 2.75 constraint solver; all others keep the stable Ammo 2.82+ default. See [babylon-mmd: Fix Constraint Behavior](https://noname0310.github.io/babylon-mmd/docs/reference/runtime/apply-physics-to-mmd-models/#fix-constraint-behavior) for details.
-### Ground Options
-```javascript
-engine.addGround({
-  width: 100,            // ground plane width
-  height: 100,           // ground plane depth
-  diffuseColor: Vec3,    // base color (default: 0.8, 0.1, 1.0)
-  fadeStart: 5.0,        // distance where edge fade begins
-  fadeEnd: 60.0,         // distance where ground fully fades out
-  shadowMapSize: 4096,   // shadow map resolution
-  shadowStrength: 1.0,   // shadow darkness
-  gridSpacing: 5.0,      // world-space distance between grid lines
-  gridLineWidth: 0.012,  // thickness of grid lines
-  gridLineOpacity: 0.4,  // grid line visibility (0–1)
-  gridLineColor: Vec3,   // grid line color (default: 0.8, 0.8, 0.8)
-  noiseStrength: 0.08,   // frosted/matte micro-texture intensity
-})
-```
 ## Projects Using This Engine
 - **[MiKaPo](https://mikapo.vercel.app)** — Real-time motion capture for MMD

package/dist/index.d.ts CHANGED Viewed

@@ -4,4 +4,5 @@ export { Vec3, Quat, Mat4 } from "./math";
 export type { AnimationClip, AnimationPlayOptions, AnimationProgress, BoneKeyframe, MorphKeyframe, BoneInterpolation, ControlPoint, } from "./animation";
 export { FPS } from "./animation";
 export { Physics, type PhysicsOptions } from "./physics";
+export { VMDWriter } from "./vmd-writer";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AACzC,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AACzC,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js CHANGED Viewed

@@ -3,3 +3,4 @@ export { Model } from "./model";
 export { Vec3, Quat, Mat4 } from "./math";
 export { FPS } from "./animation";
 export { Physics } from "./physics";
+export { VMDWriter } from "./vmd-writer";

package/dist/model.d.ts CHANGED Viewed

@@ -145,11 +145,12 @@ export declare class Model {
     setMorphWeight(name: string, weight: number, durationMs?: number): void;
     private applyMorphs;
     private buildClipFromVmdKeyFrames;
-    loadAnimation(animationName: string, source: string): Promise<void>;
-    loadAnimation(animationName: string, source: AnimationClip): void;
+    loadVmd(name: string, url: string): Promise<void>;
+    loadClip(name: string, clip: AnimationClip): void;
     resetAllBones(): void;
     resetAllMorphs(): void;
-    getAnimationClip(name: string): AnimationClip | null;
+    getClip(name: string): AnimationClip | null;
+    exportVmd(name: string): ArrayBuffer;
     play(): void;
     play(name: string): boolean;
     play(name: string, options?: AnimationPlayOptions): boolean;

package/dist/model.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAEzC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;~~AAG5C~~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~~aAAa~~,CAAC,~~aAAa~~,EAAE,MAAM,EAAE,~~MAAM~~,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;~~IACnE~~,~~aAAa~~,CAAC,~~aAAa~~,EAAE,MAAM,EAAE,~~MAAM~~,EAAE,aAAa,GAAG,IAAI;~~IAYjE~~,aAAa,IAAI,IAAI;IAWrB,cAAc,IAAI,IAAI;IAStB,~~gBAAgB~~,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;~~IAIpD~~,IAAI,IAAI,IAAI;IACZ,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO;IAW3D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOxB,aAAa,IAAI,IAAI;IAIrB,KAAK,IAAI,IAAI;IAKb,cAAc,IAAI,IAAI;IAItB,IAAI,IAAI,IAAI;IAKZ,aAAa,IAAI,IAAI;IAKrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK3B,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIpC,oBAAoB,IAAI,iBAAiB;IAazC,OAAO,CAAC,MAAM,CAAC,UAAU;IAWzB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,iBAAiB;IAyFzB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO;IAkCtD,OAAO,CAAC,aAAa;IAmCrB,OAAO,CAAC,aAAa,CAAyB;IAI9C,OAAO,CAAC,4BAA4B;IAoGpC,oBAAoB,IAAI,IAAI;CA0F7B"}
1	+ {"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"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"}

package/dist/model.js CHANGED Viewed

@@ -2,6 +2,7 @@ import { Mat4, Quat, Vec3 } from "./math";
 import { Engine } from "./engine";
 import { IKSolverSystem } from "./ik-solver";
 import { VMDLoader } from "./vmd-loader";
+import { VMDWriter } from "./vmd-writer";
 import { AnimationState, interpolateControlPoints, rawInterpolationToBoneInterpolation, } from "./animation";
 const VERTEX_STRIDE = 8;
 export class Model {
@@ -578,16 +579,15 @@ export class Model {
         }
         return { boneTracks, morphTracks, frameCount: maxFrame };
     }
-    loadAnimation(animationName, source) {
-        if (typeof source !== "string") {
-            this.animationState.loadAnimation(animationName, source);
-            return;
-        }
-        return VMDLoader.load(source).then((vmdKeyFrames) => {
+    loadVmd(name, url) {
+        return VMDLoader.load(url).then((vmdKeyFrames) => {
             const clip = this.buildClipFromVmdKeyFrames(vmdKeyFrames);
-            this.animationState.loadAnimation(animationName, clip);
+            this.animationState.loadAnimation(name, clip);
         });
     }
+    loadClip(name, clip) {
+        this.animationState.loadAnimation(name, clip);
+    }
     resetAllBones() {
         for (let boneIdx = 0; boneIdx < this.skeleton.bones.length; boneIdx++) {
             const localRot = this.runtimeSkeleton.localRotations[boneIdx];
@@ -605,9 +605,15 @@ export class Model {
         this.morphsDirty = true;
         this.applyMorphs();
     }
-    getAnimationClip(name) {
+    getClip(name) {
         return this.animationState.getAnimationClip(name);
     }
+    exportVmd(name) {
+        const clip = this.animationState.getAnimationClip(name);
+        if (!clip)
+            throw new Error(`Animation clip "${name}" not found`);
+        return new VMDWriter().write(clip);
+    }
     play(name, options) {
         if (name === undefined) {
             this.animationState.play();

package/dist/vmd-writer.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+import { AnimationClip } from "./animation";
+export declare class VMDWriter {
+    write(clip: AnimationClip): ArrayBuffer;
+}
+//# sourceMappingURL=vmd-writer.d.ts.map

package/dist/vmd-writer.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"vmd-writer.d.ts","sourceRoot":"","sources":["../src/vmd-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAqB,MAAM,aAAa,CAAA;AA+C9D,qBAAa,SAAS;IACpB,KAAK,CAAC,IAAI,EAAE,aAAa,GAAG,WAAW;CAgFxC"}

package/dist/vmd-writer.js ADDED Viewed

@@ -0,0 +1,162 @@
+const VMD_HEADER = "Vocaloid Motion Data 0002";
+const HEADER_SIZE = 30;
+const MODEL_NAME_SIZE = 20;
+const BONE_NAME_SIZE = 15;
+const MORPH_NAME_SIZE = 15;
+const BONE_FRAME_SIZE = BONE_NAME_SIZE + 4 + 12 + 16 + 64; // 111 bytes
+const MORPH_FRAME_SIZE = MORPH_NAME_SIZE + 4 + 4; // 23 bytes
+// Build a Unicode-to-Shift-JIS lookup by inverting the TextDecoder mapping.
+let shiftJISTable = null;
+function getShiftJISTable() {
+    if (shiftJISTable)
+        return shiftJISTable;
+    const decoder = new TextDecoder("shift-jis");
+    const map = new Map();
+    // Single-byte range
+    for (let i = 0; i < 256; i++) {
+        const char = decoder.decode(new Uint8Array([i]));
+        if (char !== "\ufffd")
+            map.set(char, [i]);
+    }
+    // Two-byte range (JIS X 0208)
+    for (let hi = 0x81; hi <= 0xfc; hi++) {
+        if (hi >= 0xa0 && hi <= 0xdf)
+            continue;
+        for (let lo = 0x40; lo <= 0xfc; lo++) {
+            if (lo === 0x7f)
+                continue;
+            const char = decoder.decode(new Uint8Array([hi, lo]));
+            if (char !== "\ufffd" && !map.has(char)) {
+                map.set(char, [hi, lo]);
+            }
+        }
+    }
+    shiftJISTable = map;
+    return map;
+}
+function encodeShiftJIS(str) {
+    const table = getShiftJISTable();
+    const bytes = [];
+    for (const char of str) {
+        const b = table.get(char);
+        if (b)
+            bytes.push(...b);
+    }
+    return new Uint8Array(bytes);
+}
+export class VMDWriter {
+    write(clip) {
+        let totalBoneFrames = 0;
+        for (const frames of clip.boneTracks.values()) {
+            totalBoneFrames += frames.length;
+        }
+        let totalMorphFrames = 0;
+        for (const frames of clip.morphTracks.values()) {
+            totalMorphFrames += frames.length;
+        }
+        const size = HEADER_SIZE +
+            MODEL_NAME_SIZE +
+            4 + totalBoneFrames * BONE_FRAME_SIZE +
+            4 + totalMorphFrames * MORPH_FRAME_SIZE;
+        const buffer = new ArrayBuffer(size);
+        const view = new DataView(buffer);
+        let offset = 0;
+        // Header (30 bytes, ASCII)
+        offset = writeFixedString(buffer, offset, VMD_HEADER, HEADER_SIZE);
+        // Model name (20 bytes, zeroed)
+        offset += MODEL_NAME_SIZE;
+        // Bone frame count
+        view.setUint32(offset, totalBoneFrames, true);
+        offset += 4;
+        // Bone frames
+        for (const frames of clip.boneTracks.values()) {
+            for (const kf of frames) {
+                // Bone name (15 bytes, Shift-JIS)
+                offset = writeFixedShiftJIS(buffer, offset, kf.boneName, BONE_NAME_SIZE);
+                // Frame number (u32 LE)
+                view.setUint32(offset, kf.frame, true);
+                offset += 4;
+                // Translation (3 x f32 LE)
+                view.setFloat32(offset, kf.translation.x, true);
+                offset += 4;
+                view.setFloat32(offset, kf.translation.y, true);
+                offset += 4;
+                view.setFloat32(offset, kf.translation.z, true);
+                offset += 4;
+                // Rotation quaternion (4 x f32 LE)
+                view.setFloat32(offset, kf.rotation.x, true);
+                offset += 4;
+                view.setFloat32(offset, kf.rotation.y, true);
+                offset += 4;
+                view.setFloat32(offset, kf.rotation.z, true);
+                offset += 4;
+                view.setFloat32(offset, kf.rotation.w, true);
+                offset += 4;
+                // Interpolation (64 bytes)
+                const raw = boneInterpolationToRaw(kf.interpolation);
+                new Uint8Array(buffer, offset, 64).set(raw);
+                offset += 64;
+            }
+        }
+        // Morph frame count
+        view.setUint32(offset, totalMorphFrames, true);
+        offset += 4;
+        // Morph frames
+        for (const frames of clip.morphTracks.values()) {
+            for (const kf of frames) {
+                // Morph name (15 bytes, Shift-JIS)
+                offset = writeFixedShiftJIS(buffer, offset, kf.morphName, MORPH_NAME_SIZE);
+                // Frame number (u32 LE)
+                view.setUint32(offset, kf.frame, true);
+                offset += 4;
+                // Weight (f32 LE)
+                view.setFloat32(offset, kf.weight, true);
+                offset += 4;
+            }
+        }
+        return buffer;
+    }
+}
+function writeFixedString(buffer, offset, str, maxBytes) {
+    const bytes = new Uint8Array(buffer, offset, maxBytes);
+    bytes.fill(0);
+    for (let i = 0; i < str.length && i < maxBytes; i++) {
+        bytes[i] = str.charCodeAt(i) & 0xff;
+    }
+    return offset + maxBytes;
+}
+function writeFixedShiftJIS(buffer, offset, str, maxBytes) {
+    const target = new Uint8Array(buffer, offset, maxBytes);
+    target.fill(0);
+    const encoded = encodeShiftJIS(str);
+    target.set(encoded.subarray(0, maxBytes));
+    return offset + maxBytes;
+}
+/**
+ * Convert BoneInterpolation back to the 64-byte raw VMD interpolation table.
+ * Exact inverse of rawInterpolationToBoneInterpolation in animation.ts.
+ */
+function boneInterpolationToRaw(interp) {
+    const raw = new Uint8Array(64);
+    // Rotation: [{x: raw[0], y: raw[2]}, {x: raw[1], y: raw[3]}]
+    raw[0] = interp.rotation[0].x;
+    raw[1] = interp.rotation[1].x;
+    raw[2] = interp.rotation[0].y;
+    raw[3] = interp.rotation[1].y;
+    // TranslationX: [{x: raw[0], y: raw[4]}, {x: raw[8], y: raw[12]}]
+    // raw[0] already set by rotation (shared byte)
+    raw[4] = interp.translationX[0].y;
+    raw[8] = interp.translationX[1].x;
+    raw[12] = interp.translationX[1].y;
+    // TranslationY: [{x: raw[16], y: raw[20]}, {x: raw[24], y: raw[28]}]
+    raw[16] = interp.translationY[0].x;
+    raw[20] = interp.translationY[0].y;
+    raw[24] = interp.translationY[1].x;
+    raw[28] = interp.translationY[1].y;
+    // TranslationZ: [{x: raw[32], y: raw[36]}, {x: raw[40], y: raw[44]}]
+    raw[32] = interp.translationZ[0].x;
+    raw[36] = interp.translationZ[0].y;
+    raw[40] = interp.translationZ[1].x;
+    raw[44] = interp.translationZ[1].y;
+    return raw;
+}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
     "name": "reze-engine",
-    "version": "0.10.0",
+    "version": "0.10.1",
     "description": "A lightweight WebGPU engine for real-time 3D MMD/PMX model rendering",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
@@ -36,10 +36,11 @@
     "license": "MIT",
     "dependencies": {
         "@fred3d/ammo": "^1.0.0",
-        "@webgpu/types": "^0.1.66"
+        "@webgpu/types": "^0.1.66",
+        "encoding-japanese": "^2.2.0"
     },
     "devDependencies": {
         "@types/node": "^20",
         "typescript": "^5"
     }
-}
+}

package/src/index.ts CHANGED Viewed

@@ -12,3 +12,4 @@ export type {
 } from "./animation"
 export { FPS } from "./animation"
 export { Physics, type PhysicsOptions } from "./physics"
+export { VMDWriter } from "./vmd-writer"

package/src/model.ts CHANGED Viewed

@@ -3,6 +3,7 @@ import { Engine } from "./engine"
 import { Rigidbody, Joint } from "./physics"
 import { IKSolverSystem } from "./ik-solver"
 import { VMDLoader, type VMDKeyFrame } from "./vmd-loader"
+import { VMDWriter } from "./vmd-writer"
 import {
   AnimationClip,
   AnimationPlayOptions,
@@ -856,19 +857,17 @@ export class Model {
     return { boneTracks, morphTracks, frameCount: maxFrame }
   }
-  loadAnimation(animationName: string, source: string): Promise<void>
-  loadAnimation(animationName: string, source: AnimationClip): void
-  loadAnimation(animationName: string, source: string | AnimationClip): Promise<void> | void {
-    if (typeof source !== "string") {
-      this.animationState.loadAnimation(animationName, source)
-      return
-    }
-    return VMDLoader.load(source).then((vmdKeyFrames) => {
+  loadVmd(name: string, url: string): Promise<void> {
+    return VMDLoader.load(url).then((vmdKeyFrames) => {
       const clip = this.buildClipFromVmdKeyFrames(vmdKeyFrames)
-      this.animationState.loadAnimation(animationName, clip)
+      this.animationState.loadAnimation(name, clip)
     })
   }
+  loadClip(name: string, clip: AnimationClip): void {
+    this.animationState.loadAnimation(name, clip)
+  }
   resetAllBones(): void {
     for (let boneIdx = 0; boneIdx < this.skeleton.bones.length; boneIdx++) {
       const localRot = this.runtimeSkeleton.localRotations[boneIdx]
@@ -889,10 +888,16 @@ export class Model {
     this.applyMorphs()
   }
-  getAnimationClip(name: string): AnimationClip | null {
+  getClip(name: string): AnimationClip | null {
     return this.animationState.getAnimationClip(name)
   }
+  exportVmd(name: string): ArrayBuffer {
+    const clip = this.animationState.getAnimationClip(name)
+    if (!clip) throw new Error(`Animation clip "${name}" not found`)
+    return new VMDWriter().write(clip)
+  }
   play(): void
   play(name: string): boolean
   play(name: string, options?: AnimationPlayOptions): boolean

package/src/vmd-writer.ts ADDED Viewed

@@ -0,0 +1,180 @@
+import { AnimationClip, BoneInterpolation } from "./animation"
+const VMD_HEADER = "Vocaloid Motion Data 0002"
+const HEADER_SIZE = 30
+const MODEL_NAME_SIZE = 20
+const BONE_NAME_SIZE = 15
+const MORPH_NAME_SIZE = 15
+const BONE_FRAME_SIZE = BONE_NAME_SIZE + 4 + 12 + 16 + 64 // 111 bytes
+const MORPH_FRAME_SIZE = MORPH_NAME_SIZE + 4 + 4 // 23 bytes
+// Build a Unicode-to-Shift-JIS lookup by inverting the TextDecoder mapping.
+let shiftJISTable: Map<string, number[]> | null = null
+function getShiftJISTable(): Map<string, number[]> {
+  if (shiftJISTable) return shiftJISTable
+  const decoder = new TextDecoder("shift-jis")
+  const map = new Map<string, number[]>()
+  // Single-byte range
+  for (let i = 0; i < 256; i++) {
+    const char = decoder.decode(new Uint8Array([i]))
+    if (char !== "\ufffd") map.set(char, [i])
+  }
+  // Two-byte range (JIS X 0208)
+  for (let hi = 0x81; hi <= 0xfc; hi++) {
+    if (hi >= 0xa0 && hi <= 0xdf) continue
+    for (let lo = 0x40; lo <= 0xfc; lo++) {
+      if (lo === 0x7f) continue
+      const char = decoder.decode(new Uint8Array([hi, lo]))
+      if (char !== "\ufffd" && !map.has(char)) {
+        map.set(char, [hi, lo])
+      }
+    }
+  }
+  shiftJISTable = map
+  return map
+}
+function encodeShiftJIS(str: string): Uint8Array {
+  const table = getShiftJISTable()
+  const bytes: number[] = []
+  for (const char of str) {
+    const b = table.get(char)
+    if (b) bytes.push(...b)
+  }
+  return new Uint8Array(bytes)
+}
+export class VMDWriter {
+  write(clip: AnimationClip): ArrayBuffer {
+    let totalBoneFrames = 0
+    for (const frames of clip.boneTracks.values()) {
+      totalBoneFrames += frames.length
+    }
+    let totalMorphFrames = 0
+    for (const frames of clip.morphTracks.values()) {
+      totalMorphFrames += frames.length
+    }
+    const size =
+      HEADER_SIZE +
+      MODEL_NAME_SIZE +
+      4 + totalBoneFrames * BONE_FRAME_SIZE +
+      4 + totalMorphFrames * MORPH_FRAME_SIZE
+    const buffer = new ArrayBuffer(size)
+    const view = new DataView(buffer)
+    let offset = 0
+    // Header (30 bytes, ASCII)
+    offset = writeFixedString(buffer, offset, VMD_HEADER, HEADER_SIZE)
+    // Model name (20 bytes, zeroed)
+    offset += MODEL_NAME_SIZE
+    // Bone frame count
+    view.setUint32(offset, totalBoneFrames, true)
+    offset += 4
+    // Bone frames
+    for (const frames of clip.boneTracks.values()) {
+      for (const kf of frames) {
+        // Bone name (15 bytes, Shift-JIS)
+        offset = writeFixedShiftJIS(buffer, offset, kf.boneName, BONE_NAME_SIZE)
+        // Frame number (u32 LE)
+        view.setUint32(offset, kf.frame, true)
+        offset += 4
+        // Translation (3 x f32 LE)
+        view.setFloat32(offset, kf.translation.x, true); offset += 4
+        view.setFloat32(offset, kf.translation.y, true); offset += 4
+        view.setFloat32(offset, kf.translation.z, true); offset += 4
+        // Rotation quaternion (4 x f32 LE)
+        view.setFloat32(offset, kf.rotation.x, true); offset += 4
+        view.setFloat32(offset, kf.rotation.y, true); offset += 4
+        view.setFloat32(offset, kf.rotation.z, true); offset += 4
+        view.setFloat32(offset, kf.rotation.w, true); offset += 4
+        // Interpolation (64 bytes)
+        const raw = boneInterpolationToRaw(kf.interpolation)
+        new Uint8Array(buffer, offset, 64).set(raw)
+        offset += 64
+      }
+    }
+    // Morph frame count
+    view.setUint32(offset, totalMorphFrames, true)
+    offset += 4
+    // Morph frames
+    for (const frames of clip.morphTracks.values()) {
+      for (const kf of frames) {
+        // Morph name (15 bytes, Shift-JIS)
+        offset = writeFixedShiftJIS(buffer, offset, kf.morphName, MORPH_NAME_SIZE)
+        // Frame number (u32 LE)
+        view.setUint32(offset, kf.frame, true)
+        offset += 4
+        // Weight (f32 LE)
+        view.setFloat32(offset, kf.weight, true)
+        offset += 4
+      }
+    }
+    return buffer
+  }
+}
+function writeFixedString(buffer: ArrayBuffer, offset: number, str: string, maxBytes: number): number {
+  const bytes = new Uint8Array(buffer, offset, maxBytes)
+  bytes.fill(0)
+  for (let i = 0; i < str.length && i < maxBytes; i++) {
+    bytes[i] = str.charCodeAt(i) & 0xff
+  }
+  return offset + maxBytes
+}
+function writeFixedShiftJIS(buffer: ArrayBuffer, offset: number, str: string, maxBytes: number): number {
+  const target = new Uint8Array(buffer, offset, maxBytes)
+  target.fill(0)
+  const encoded = encodeShiftJIS(str)
+  target.set(encoded.subarray(0, maxBytes))
+  return offset + maxBytes
+}
+/**
+ * Convert BoneInterpolation back to the 64-byte raw VMD interpolation table.
+ * Exact inverse of rawInterpolationToBoneInterpolation in animation.ts.
+ */
+function boneInterpolationToRaw(interp: BoneInterpolation): Uint8Array {
+  const raw = new Uint8Array(64)
+  // Rotation: [{x: raw[0], y: raw[2]}, {x: raw[1], y: raw[3]}]
+  raw[0] = interp.rotation[0].x
+  raw[1] = interp.rotation[1].x
+  raw[2] = interp.rotation[0].y
+  raw[3] = interp.rotation[1].y
+  // TranslationX: [{x: raw[0], y: raw[4]}, {x: raw[8], y: raw[12]}]
+  // raw[0] already set by rotation (shared byte)
+  raw[4] = interp.translationX[0].y
+  raw[8] = interp.translationX[1].x
+  raw[12] = interp.translationX[1].y
+  // TranslationY: [{x: raw[16], y: raw[20]}, {x: raw[24], y: raw[28]}]
+  raw[16] = interp.translationY[0].x
+  raw[20] = interp.translationY[0].y
+  raw[24] = interp.translationY[1].x
+  raw[28] = interp.translationY[1].y
+  // TranslationZ: [{x: raw[32], y: raw[36]}, {x: raw[40], y: raw[44]}]
+  raw[32] = interp.translationZ[0].x
+  raw[36] = interp.translationZ[0].y
+  raw[40] = interp.translationZ[1].x
+  raw[44] = interp.translationZ[1].y
+  return raw
+}