mesh-avatar 0.1.1 → 0.2.1

package/README.md

@@ -2,6 +2,13 @@
 
 A WebGL runtime for 2D mesh avatars created with [Mesh Avatar Studio](https://github.com/shinshin86/mesh-avatar-studio). Load a `.mavatar` archive or an avatar folder into a canvas, then control its motion, voice level and expressions.
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/shinshin86/mesh-avatar-studio/main/docs/images/face-tracking.gif" width="400" alt="A Mesh Avatar Studio avatar following a face through a webcam">
+</p>
+
+To move an avatar with your own face and voice without installing anything, open the
+[Player](https://shinshin86.github.io/mesh-avatar-studio/play/) in Chrome or Edge.
+
 ## Install
 
 ```sh

package/dist/engine/sprites.d.ts

@@ -5,12 +5,16 @@ export function createSpriteModule(engine: ReturnType<typeof import("./rig.js").
         /**
          * Show / hide and deform the sprites for this frame.
          * Returns which eyes are covered by a sprite, so the layered eye parts can be hidden.
+         * `mood` (angry / sad / surprise) picks drawn expression eyes (sad, surprise) and closed
+         * mouths (angry, sad) when the avatar has them.
          */
-        update(P: any, phys: any, dt?: number): {
+        update(P: any, phys: any, dt?: number, mood?: null): {
             eyes: boolean[];
             mouth: any;
         };
     };
     mouthShape: (open: any, form: any, prev?: null) => any;
-    eyeSprite: (open: any, smile: any) => "eyes_smile" | "eyes_closed" | "eyes_half" | null;
+    eyeSprite: (open: any, smile: any, mood?: null) => "eyes_smile" | "eyes_closed" | "eyes_half" | null;
 };
+/** The drawn-eye / mouth mood for the live expression, else for the motion expression (if it is applied). */
+export function eyeMood(overlay: any, expression: any): any;