@ikijs/editor 0.10.1 → 0.11.0

package/README.md

@@ -133,15 +133,20 @@ radius. It also takes the optional `denseCore`, the tight box of a layer's alpha
 width are the nose's turn landmark, so a shaded nose is fitted by its drawing
 rather than its soft feather, and its top edge at its centre x is the bridge top
 the nose tilts 6° about on the turn, its tip toward the far side; absent, the
-crop stands in for both.
+crop stands in for both. And it takes the optional `rowRuns` (per crop row, the
+row's alpha ≥ 128 runs as a flat list of canvas columns `[start, end, …]`, each
+end exclusive), measured for `hair_front` and `hair_back` so the turn and the
+nod can tell where back hair is painted behind the front hair; absent, the front
+hair keeps its outline hold on the turn and its crown's ease to the back hair's
+nod looking down.
 
 `createLayerSetMeasurer(canvas)` measures all of it — `rowHalfWidths`,
-`denseCore`, `headHalfWidth`, `headEdges` and `strandEdges` — off the RGBA a
-host decoded, one layer at a time: `add` each layer while its pixels are in
-memory (it keeps no reference to them), then `finish` for the `LayerInput`s and
-the `turnOptions` to pass the generator. A caller's own `turnTargets` go
-underneath `turnOptions.turnTargets`: spread the caller's targets first, then
-the measured ones.
+`rowRuns`, `denseCore`, `headHalfWidth`, `headEdges` and `strandEdges` — off
+the RGBA a host decoded, one layer at a time: `add` each layer while its pixels
+are in memory (it keeps no reference to them), then `finish` for the
+`LayerInput`s and the `turnOptions` to pass the generator. A caller's own
+`turnTargets` go underneath `turnOptions.turnTargets`: spread the caller's
+targets first, then the measured ones.
 
 `*_L` / `*_R` are the **character's** sides — `eye_L` is the character's left
 eye, which appears on the viewer's right.

package/dist/index.d.mts

@@ -674,7 +674,11 @@ interface RigStyle {
      *  profile 1.1). */
     hairFollow?: number;
     /** Its outer edge's share, where the front hair draws the head's outline
-     *  (profile 0: the outline holds; `hairFollow` rides it whole). */
+     *  and no back hair paints behind that edge (profile 0: the outline holds;
+     *  `hairFollow` rides it whole). Where back hair does, the edge rides
+     *  further, as far as that back hair stays behind it through the turn and
+     *  the nod, up to the front hair's follow there (`hairFollow`; over the
+     *  far eye's rows, as far as that eye's outer corner goes). */
     outlineFollow?: number;
     /** How far the upper lid comes down, over the eye's height (0.30–0.67). */
     blink?: number;
@@ -706,6 +710,12 @@ interface LayerInput {
     cropH: number;
     /** Face only: half the opaque span of each crop row, canvas px (0 = none). */
     rowHalfWidths?: number[];
+    /** `hair_front` / `hair_back` only: per crop row, its opaque (alpha ≥ 128)
+     *  runs as a flat list of canvas columns `[start0, end0, start1, end1, …]`,
+     *  each end exclusive (`[]` for a row with none). The actual pixels, so a
+     *  gap in the hair is a gap here: the turn and the nod read off it where
+     *  back hair is painted behind the front hair. */
+    rowRuns?: number[][];
     /** Nose only: the tight box of its alpha ≥ 128 pixels, canvas px. */
     denseCore?: {
         x: number;
@@ -987,13 +997,14 @@ interface RgbaLayer {
 interface LayerSetMeasurer {
     /**
      * Measure one layer while its `rgba` is in memory, keeping no reference to
-     * it: only the set's opaque union, this layer's per-row opaque extent and,
-     * for `hair_front`, its opaque mask outlive the call, so the host may drop
-     * `rgba` as soon as it returns. Returns the layer's `LayerInput` — its crop
-     * box, the face's `rowHalfWidths`, the nose's `denseCore` unless that is a
-     * speck of its crop (`isSpeckCore`) — or `null` for an empty layer, one with
-     * no pixel at or above `ALPHA_BBOX_THRESHOLD`, which it records nothing for:
-     * the host reports that with its own error. Throws, naming the file, when
+     * it: only the set's opaque union, this layer's per-row opaque extent and
+     * the `LayerInput` it returns outlive the call, so the host may drop `rgba`
+     * as soon as it returns. Returns the layer's `LayerInput` — its crop
+     * box, the face's `rowHalfWidths`, the hair layers' `rowRuns`, the nose's
+     * `denseCore` unless that is a speck of its crop (`isSpeckCore`) — or
+     * `null` for an empty layer, one with no pixel at or above
+     * `ALPHA_BBOX_THRESHOLD`, which it records nothing for: the host reports
+     * that with its own error. Throws, naming the file, when
      * `rgba` is not `width × height × 4` long; checking the decoded dimensions
      * is the host's job.
      */

package/dist/index.d.ts

@@ -674,7 +674,11 @@ interface RigStyle {
      *  profile 1.1). */
     hairFollow?: number;
     /** Its outer edge's share, where the front hair draws the head's outline
-     *  (profile 0: the outline holds; `hairFollow` rides it whole). */
+     *  and no back hair paints behind that edge (profile 0: the outline holds;
+     *  `hairFollow` rides it whole). Where back hair does, the edge rides
+     *  further, as far as that back hair stays behind it through the turn and
+     *  the nod, up to the front hair's follow there (`hairFollow`; over the
+     *  far eye's rows, as far as that eye's outer corner goes). */
     outlineFollow?: number;
     /** How far the upper lid comes down, over the eye's height (0.30–0.67). */
     blink?: number;
@@ -706,6 +710,12 @@ interface LayerInput {
     cropH: number;
     /** Face only: half the opaque span of each crop row, canvas px (0 = none). */
     rowHalfWidths?: number[];
+    /** `hair_front` / `hair_back` only: per crop row, its opaque (alpha ≥ 128)
+     *  runs as a flat list of canvas columns `[start0, end0, start1, end1, …]`,
+     *  each end exclusive (`[]` for a row with none). The actual pixels, so a
+     *  gap in the hair is a gap here: the turn and the nod read off it where
+     *  back hair is painted behind the front hair. */
+    rowRuns?: number[][];
     /** Nose only: the tight box of its alpha ≥ 128 pixels, canvas px. */
     denseCore?: {
         x: number;
@@ -987,13 +997,14 @@ interface RgbaLayer {
 interface LayerSetMeasurer {
     /**
      * Measure one layer while its `rgba` is in memory, keeping no reference to
-     * it: only the set's opaque union, this layer's per-row opaque extent and,
-     * for `hair_front`, its opaque mask outlive the call, so the host may drop
-     * `rgba` as soon as it returns. Returns the layer's `LayerInput` — its crop
-     * box, the face's `rowHalfWidths`, the nose's `denseCore` unless that is a
-     * speck of its crop (`isSpeckCore`) — or `null` for an empty layer, one with
-     * no pixel at or above `ALPHA_BBOX_THRESHOLD`, which it records nothing for:
-     * the host reports that with its own error. Throws, naming the file, when
+     * it: only the set's opaque union, this layer's per-row opaque extent and
+     * the `LayerInput` it returns outlive the call, so the host may drop `rgba`
+     * as soon as it returns. Returns the layer's `LayerInput` — its crop
+     * box, the face's `rowHalfWidths`, the hair layers' `rowRuns`, the nose's
+     * `denseCore` unless that is a speck of its crop (`isSpeckCore`) — or
+     * `null` for an empty layer, one with no pixel at or above
+     * `ALPHA_BBOX_THRESHOLD`, which it records nothing for: the host reports
+     * that with its own error. Throws, naming the file, when
      * `rgba` is not `width × height × 4` long; checking the decoded dimensions
      * is the host's job.
      */