@ikijs/editor 0.32.0 → 0.33.0

package/README.md

@@ -78,7 +78,7 @@ edge further outside the back hair painted behind it than the nod alone does —
 and the back hair stays behind; the neck and the
 ears the face layer paints are cut off into islands of the plate's own mesh,
 drawn behind the head — the neck stays (only the chin's shade slides across
-it), the ears lag the face, the far one narrowing. AngleZ rolls the head 14° about the chin.
+it), the ears lag the face, the far one held while the head slides partly over it (about half of an ear of the default size). AngleZ rolls the head 14° about the chin.
 A `body` rides a body warp that breathes, follows the head's turn and tilt a
 little and turns on `ParamBodyAngleX/Y/Z`, its legs planted, and the head
 hangs from it. `arm_L` / `arm_R`, each a whole arm drawn hanging with its
@@ -97,7 +97,7 @@ the turn's amount, the eyes' foreshortening, the hair's width, a feature's own
 shift. With none given the profile itself renders (`DEFAULT_TURN_TARGETS`
 expresses it in the cues' units). `options.rigPlan` tunes a character from the
 profile in three groups (`turn`, `hair`, `eyes`: the whole turn, the
-features' lead, the front hair's follow and its outline's, the blink and the
+features' lead, the far ear's follow, the front hair's follow and its outline's, the blink and the
 hair sway), validated against `RIG_PLAN_FIELDS`. `options.patches` adds displacements to a generated rig's keyform
 stops (`RigPatch`), replayed on every rig and reported through
 `options.onPatchesApplied`; a refused op throws `PatchError`. `options.customParts` adds parts the

package/dist/index.d.mts

@@ -709,6 +709,9 @@ interface RigPlan {
         /** How far the nose leads the plate (turn only — the nod keeps the
          *  profile's nose depth). */
         noseLead?: number;
+        /** How far the far ear's outer edge follows the face (0: it holds and
+         *  the head slides over it; 1: it rides with the face and stays whole). */
+        farEar?: number;
     };
     hair?: {
         /** The front hair's share of the face's turn. */

package/dist/index.d.ts

@@ -709,6 +709,9 @@ interface RigPlan {
         /** How far the nose leads the plate (turn only — the nod keeps the
          *  profile's nose depth). */
         noseLead?: number;
+        /** How far the far ear's outer edge follows the face (0: it holds and
+         *  the head slides over it; 1: it rides with the face and stays whole). */
+        farEar?: number;
     };
     hair?: {
         /** The front hair's share of the face's turn. */

package/dist/index.js

@@ -2064,7 +2064,8 @@ var PROFILE_VALUES = {
   hairFollow: 1,
   fore: 0.2,
   backShare: 0.1,
-  earFar: 0.5,
+  earFar: 0,
+  earFore: 0.1,
   nodDown: 0.18,
   nodUp: 0.1,
   nodLead: 0.06,
@@ -2131,7 +2132,7 @@ function deriveProfile(v) {
     earNear: 1,
     /** The far ear's width at full turn, about its outer edge, where the head
      *  leaves it room; less where it does not. */
-    earFarScale: 1 - v.fore
+    earFarScale: 1 - v.earFore
   };
   const mid = v.nodDown * (1 + v.chinShare) / 2;
   const feature = (depth) => ({
@@ -3024,6 +3025,7 @@ function mouthAnchor(byRole) {
 }
 
 // src/auto-rig/head.ts
+var EAR_EDGE = 3;
 function outerEdge(runs, axisX, side) {
   if (runs.length === 0) return void 0;
   const x = side > 0 ? runs[runs.length - 1] : runs[0];
@@ -3057,7 +3059,11 @@ function findEars(raw, wMax, firstRow, lastRow, minRows, maxRows) {
     if (raw[t] - raw[t - EAR_ROWS] < step) continue;
     for (let b = t + minRows; b <= Math.min(lastRow, t + maxRows); b++) {
       if (raw[b - EAR_ROWS] - raw[b] >= step) {
-        return { top: t - EAR_ROWS, bottom: b };
+        let end = b;
+        for (let k = b + 1; k <= Math.min(lastRow, b + minRows); k++) {
+          if (raw[k - EAR_ROWS] - raw[k] >= step) end = k;
+        }
+        return { top: t - EAR_ROWS, bottom: end };
       }
     }
     return void 0;
@@ -3135,6 +3141,7 @@ function buildHeadFrame(layers, opts) {
       return rows[i] + (rows[j] - rows[i]) * clamp(r - i, 0, 1);
     };
     const rawRows = raw;
+    let earRows;
     const earless = (chin) => {
       const rowOf = (y) => Math.round(canvasH / 2 - y - faceLayer.bbox.y - 0.5);
       const span3 = Math.max(1, eyeY - chin);
@@ -3157,8 +3164,10 @@ function buildHeadFrame(layers, opts) {
         top: rowY(top) + 0.5,
         bottom: rowY(bottom) - 0.5,
         attachAt: (y) => attach(clamp(canvasH / 2 - y - faceLayer.bbox.y - 0.5, top, bottom)),
-        outer
+        outer,
+        edgeAt: (y) => attach(clamp(canvasH / 2 - y - faceLayer.bbox.y - 0.5, top, bottom)) + EAR_EDGE
       };
+      earRows = { top, bottom };
       return smoothProfile(
         rawRows.map((v, r) => r > top && r < bottom ? attach(r) : v)
       );
@@ -3280,9 +3289,13 @@ function buildHeadFrame(layers, opts) {
       headHalfAt = readRows(head);
       headMax = Math.max(...head);
       if (ears !== void 0) {
+        const band = earRows;
+        const edge = head.map(
+          (w, r) => r >= band.top && r <= band.bottom ? w + EAR_EDGE : w
+        );
         const bottomOf = (d) => {
-          for (let r = head.length - 1; r >= 0; r--) {
-            if (head[r] >= d) return rowY(r) - 0.5;
+          for (let r = edge.length - 1; r >= 0; r--) {
+            if (edge[r] >= d) return rowY(r) - 0.5;
           }
           return face.y1;
         };
@@ -3482,7 +3495,7 @@ function earField(m) {
     const attach = ears.attachAt(y);
     const span3 = Math.max(1, ears.outer - attach);
     if (sideOf(m, x, s) === "far") {
-      const rim2 = TURN.earFar * m.face;
+      const rim2 = m.earFar * m.face;
       const root2 = earRoot(m, face, y, s);
       const lead = Math.max(
         0,
@@ -3507,7 +3520,7 @@ function farEarCovered(m) {
   const ears = m.frame.ears;
   if (ears === void 0) return true;
   const face = faceField(m);
-  const rim = TURN.earFar * m.face;
+  const rim = m.earFar * m.face;
   const y0 = ears.bottom - 2;
   const y1 = ears.top + 2;
   const n = Math.max(1, Math.ceil(y1 - y0));
@@ -4348,6 +4361,7 @@ function fitTurn(ctx, targets, plan, build) {
     lead: plan.turn.featureLead,
     follow: plan.hair.follow,
     outline: plan.hair.outlineFollow,
+    earFar: plan.turn.farEar,
     fore: targets.farEyeRatio === void 0 ? plan.turn.eyeForeshorten : 1,
     shell: 1,
     noseLead: targets.noseShift !== void 0 || plan.turn.noseLead === 1 ? void 0 : plan.turn.noseLead
@@ -4584,6 +4598,7 @@ function buildTurn(frame, landmarks, q, turn) {
     hairOuter: q.outline * face,
     hairBack: A * hh * turn.hairBack,
     shellScale: q.shell,
+    earFar: q.earFar,
     earFarScale: 1 + A * (turn.earFarScale - 1),
     ...landmarks
   };
@@ -4671,6 +4686,23 @@ var RIG_PLAN_FIELDS = [
     migratedFrom: null,
     what: "how far the nose leads the face plate on the turn \u2014 turn only, the nod keeps the profile's nose depth"
   },
+  {
+    path: "turn.farEar",
+    group: "turn",
+    key: "farEar",
+    kind: "absolute",
+    unit: "share of the face plate's slide",
+    default: PROFILE.TURN.earFar,
+    range: [0, 1],
+    recommended: [0, 0.5],
+    step: 0.1,
+    poses: TURN_POSES,
+    cue: null,
+    fitBy: null,
+    provisional: false,
+    migratedFrom: null,
+    what: "how far the far ear's outer edge follows the face on the turn (0: it holds and the head slides over it, about half of a default-sized ear going under the face; 1: it rides with the face and stays whole)"
+  },
   {
     path: "hair.follow",
     group: "hair",
@@ -6757,6 +6789,11 @@ function buildFaceMesh(frame, b, head, neckCells) {
       frame.axisX - frame.headMax + 0.5,
       frame.axisX + frame.headMax - 0.5
     ];
+    const ears2 = frame.ears;
+    if (ears2 !== void 0 && neck2 === void 0) {
+      const d = ears2.edgeAt(ears2.bottom);
+      at.push(frame.axisX - d, frame.axisX + d);
+    }
     if (neck2 !== void 0) {
       at.push(
         frame.axisX,