minerender 2.1.0-alpha.131 → 2.1.0-alpha.132

package/dist/node/index.mjs

@@ -5003,6 +5003,13 @@ var init_EntityAnimation = __esm({
 
 // src/entity/scene/EntityAnimationPlayer.ts
 import { Euler as Euler3, Vector3 as Vector35 } from "three";
+function validateAnimationWeights(weights, count) {
+  const values = Array.from(weights);
+  if (values.length !== count || values.some((weight) => !Number.isFinite(weight) || weight < 0)) {
+    throw new Error("Animation weights must match the clip count and contain only finite nonnegative numbers");
+  }
+  return values;
+}
 var ZERO, EntityAnimationPlayer;
 var init_EntityAnimationPlayer = __esm({
   "src/entity/scene/EntityAnimationPlayer.ts"() {
@@ -5011,12 +5018,20 @@ var init_EntityAnimationPlayer = __esm({
     EntityAnimationPlayer = class {
       constructor() {
         this.parts = [];
+        this._animations = [];
+        this._weights = [];
+        this.loops = [];
         this._time = 0;
-        this.loop = false;
         this.speed = 1;
       }
       get animation() {
-        return this._animation;
+        return this._animations[0];
+      }
+      get animations() {
+        return this._animations.slice();
+      }
+      get weights() {
+        return this._weights.slice();
       }
       get time() {
         return this._time;
@@ -5026,10 +5041,20 @@ var init_EntityAnimationPlayer = __esm({
        * without them, the current pose is used. Stopping restores the pose from before playback.
        */
       play(layers, animation, options = {}, poses) {
+        this.playAnimations(layers, [animation], options, poses);
+      }
+      /**
+       * Starts clips on matching parts with a shared clock. Weighted offsets add to the supplied baked poses
+       * or, without poses, to each animated part's pose when playback starts.
+       */
+      playAnimations(layers, animations, options = {}, poses) {
+        const weights = validateAnimationWeights(options.weights ?? animations.map(() => 1), animations.length);
         this.stop();
-        this._animation = animation;
+        this._animations = animations.slice();
+        this._weights = weights;
+        if (!animations.length) return;
         this._time = options.time ?? 0;
-        this.loop = options.loop ?? animation.loop;
+        this.loops = animations.map((animation) => options.loop ?? animation.loop);
         this.speed = options.speed ?? 1;
         for (const layer of layers) {
           const objects = [];
@@ -5038,7 +5063,8 @@ var init_EntityAnimationPlayer = __esm({
               if (poses.has(object4)) objects.push(object4);
             });
           } else {
-            for (const bone of Object.keys(animation.bones)) {
+            const bones = new Set(animations.flatMap((animation) => Object.keys(animation.bones)));
+            for (const bone of bones) {
               const object4 = layer.getObjectByName(`group:${bone}`);
               if (object4) objects.push(object4);
             }
@@ -5062,7 +5088,7 @@ var init_EntityAnimationPlayer = __esm({
       }
       /** Restores the poses from before playback. Returns whether an animation was active. */
       stop() {
-        if (!this._animation) return false;
+        if (!this._animations.length) return false;
         for (const part of this.parts) {
           part.object.position.copy(part.position);
           part.object.rotation.copy(part.rotation);
@@ -5074,12 +5100,14 @@ var init_EntityAnimationPlayer = __esm({
       /** Forgets the animation without touching the parts, for parts that no longer exist. */
       clear() {
         this.parts = [];
-        this._animation = void 0;
+        this._animations = [];
+        this._weights = [];
+        this.loops = [];
         this._time = 0;
       }
       /** Applies the pose at an absolute playback time. Returns `false` when no clip is active. */
       setTime(seconds) {
-        if (!this._animation) return false;
+        if (!this._animations.length) return false;
         this._time = seconds;
         this.apply();
         return true;
@@ -5088,8 +5116,30 @@ var init_EntityAnimationPlayer = __esm({
       advance(deltaSeconds) {
         return this.setTime(this._time + deltaSeconds * this.speed);
       }
+      /** Changes weights in clip order and reapplies the current time without restarting playback. */
+      setWeights(weights) {
+        if (!this._animations.length) return false;
+        const validated = validateAnimationWeights(weights, this._animations.length);
+        this._weights = validated;
+        this.apply();
+        return true;
+      }
       apply() {
-        const pose = sampleEntityAnimation(this._animation, this._time, this.loop);
+        const pose = /* @__PURE__ */ Object.create(null);
+        for (let i = 0; i < this._animations.length; i++) {
+          const weight = this._weights[i];
+          if (weight === 0) continue;
+          const sampled = sampleEntityAnimation(this._animations[i], this._time, this.loops[i]);
+          for (const [bone, channels] of Object.entries(sampled)) {
+            const blended = pose[bone] ??= {};
+            for (const channel of ENTITY_ANIMATION_CHANNELS) {
+              const value = channels[channel];
+              if (!value) continue;
+              const target = blended[channel] ??= [0, 0, 0];
+              for (let axis = 0; axis < 3; axis++) target[axis] += value[axis] * weight;
+            }
+          }
+        }
         for (const part of this.parts) {
           const { position = ZERO, rotation = ZERO, scale = ZERO } = pose[part.bone] ?? {};
           part.object.position.set(part.basePosition.x + position[0], part.basePosition.y + position[1], part.basePosition.z + position[2]);
@@ -5713,7 +5763,7 @@ var init_EntityObject = __esm({
         for (const geometry of this.geometries) geometry.dispose();
         this.geometries.clear();
         for (const dispose of this.disposeWireframes.splice(0)) dispose();
-        for (const player of this.animationPlayers.splice(0)) player.clear();
+        for (const { player } of this.animationPlayers.splice(0)) player.clear();
         this.partPoses.clear();
         super.disposeAndRemoveAllChildren();
       }
@@ -5748,15 +5798,31 @@ var init_EntityObject = __esm({
       //<editor-fold desc="ANIMATION">
       /** The first active clip, until playback is stopped or the object is disposed. */
       get animation() {
-        return this.animationPlayers[0]?.animation;
+        return this.animationPlayers[0]?.player.animation;
       }
-      /** Clips playing together, each targeting a separate geometry layer. */
+      /** Clips playing together, in the order passed to {@link playAnimations}. */
       get activeAnimations() {
-        return this.animationPlayers.map((player) => player.animation);
+        const animations = [];
+        for (const { player, indices } of this.animationPlayers) {
+          player.animations.forEach((animation, i) => {
+            animations[indices[i]] = animation;
+          });
+        }
+        return animations;
+      }
+      /** Weights of the active clips, in the same order as {@link activeAnimations}. */
+      get animationWeights() {
+        const weights = [];
+        for (const { player, indices } of this.animationPlayers) {
+          player.weights.forEach((weight, i) => {
+            weights[indices[i]] = weight;
+          });
+        }
+        return weights;
       }
       /** Seconds since the animation started, before looping. */
       get animationTime() {
-        return this.animationPlayers[0]?.time ?? 0;
+        return this.animationPlayers[0]?.player.time ?? 0;
       }
       /**
        * Plays a clip from {@link Entities.getAnimations}, replacing all active clips.
@@ -5767,42 +5833,59 @@ var init_EntityObject = __esm({
       playAnimation(animation, options) {
         this.playAnimations([animation], options);
       }
-      /** Plays clips with a shared clock and no blending. Selected layers without their own clip follow `main`. */
+      /**
+       * Plays clips with a shared clock, adding their weighted offsets within each geometry layer.
+       * Weights default to 1 and are not normalized. Selected layers without their own clip follow `main`.
+       */
       playAnimations(animations, options) {
-        const targets = /* @__PURE__ */ new Set();
-        const selections = animations.map((animation) => {
+        const weights = validateAnimationWeights(options?.weights ?? animations.map(() => 1), animations.length);
+        const selections = /* @__PURE__ */ new Map();
+        animations.forEach((animation, index) => {
           const layer = animation.layer ?? "main";
-          if (targets.has(layer)) throw new Error(`Multiple animations target layer "${layer}"`);
-          targets.add(layer);
           const names = Object.keys(this.entityLayers).filter((name) => name.split("#")[0] === layer);
           if (!names.length) throw new Error(`Entity ${this.entity.id} has no selected animation layer "${layer}"`);
-          return { animation, names };
+          let selection = selections.get(layer);
+          if (!selection) selections.set(layer, selection = { animations: [], names, indices: [] });
+          selection.animations.push(animation);
+          selection.indices.push(index);
         });
-        const main = selections.find(({ animation }) => (animation.layer ?? "main") === "main");
-        if (main) main.names.push(...Object.keys(this.entityLayers).filter((name) => !targets.has(name.split("#")[0])));
+        const main = selections.get("main");
+        if (main) main.names.push(...Object.keys(this.entityLayers).filter((name) => !selections.has(name.split("#")[0])));
         this.createMeshes();
         this.stopAnimation();
-        for (const { animation, names } of selections) {
+        for (const { animations: clips, names, indices } of selections.values()) {
           const player = new EntityAnimationPlayer();
-          player.play(names.map((name) => this.getLayerGroup(name)), animation, options, this.partPoses);
-          this.animationPlayers.push(player);
+          player.playAnimations(
+            names.map((name) => this.getLayerGroup(name)),
+            clips,
+            { ...options, weights: indices.map((index) => weights[index]) },
+            this.partPoses
+          );
+          this.animationPlayers.push({ player, indices });
         }
         this.notifyDirty();
       }
+      /** Changes weights in active clip order, notifying the scene without restarting the shared clock. Has no effect without an animation. */
+      setAnimationWeights(weights) {
+        if (!this.animationPlayers.length) return;
+        const values = validateAnimationWeights(weights, this.activeAnimations.length);
+        for (const { player, indices } of this.animationPlayers) player.setWeights(indices.map((index) => values[index]));
+        this.notifyDirty();
+      }
       /** Stops all clips and restores the poses from before playback. */
       stopAnimation() {
         const players = this.animationPlayers.splice(0);
-        for (const player of players) player.stop();
+        for (const { player } of players) player.stop();
         if (players.length) this.notifyDirty();
       }
       /** Poses the object at an explicit time in seconds. Has no effect without an animation. */
       setAnimationTime(seconds) {
-        for (const player of this.animationPlayers) player.setTime(seconds);
+        for (const { player } of this.animationPlayers) player.setTime(seconds);
         if (this.animationPlayers.length) this.notifyDirty();
       }
       /** Advances the animation by a frame delta in seconds, scaled by its speed. Has no effect without an animation. */
       advanceAnimation(deltaSeconds) {
-        for (const player of this.animationPlayers) player.advance(deltaSeconds);
+        for (const { player } of this.animationPlayers) player.advance(deltaSeconds);
         if (this.animationPlayers.length) this.notifyDirty();
       }
       //</editor-fold>
@@ -20523,6 +20606,7 @@ export {
   toRadians,
   toTrianglesDrawMode,
   trimCanvas,
+  validateAnimationWeights,
   yieldToEventLoop
 };
 //# sourceMappingURL=index.mjs.map