reze-engine 0.2.13 → 0.2.14

package/dist/engine.d.ts

@@ -100,6 +100,8 @@ export declare class Engine {
     private gpuMemoryMB;
     private hasAnimation;
     private playingAnimation;
+    private breathingTimeout;
+    private breathingBaseRotations;
     constructor(canvas: HTMLCanvasElement, options?: EngineOptions);
     init(): Promise<void>;
     private createPipelines;
@@ -114,8 +116,13 @@ export declare class Engine {
     private addLight;
     private setAmbient;
     loadAnimation(url: string): Promise<void>;
-    playAnimation(): void;
+    playAnimation(options?: {
+        breathBones?: string[] | Record<string, number>;
+        breathDuration?: number;
+    }): void;
     stopAnimation(): void;
+    private stopBreathing;
+    private startBreathing;
     getStats(): EngineStats;
     runRenderLoop(callback?: () => void): void;
     stopRenderLoop(): void;

package/dist/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}

package/dist/engine.js

@@ -55,6 +55,8 @@ export class Engine {
         this.gpuMemoryMB = 0;
         this.hasAnimation = false; // Set to true when loadAnimation is called
         this.playingAnimation = false; // Set to true when playAnimation is called
+        this.breathingTimeout = null;
+        this.breathingBaseRotations = new Map();
         this.canvas = canvas;
         if (options) {
             this.ambient = options.ambient ?? 1.0;
@@ -1268,11 +1270,26 @@ export class Engine {
         this.animationFrames = frames;
         this.hasAnimation = true;
     }
-    playAnimation() {
+    playAnimation(options) {
         if (this.animationFrames.length === 0)
             return;
         this.stopAnimation();
+        this.stopBreathing();
         this.playingAnimation = true;
+        // Enable breathing if breathBones is provided
+        const enableBreath = options?.breathBones !== undefined && options.breathBones !== null;
+        let breathBones = [];
+        let breathRotationRanges = undefined;
+        if (enableBreath && options.breathBones) {
+            if (Array.isArray(options.breathBones)) {
+                breathBones = options.breathBones;
+            }
+            else {
+                breathBones = Object.keys(options.breathBones);
+                breathRotationRanges = options.breathBones;
+            }
+        }
+        const breathDuration = options?.breathDuration ?? 4000;
         const allBoneKeyFrames = [];
         for (const keyFrame of this.animationFrames) {
             for (const boneFrame of keyFrame.boneFrames) {
@@ -1360,6 +1377,40 @@ export class Engine {
                 }
             }
         }
+        // Setup breathing animation if enabled
+        if (enableBreath && this.currentModel) {
+            // Find the last frame time
+            let maxTime = 0;
+            for (const keyFrame of this.animationFrames) {
+                if (keyFrame.time > maxTime) {
+                    maxTime = keyFrame.time;
+                }
+            }
+            // Get last frame rotations directly from animation data for breathing bones
+            const lastFrameRotations = new Map();
+            for (const bone of breathBones) {
+                const keyFrames = boneKeyFramesByBone.get(bone);
+                if (keyFrames && keyFrames.length > 0) {
+                    // Find the rotation at the last frame time (closest keyframe <= maxTime)
+                    let lastRotation = null;
+                    for (let i = keyFrames.length - 1; i >= 0; i--) {
+                        if (keyFrames[i].time <= maxTime) {
+                            lastRotation = keyFrames[i].rotation;
+                            break;
+                        }
+                    }
+                    if (lastRotation) {
+                        lastFrameRotations.set(bone, lastRotation);
+                    }
+                }
+            }
+            // Start breathing after animation completes
+            // Use the last frame rotations directly from animation data (no need to capture from model)
+            const animationEndTime = maxTime * 1000 + 200; // Small buffer for final tweens to complete
+            this.breathingTimeout = window.setTimeout(() => {
+                this.startBreathing(breathBones, lastFrameRotations, breathRotationRanges, breathDuration);
+            }, animationEndTime);
+        }
     }
     stopAnimation() {
         for (const timeoutId of this.animationTimeouts) {
@@ -1368,6 +1419,54 @@ export class Engine {
         this.animationTimeouts = [];
         this.playingAnimation = false;
     }
+    stopBreathing() {
+        if (this.breathingTimeout !== null) {
+            clearTimeout(this.breathingTimeout);
+            this.breathingTimeout = null;
+        }
+        this.breathingBaseRotations.clear();
+    }
+    startBreathing(bones, baseRotations, rotationRanges, durationMs = 4000) {
+        if (!this.currentModel)
+            return;
+        // Store base rotations directly from last frame of animation data
+        // These are the exact rotations from the animation - use them as-is
+        for (const bone of bones) {
+            const baseRot = baseRotations.get(bone);
+            if (baseRot) {
+                this.breathingBaseRotations.set(bone, baseRot);
+            }
+        }
+        const halfCycleMs = durationMs / 2;
+        const defaultRotation = 0.02; // Default rotation range if not specified per bone
+        // Start breathing cycle - oscillate around exact base rotation (final pose)
+        // Each bone can have its own rotation range, or use default
+        const animate = (isInhale) => {
+            if (!this.currentModel)
+                return;
+            const breathingBoneNames = [];
+            const breathingQuats = [];
+            for (const bone of bones) {
+                const baseRot = this.breathingBaseRotations.get(bone);
+                if (!baseRot)
+                    continue;
+                // Get rotation range for this bone (per-bone or default)
+                const rotation = rotationRanges?.[bone] ?? defaultRotation;
+                // Oscillate around base rotation with the bone's rotation range
+                // isInhale: base * rotation, exhale: base * (-rotation)
+                const oscillationRot = Quat.fromEuler(isInhale ? rotation : -rotation, 0, 0);
+                const finalRot = baseRot.multiply(oscillationRot);
+                breathingBoneNames.push(bone);
+                breathingQuats.push(finalRot);
+            }
+            if (breathingBoneNames.length > 0) {
+                this.rotateBones(breathingBoneNames, breathingQuats, halfCycleMs);
+            }
+            this.breathingTimeout = window.setTimeout(() => animate(!isInhale), halfCycleMs);
+        };
+        // Start breathing from exhale position (closer to base) to minimize initial movement
+        animate(false);
+    }
     getStats() {
         return { ...this.stats };
     }
@@ -1392,6 +1491,7 @@ export class Engine {
     dispose() {
         this.stopRenderLoop();
         this.stopAnimation();
+        this.stopBreathing();
         if (this.camera)
             this.camera.detachControl();
         if (this.resizeObserver) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "reze-engine",
-    "version": "0.2.13",
+    "version": "0.2.14",
     "description": "A WebGPU-based MMD model renderer",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",

package/src/engine.ts

@@ -139,6 +139,8 @@ export class Engine {
   private gpuMemoryMB: number = 0
   private hasAnimation = false // Set to true when loadAnimation is called
   private playingAnimation = false // Set to true when playAnimation is called
+  private breathingTimeout: number | null = null
+  private breathingBaseRotations: Map<string, Quat> = new Map()
 
   constructor(canvas: HTMLCanvasElement, options?: EngineOptions) {
     this.canvas = canvas
@@ -1420,12 +1422,32 @@ export class Engine {
     this.hasAnimation = true
   }
 
-  public playAnimation() {
+  public playAnimation(options?: {
+    breathBones?: string[] | Record<string, number> // Array of bone names or map of bone name -> rotation range
+    breathDuration?: number // Breathing cycle duration in milliseconds
+  }) {
     if (this.animationFrames.length === 0) return
 
     this.stopAnimation()
+    this.stopBreathing()
     this.playingAnimation = true
 
+    // Enable breathing if breathBones is provided
+    const enableBreath = options?.breathBones !== undefined && options.breathBones !== null
+    let breathBones: string[] = []
+    let breathRotationRanges: Record<string, number> | undefined = undefined
+
+    if (enableBreath && options.breathBones) {
+      if (Array.isArray(options.breathBones)) {
+        breathBones = options.breathBones
+      } else {
+        breathBones = Object.keys(options.breathBones)
+        breathRotationRanges = options.breathBones
+      }
+    }
+
+    const breathDuration = options?.breathDuration ?? 4000
+
     const allBoneKeyFrames: BoneKeyFrame[] = []
     for (const keyFrame of this.animationFrames) {
       for (const boneFrame of keyFrame.boneFrames) {
@@ -1529,6 +1551,43 @@ export class Engine {
         }
       }
     }
+
+    // Setup breathing animation if enabled
+    if (enableBreath && this.currentModel) {
+      // Find the last frame time
+      let maxTime = 0
+      for (const keyFrame of this.animationFrames) {
+        if (keyFrame.time > maxTime) {
+          maxTime = keyFrame.time
+        }
+      }
+
+      // Get last frame rotations directly from animation data for breathing bones
+      const lastFrameRotations = new Map<string, Quat>()
+      for (const bone of breathBones) {
+        const keyFrames = boneKeyFramesByBone.get(bone)
+        if (keyFrames && keyFrames.length > 0) {
+          // Find the rotation at the last frame time (closest keyframe <= maxTime)
+          let lastRotation: Quat | null = null
+          for (let i = keyFrames.length - 1; i >= 0; i--) {
+            if (keyFrames[i].time <= maxTime) {
+              lastRotation = keyFrames[i].rotation
+              break
+            }
+          }
+          if (lastRotation) {
+            lastFrameRotations.set(bone, lastRotation)
+          }
+        }
+      }
+
+      // Start breathing after animation completes
+      // Use the last frame rotations directly from animation data (no need to capture from model)
+      const animationEndTime = maxTime * 1000 + 200 // Small buffer for final tweens to complete
+      this.breathingTimeout = window.setTimeout(() => {
+        this.startBreathing(breathBones, lastFrameRotations, breathRotationRanges, breathDuration)
+      }, animationEndTime)
+    }
   }
 
   public stopAnimation() {
@@ -1539,6 +1598,69 @@ export class Engine {
     this.playingAnimation = false
   }
 
+  private stopBreathing() {
+    if (this.breathingTimeout !== null) {
+      clearTimeout(this.breathingTimeout)
+      this.breathingTimeout = null
+    }
+    this.breathingBaseRotations.clear()
+  }
+
+  private startBreathing(
+    bones: string[],
+    baseRotations: Map<string, Quat>,
+    rotationRanges?: Record<string, number>,
+    durationMs: number = 4000
+  ) {
+    if (!this.currentModel) return
+
+    // Store base rotations directly from last frame of animation data
+    // These are the exact rotations from the animation - use them as-is
+    for (const bone of bones) {
+      const baseRot = baseRotations.get(bone)
+      if (baseRot) {
+        this.breathingBaseRotations.set(bone, baseRot)
+      }
+    }
+
+    const halfCycleMs = durationMs / 2
+    const defaultRotation = 0.02 // Default rotation range if not specified per bone
+
+    // Start breathing cycle - oscillate around exact base rotation (final pose)
+    // Each bone can have its own rotation range, or use default
+    const animate = (isInhale: boolean) => {
+      if (!this.currentModel) return
+
+      const breathingBoneNames: string[] = []
+      const breathingQuats: Quat[] = []
+
+      for (const bone of bones) {
+        const baseRot = this.breathingBaseRotations.get(bone)
+        if (!baseRot) continue
+
+        // Get rotation range for this bone (per-bone or default)
+        const rotation = rotationRanges?.[bone] ?? defaultRotation
+
+        // Oscillate around base rotation with the bone's rotation range
+        // isInhale: base * rotation, exhale: base * (-rotation)
+        const oscillationRot = Quat.fromEuler(isInhale ? rotation : -rotation, 0, 0)
+        const finalRot = baseRot.multiply(oscillationRot)
+
+        breathingBoneNames.push(bone)
+        breathingQuats.push(finalRot)
+      }
+
+      if (breathingBoneNames.length > 0) {
+        this.rotateBones(breathingBoneNames, breathingQuats, halfCycleMs)
+      }
+
+      this.breathingTimeout = window.setTimeout(() => animate(!isInhale), halfCycleMs)
+    }
+
+    // Start breathing from exhale position (closer to base) to minimize initial movement
+    animate(false)
+  }
+
   public getStats(): EngineStats {
     return { ...this.stats }
   }
@@ -1570,6 +1692,7 @@ export class Engine {
   public dispose() {
     this.stopRenderLoop()
     this.stopAnimation()
+    this.stopBreathing()
     if (this.camera) this.camera.detachControl()
     if (this.resizeObserver) {
       this.resizeObserver.disconnect()