@lovelace_lol/loom3 1.0.1 → 1.0.3

package/README.md

@@ -1,6 +1,6 @@
 # Loom3
 
-The missing character controller for Three.js, allowing you to bring humanoid and animal characters to life. Loom3 is based on the Facial Action Coding System (FACS) as the basis of its mappings, providing a morph and bone mapping library for controlling high-definition 3D characters in Three.js.
+The missing character controller for Three.js! Loom3 allows you to bring humanoid and animal characters to life. Loom3 is based on the Facial Action Coding System (FACS) as the basis of its mappings, providing a morph and bone mapping library for controlling high-definition 3D characters in Three.js.
 
 Loom3 provides mappings that connect [Facial Action Coding System (FACS)](https://en.wikipedia.org/wiki/Facial_Action_Coding_System) Action Units to the morph targets and bone transforms found in Character Creator 4 (CC4) characters. Instead of manually figuring out which blend shapes correspond to which facial movements, you can simply say `setAU(12, 0.8)` and the library handles the rest.
 

package/dist/index.cjs

@@ -25,6 +25,20 @@ var THREE__namespace = /*#__PURE__*/_interopNamespace(THREE);
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/engines/three/balanceUtils.ts
+function clampBalance(value) {
+  if (!Number.isFinite(value)) return 0;
+  return Math.max(-1, Math.min(1, value));
+}
+function resolveCurveBalance(curveId, globalBalance, balanceMap) {
+  if (balanceMap && Object.prototype.hasOwnProperty.call(balanceMap, curveId)) {
+    return clampBalance(Number(balanceMap[curveId]));
+  }
+  return clampBalance(globalBalance);
+}
+
+// src/engines/three/AnimationThree.ts
 var easeInOutQuad = (t) => t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t;
 var AnimationThree = class {
   constructor() {
@@ -136,6 +150,18 @@ var BakedAnimationController = class {
     __publicField(this, "actionIdToClip", /* @__PURE__ */ new Map());
     this.host = host;
   }
+  getMeshNamesForAU(auId, config, explicitMeshNames) {
+    if (explicitMeshNames && explicitMeshNames.length > 0) {
+      return explicitMeshNames;
+    }
+    if (typeof this.host.getMeshNamesForAU === "function") {
+      return this.host.getMeshNamesForAU(auId) || [];
+    }
+    const facePart = config.auInfo?.[String(auId)]?.facePart;
+    if (facePart === "Tongue") return config.morphToMesh?.tongue || [];
+    if (facePart === "Eye") return config.morphToMesh?.eye || [];
+    return config.morphToMesh?.face || [];
+  }
   update(dtSeconds) {
     if (this.animationMixer) {
       this.animationMixer.update(dtSeconds);
@@ -384,7 +410,8 @@ var BakedAnimationController = class {
     }
     const tracks = [];
     const intensityScale = options?.intensityScale ?? 1;
-    const balance = options?.balance ?? 0;
+    const globalBalance = options?.balance ?? 0;
+    const balanceMap = options?.balanceMap;
     const meshNames = options?.meshNames;
     let maxTime = 0;
     const isNumericAU = (id) => /^\d+$/.test(id);
@@ -435,35 +462,37 @@ var BakedAnimationController = class {
             this.addMorphTracks(tracks, visemeKey, keyframes, intensityScale, meshNames);
           }
         } else {
+          const auMeshNames = this.getMeshNamesForAU(auId, config, meshNames);
           const morphsBySide = config.auToMorphs[auId];
           const mixWeight = this.host.isMixedAU(auId) ? this.host.getAUMixWeight(auId) : 1;
           const leftKeys = morphsBySide?.left ?? [];
           const rightKeys = morphsBySide?.right ?? [];
           const centerKeys = morphsBySide?.center ?? [];
+          const curveBalance = resolveCurveBalance(curveId, globalBalance, balanceMap);
           for (const morphKey of leftKeys) {
             let effectiveScale = intensityScale * mixWeight;
-            if (balance > 0) effectiveScale *= 1 - balance;
+            if (curveBalance > 0) effectiveScale *= 1 - curveBalance;
             if (typeof morphKey === "number") {
-              this.addMorphIndexTracks(tracks, morphKey, keyframes, effectiveScale, meshNames);
+              this.addMorphIndexTracks(tracks, morphKey, keyframes, effectiveScale, auMeshNames);
             } else {
-              this.addMorphTracks(tracks, morphKey, keyframes, effectiveScale, meshNames);
+              this.addMorphTracks(tracks, morphKey, keyframes, effectiveScale, auMeshNames);
             }
           }
           for (const morphKey of rightKeys) {
             let effectiveScale = intensityScale * mixWeight;
-            if (balance < 0) effectiveScale *= 1 + balance;
+            if (curveBalance < 0) effectiveScale *= 1 + curveBalance;
             if (typeof morphKey === "number") {
-              this.addMorphIndexTracks(tracks, morphKey, keyframes, effectiveScale, meshNames);
+              this.addMorphIndexTracks(tracks, morphKey, keyframes, effectiveScale, auMeshNames);
             } else {
-              this.addMorphTracks(tracks, morphKey, keyframes, effectiveScale, meshNames);
+              this.addMorphTracks(tracks, morphKey, keyframes, effectiveScale, auMeshNames);
             }
           }
           for (const morphKey of centerKeys) {
             const effectiveScale = intensityScale * mixWeight;
             if (typeof morphKey === "number") {
-              this.addMorphIndexTracks(tracks, morphKey, keyframes, effectiveScale, meshNames);
+              this.addMorphIndexTracks(tracks, morphKey, keyframes, effectiveScale, auMeshNames);
             } else {
-              this.addMorphTracks(tracks, morphKey, keyframes, effectiveScale, meshNames);
+              this.addMorphTracks(tracks, morphKey, keyframes, effectiveScale, auMeshNames);
             }
           }
         }
@@ -851,11 +880,9 @@ var BakedAnimationController = class {
   }
   addMorphTracks(tracks, morphKey, keyframes, intensityScale, meshNames) {
     const config = this.host.getConfig();
-    const meshes = this.host.getMeshes();
     const hasExplicitMeshes = !!(meshNames && meshNames.length > 0);
     const targetMeshNames = hasExplicitMeshes ? meshNames : config.morphToMesh?.face || [];
-    const targetMeshes = targetMeshNames.length ? targetMeshNames.map((name) => this.host.getMeshByName(name)).filter(Boolean) : meshes;
-    let added = false;
+    const targetMeshes = targetMeshNames.length ? targetMeshNames.map((name) => this.host.getMeshByName(name)).filter(Boolean) : [];
     const addTrackForMesh = (mesh) => {
       const dict = mesh.morphTargetDictionary;
       if (!dict || dict[morphKey] === void 0) return;
@@ -869,25 +896,17 @@ var BakedAnimationController = class {
       const trackName = `${mesh.uuid}.morphTargetInfluences[${morphIndex}]`;
       const track = new THREE.NumberKeyframeTrack(trackName, times, values);
       tracks.push(track);
-      added = true;
     };
     for (const mesh of targetMeshes) {
       addTrackForMesh(mesh);
     }
-    if (!added && !hasExplicitMeshes && targetMeshes !== meshes) {
-      for (const mesh of meshes) {
-        addTrackForMesh(mesh);
-      }
-    }
   }
   addMorphIndexTracks(tracks, morphIndex, keyframes, intensityScale, meshNames) {
     if (!Number.isInteger(morphIndex) || morphIndex < 0) return;
     const config = this.host.getConfig();
-    const meshes = this.host.getMeshes();
     const hasExplicitMeshes = !!(meshNames && meshNames.length > 0);
     const targetMeshNames = hasExplicitMeshes ? meshNames : config.morphToMesh?.face || [];
-    const targetMeshes = targetMeshNames.length ? targetMeshNames.map((name) => this.host.getMeshByName(name)).filter(Boolean) : meshes;
-    let added = false;
+    const targetMeshes = targetMeshNames.length ? targetMeshNames.map((name) => this.host.getMeshByName(name)).filter(Boolean) : [];
     const addTrackForMesh = (mesh) => {
       const infl = mesh.morphTargetInfluences;
       if (!infl || morphIndex < 0 || morphIndex >= infl.length) return;
@@ -900,16 +919,10 @@ var BakedAnimationController = class {
       const trackName = `${mesh.uuid}.morphTargetInfluences[${morphIndex}]`;
       const track = new THREE.NumberKeyframeTrack(trackName, times, values);
       tracks.push(track);
-      added = true;
     };
     for (const mesh of targetMeshes) {
       addTrackForMesh(mesh);
     }
-    if (!added && !hasExplicitMeshes && targetMeshes !== meshes) {
-      for (const mesh of meshes) {
-        addTrackForMesh(mesh);
-      }
-    }
   }
   ensureMixer() {
     const model = this.host.getModel();
@@ -3513,6 +3526,7 @@ var _Loom3 = class _Loom3 {
       getModel: () => this.model,
       getMeshes: () => this.meshes,
       getMeshByName: (name) => this.meshByName.get(name),
+      getMeshNamesForAU: (auId) => this.getMeshNamesForAU(auId),
       getBones: () => this.bones,
       getConfig: () => this.config,
       getCompositeRotations: () => this.compositeRotations,
@@ -3558,15 +3572,11 @@ var _Loom3 = class _Loom3 {
     this.resolvedFaceMeshes = this.resolveFaceMeshes(this.meshes);
     this.faceMesh = this.resolvedFaceMeshes.length > 0 ? this.meshByName.get(this.resolvedFaceMeshes[0]) || null : null;
     if (!this.config.morphToMesh?.face || this.config.morphToMesh.face.length === 0) {
-      const morphMeshNames = this.meshes.filter((m) => {
-        const infl = m.morphTargetInfluences;
-        const dict = m.morphTargetDictionary;
-        return Array.isArray(infl) && infl.length > 0 || dict && Object.keys(dict).length > 0;
-      }).map((m) => m.name).filter(Boolean);
-      if (morphMeshNames.length > 0) {
+      const faceMeshNames = this.resolvedFaceMeshes.filter((name) => this.meshByName.has(name));
+      if (faceMeshNames.length > 0) {
         this.config.morphToMesh = {
           ...this.config.morphToMesh,
-          face: Array.from(new Set(morphMeshNames))
+          face: Array.from(new Set(faceMeshNames))
         };
       }
     }