@rig-c/parts 2.44.0 → 2.45.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -0
- package/cli.ts +130 -33
- package/docs/AUTHORING.md +365 -79
- package/docs/DEPTH.md +33 -6
- package/docs/MIGRATION.md +2 -0
- package/docs/STABILITY.md +353 -39
- package/package.json +1 -1
- package/src/boundarydepth.ts +113 -0
- package/src/check.ts +296 -78
- package/src/cloth.ts +14 -3
- package/src/config.ts +78 -11
- package/src/configwrite.ts +3 -3
- package/src/diffdrafts.ts +593 -0
- package/src/editedparts.ts +11 -2
- package/src/externalreceipt.ts +130 -0
- package/src/maskvalues.ts +21 -0
- package/src/outputpaths.ts +40 -0
- package/src/parts.ts +14 -5
- package/src/plate.ts +2 -6
- package/src/propose.ts +165 -8
- package/src/receiptproducer.ts +41 -0
- package/src/remesh-api.ts +33 -0
- package/src/remesh.ts +197 -19
- package/src/remeshdelta.ts +143 -30
- package/src/rig.ts +95 -21
- package/src/scene.ts +45 -9
- package/src/sceneclips.ts +60 -1
- package/src/turn.ts +24 -3
- package/tools/edited-part-cli.ts +12 -3
package/docs/AUTHORING.md
CHANGED
|
@@ -1115,6 +1115,41 @@ receipt is demanded, and a run with no author-made or hidden-art layer, no
|
|
|
1115
1115
|
`under` and no `cap` demands none either. Absent the block, no file is read and
|
|
1116
1116
|
every output is byte-identical to a build without it.
|
|
1117
1117
|
|
|
1118
|
+
### External mask receipt
|
|
1119
|
+
|
|
1120
|
+
Record an externally produced mask with
|
|
1121
|
+
`rig-parts external-receipt --kind mask --file <mask.png> --painting <painting.png> --producer <json> --out <receipt.json>`.
|
|
1122
|
+
Both inputs must decode as PNG and their measured widths and heights must
|
|
1123
|
+
match. Pixel coordinates start at the upper left and no resampling is applied.
|
|
1124
|
+
Each mask pixel must be opaque black (outside) or opaque white (inside), using
|
|
1125
|
+
the same pixel check as `comfy plate`. These checks measure pixel dimensions
|
|
1126
|
+
and values. Content alignment is the producer's responsibility.
|
|
1127
|
+
|
|
1128
|
+
Command paths resolve from the working directory. Use an unused output path
|
|
1129
|
+
in an existing writable directory. The command publishes the receipt only
|
|
1130
|
+
after validation. It reads the image files without altering them. The receipt
|
|
1131
|
+
is UTF-8 JSON with two-space indentation and a trailing newline.
|
|
1132
|
+
|
|
1133
|
+
| Key in write order | Type and source |
|
|
1134
|
+
| --- | --- |
|
|
1135
|
+
| `spec` | Literal string `rig-parts-external-receipt/1`. |
|
|
1136
|
+
| `kind` | Literal string `mask`. |
|
|
1137
|
+
| `file` | Object with `path` then `sha256`. The path is relative to the receipt directory, uses forward slashes and may include `../`. The lowercase 64-hex SHA-256 is measured from the mask PNG bytes. |
|
|
1138
|
+
| `painting` | Object with the same ordered keys and types as `file`, measured from the painting path and PNG bytes. |
|
|
1139
|
+
| `grid` | Object with `width` then `height`, positive integers measured by decoding the painting PNG. |
|
|
1140
|
+
| `producer` | Object with required nonblank string `tool`, optional nonblank string `model`, then exactly one lowercase 64-hex SHA-256 string in `checkpoint_sha256`, `graph_sha256` or `script_sha256`. These values come from the caller's JSON argument. |
|
|
1141
|
+
|
|
1142
|
+
The producer declaration does not prove which tool generated the mask or
|
|
1143
|
+
verify the digest of the declared producer artifact. No polygon, coordinates
|
|
1144
|
+
or typed geometry are inputs.
|
|
1145
|
+
|
|
1146
|
+
Run `rig-parts external-receipt --verify <receipt.json>` by itself to validate
|
|
1147
|
+
the receipt version and shape, resolve its paths relative to its directory,
|
|
1148
|
+
recompute both hashes, and recheck the pixel dimensions and mask values.
|
|
1149
|
+
Verify writes nothing. `setup_painting.figure_mask` continues to take the
|
|
1150
|
+
mask's own path and hash. See the [refusal ledger](#EXTERNAL_RECEIPT_ARGUMENT).
|
|
1151
|
+
|
|
1152
|
+
|
|
1118
1153
|
### Edited rig-space parts (`assemble.edited_parts`, issue #1278)
|
|
1119
1154
|
|
|
1120
1155
|
Use this block for a PNG edited at the exact crop and scale written by
|
|
@@ -1136,14 +1171,14 @@ alone does not apply a replacement.
|
|
|
1136
1171
|
```
|
|
1137
1172
|
|
|
1138
1173
|
The block belongs in `assemble`. Both fields are required; `receipts` may be
|
|
1139
|
-
empty.
|
|
1174
|
+
empty. Each receipt requires the four common fields and one author field. `part` must name an existing part
|
|
1140
1175
|
in the base plan, once only. `dir` resolves relative to the config's directory;
|
|
1141
1176
|
`file` resolves relative to that directory and must be a relative path.
|
|
1142
1177
|
Hashes are lowercase SHA-256 of encoded file bytes, including PNG metadata;
|
|
1143
1178
|
`from_sha256` is checked against the PNG the normal assemble would write for
|
|
1144
|
-
this config
|
|
1145
|
-
|
|
1146
|
-
|
|
1179
|
+
this config. Supply either the structured `producer` described under
|
|
1180
|
+
[External mask receipt](#external-mask-receipt) or a legacy nonblank `editor`
|
|
1181
|
+
string. Both forms are caller declarations. The decoded width and height must equal the assembled part's box.
|
|
1147
1182
|
A changed crop, scale, name or order needs a plan or cut change instead.
|
|
1148
1183
|
|
|
1149
1184
|
Record a receipt with the shipped writer (issue #1328), after declaring
|
|
@@ -1151,9 +1186,9 @@ Record a receipt with the shipped writer (issue #1328), after declaring
|
|
|
1151
1186
|
each full character config:
|
|
1152
1187
|
|
|
1153
1188
|
```sh
|
|
1154
|
-
rig-parts edited-part --config draft/config.json --part sleeve_r --file retouched/sleeve_r.png --from assembled/parts/sleeve_r.png --
|
|
1189
|
+
rig-parts edited-part --config draft/config.json --part sleeve_r --file retouched/sleeve_r.png --from assembled/parts/sleeve_r.png --producer '{"tool":"image-editor","script_sha256":"<lowercase 64-hex digest>"}'
|
|
1155
1190
|
# Update a second full config only when explicitly named:
|
|
1156
|
-
rig-parts edited-part --config draft/config.json --part sleeve_r --file retouched/sleeve_r.png --from assembled/parts/sleeve_r.png --
|
|
1191
|
+
rig-parts edited-part --config draft/config.json --part sleeve_r --file retouched/sleeve_r.png --from assembled/parts/sleeve_r.png --producer '{"tool":"image-editor","script_sha256":"<lowercase 64-hex digest>"}' --rig-config rig/config.json
|
|
1157
1192
|
```
|
|
1158
1193
|
|
|
1159
1194
|
CLI paths resolve from the working directory; the stored `file` resolves from
|
|
@@ -1161,15 +1196,19 @@ each config's own `edited_parts.dir`. The writer hashes the encoded PNG bytes,
|
|
|
1161
1196
|
checks that both files decode and have equal dimensions, and validates every
|
|
1162
1197
|
candidate config before writing either destination. It replaces the existing row for that
|
|
1163
1198
|
part or appends at the array's length. New rows use key order `part`, `file`,
|
|
1164
|
-
`sha256`, `from_sha256`, `
|
|
1199
|
+
`sha256`, `from_sha256`, then `producer` or `editor`. Supply exactly one of
|
|
1200
|
+
`--producer <json>` and `--editor <text>`. Omitting both is a usage error
|
|
1201
|
+
(exit 2). Other rows and unrelated config bytes retain
|
|
1165
1202
|
their original spelling and whitespace. No matching config is discovered.
|
|
1166
1203
|
|
|
1167
1204
|
The writer never reassembles or certifies the baseline. A wrong same-size
|
|
1168
1205
|
`--from` is recorded; the next build refuses `ASSEMBLE_EDITED_PART_BASELINE`,
|
|
1169
1206
|
naming the current assembled hash and the recorded hash. Supply the exact PNG
|
|
1170
1207
|
from a normal build of this config. A successful writer prints one stdout line
|
|
1171
|
-
with the part, both hashes and the
|
|
1172
|
-
|
|
1208
|
+
with the part, both hashes and the producer or editor declaration. In
|
|
1209
|
+
`parts.json`, `provenance.edited_part.receipt` carries the same five ordered
|
|
1210
|
+
fields. For a legacy row the last field remains `editor` and both the
|
|
1211
|
+
`parts.json` and edited PNG bytes are unchanged for the same inputs. The shared writer prints `config <path>: added/replaced
|
|
1173
1212
|
assemble.edited_parts.receipts[index]` or `config <path>: unchanged` on stderr.
|
|
1174
1213
|
Validation refusals leave all named configs byte-identical.
|
|
1175
1214
|
|
|
@@ -3128,7 +3167,9 @@ What each rule drafts (`src/cloth.ts` holds them):
|
|
|
3128
3167
|
| rule | drafts | from |
|
|
3129
3168
|
| --- | --- | --- |
|
|
3130
3169
|
| where | `bottomwear`: from `hip`, the root row 20 px below hip's y (the keyed chains' row), the tip row 4 px above the cloth's own bottom under each column (4 px above the part box's bottom when every column reaches the bottom band, or 4 px above where the cloth's alpha ends under that column on a floor-spread skirt whose middle hem ends above bare thighs; a column with no cloth below the root row gets no tree drafted there and emits a note saying so, issue #438). `back hair` that reaches below the shoulders: from `head`, per side of the eye axis (twin tails are a side each), the eye line to 4 px above its bottom. `front hair`: each qualifying strand that hangs below the chin (the lock rule's: each connected component below `chin + 4` of height at least `0.3` face heights, `src/propose.ts`), from `head`, 0.22 face heights above the eye line to 5 px below the strand — the recipe's `chains`, `links` and `split` are applied separately to each qualifying hanging strand and do not replace the fringe's fixed three two-link columns (`bang_r`, `bang_c`, `bang_l` keep their two links and their places and take physics on both links) | the keyed chains' own rows, which these replace |
|
|
3170
|
+
| sleeve carrier | `handwear-r` and `handwear-l` each take one named uncut part with the matching source tag. Give the side's elbow in `--keypoints`. The elbow row begins the span and the last opaque row in each column ends it. The named Form 1 sleeve hangs from `chest` with physics on its trees and the upper carrier fixed to `chest`. The recipe refuses a shared or joint-cut carrier. | `part`, the elbow, and the part's opaque art |
|
|
3131
3171
|
| trees | tree k of `chains` (`N`) owns the cell k/N .. (k+1)/N of the art's width in every row, and its links sit at the cell's centre in the 24-row band there, so a piece that widens fans its trees. **Count unit of `chains`:** on `back hair`, an explicit `chains: N` is passed to **each emitted side of the eye axis** (`N` trees on `r` and `N` on `l` when both sides emit, not a combined total across both sides; `src/cloth.ts`, `src/propose.ts`); on `front hair`, `chains: N` is applied **separately to each qualifying hanging strand** and does not replace the fringe's fixed two-link columns (`src/propose.ts`). On `back hair`, `chains` is optional (issues #390, #445, #461): when omitted, `propose --cloth` derives the tree count on each side from the side's **visible hair masses** and root-row reach — it is **not** a universal default of 1 or 2 trees for every painting (`RECIPE_BACK_HAIR_CHAINS = 2` in `src/cloth.ts` is only the fallback when `draftTrees` is called with neither `masses` nor `chains`) — connected components of the `back hair` part's alpha below the eye-line root row (after skipping any undivided crown rows that bridge continuously across the eye axis), merged when they touch within one mesh grid cell — placing `max(1, floor(w / (4 * grid)) + 1)` trees inside each mass across its root-row opaque width `w` (one tree per `4 * grid` of horizontal reach, where a tree's segment weight `1 / (d + r)^2` with `r ≈ 0.42 * grid` drops to `MIN_WEIGHT = 0.03` at `2 * grid` on each side of the trunk), rooted at that mass's own top row and with every link inside that mass's column range; `propose`'s `LINT` names the masses it found and their columns when a side's tree count or link leaves them. An explicit `chains` that exceeds what the narrower side's opaque width at the eye-line root row holds (`max(1, min(floor(w_r / grid), floor(w_l / grid)))`) or places a root off the 15 px dilated art is refused (`PROPOSE_CLOTH_BACK_HAIR_CHAINS`). With `split`, the trunk's tip is the fork, and branch b of `into` follows the centre of its share of the cell. Chains are named `<prefix><k>_` (trunk) and `<prefix><k><a, b, …>_` (branches): `skirt`, `hairback_r`/`hairback_l`, `lockt`. With `split.hold_tip: true` (issues #403, #392), sibling branches keep `strength.branch` across the fork, the mesh's `r` is raised to `grid`, and the rig stage blends each fork's sibling branch weight shares across four passes of 1-ring mesh-edge averaging (self weight 0.5, floor 0.005, cap 8 influences) — every share alike, trunk, branch and fixed bones, none held in place — holding the triangles where two branches' cells meet; when the recipe also declares `influence`, the drafted influence mesh carries `hold_tip: true` and `max` at least 8, and the rig stage smooths it by the same passes capped at that `max` (issue #615, the `meshes.<part>.influence` row) | `chains`, `links`, `split` |
|
|
3172
|
+
| extent | on one bottomwear or sleeve carrier, a fraction above 0 and at most 1 measured from each tree's free end over its existing root-to-tip row span. The shortest resolved path sets the common fork root. Longer branches keep their tips and the proposal prints each realized fraction. The swing keeps its original anchor. The generated mesh field `fixed_above` holds art above the earliest tree root on the fixed frame (hip on a skirt, chest and hip on a dress). The first mesh cell crossing that row also stays fixed, so the transition lies below the root. The draft reports the held strip and first-link length for each tree and refuses a strip that reaches the end of that link. | `extent` |
|
|
3132
3173
|
| lengths | link j's length is the first's times q^j, q = `length_ratio`^(1/(links − 1)), the whole spanning root row to tip row: the links shorten toward the tip | `length_ratio` (default 0.5, below) |
|
|
3133
3174
|
| stiffness | a trunk link takes `strength.trunk`, a branch link `strength.branch`, and the edge — the outermost branch on each outer side of the piece (both sides of a skirt or a strand; the outer side of each back-hair side; or, under `split.hold_tip: true` with `strength` left out, kept at `strength.branch` so a fork's sibling branches do not pull apart at the default 2:1 stiffness), or without `split` the outermost tree — `strength.edge`; a fringe column is a trunk, its outer two the edge. **Strength does not fall along a chain**: a tip reads soft because each link turns on top of every link above it, so the motion accumulates down the chain at one strength. Only the edge is declared softer | `strength` (default trunk 100, branch 100, edge 50, below) |
|
|
3134
3175
|
| response | link j of an n-link path takes `wind` and `gravity` at j/(n − 1) of the way from the root value to the tip value; a single-link path takes the tip value. Each is a scalar **multiplier** of the environment the consumer sets (spine-core's skeleton `windX, windY`, `gravityX, gravityY`; rig-c 2.52.0's live track `setEnvironment`, rig-play 1.10.0's `environment()`): no direction is drafted | `wind`, `gravity` |
|
|
@@ -3704,8 +3745,8 @@ drives **the body with keyframes** and **every cloth and hair chain with `physic
|
|
|
3704
3745
|
constraints**. Plain `propose` (without `--cloth`) drafts keyframed harmonic `chain`
|
|
3705
3746
|
tracks on every hair, fringe, sleeve, skirt and strap chain and writes no
|
|
3706
3747
|
`constraints`, while `propose --cloth` replaces only the `cloth`-declared tags
|
|
3707
|
-
(`bottomwear`, `back hair`, `front hair
|
|
3708
|
-
`topwear` straps
|
|
3748
|
+
(`bottomwear`, `back hair`, `front hair`, and explicitly named `handwear-r` or
|
|
3749
|
+
`handwear-l` carriers). Other sleeves and `topwear` straps keep their keyframed chains. To author a Form 1 idle where cloth and hair
|
|
3709
3750
|
all move by physics instead of keyframed sine chains:
|
|
3710
3751
|
|
|
3711
3752
|
1. **Key only the body carrier in `motion.tracks`.** Keep the torso breath on `chest`
|
|
@@ -3795,7 +3836,7 @@ step-up method below.
|
|
|
3795
3836
|
| `motion.duration` and `track.period` | `check`'s 12 fps grid (`1/12` s per frame) | Choose `N` frames (e.g. `N = 40`, `duration = 40 / 12 = 3.3333333333333335` s, or `N = 48`, `duration = 4.0` s) and set every body track's `period = duration`. `CHECK_LOOP_LAST_FRAME_AT_DURATION` requires `duration` to land on a `1/12` s tick, and `CONFIG_PERIOD_DIVIDES_DURATION` requires `duration / period` to be an integer. |
|
|
3796
3837
|
| Torso breath (`chest` `translatey`, `scalex`) | Figure height `H` (`parts.json` union height, kept near `1,100..1,200` rig px via `assemble.rig_scale`), torso span `L_torso = hypot(hip.x - neck.x, hip.y - neck.y)` from `bones`, and `BREATH_VISIBLE`'s `torso_heat_mean` vs `torso_floor` (pictured in `motion_heat.png`) | Floor: peak-to-peak vertical travel at `1.25 %` of `L_torso` (`amp = round2(0.00625 * L_torso)`, `base = amp`, `phase = 0.0`, i.e. `amp = 1.2` rig px on `demo`), paired with `chest` `scalex` `amp = 0.008`, `base = 1.008`, `phase = 0.0`. `check` scales the reference floor (`2.13` at `render_scale = 0.4211`) by `render_scale / 0.4211` and isolates the breath by posing only `chest`/`hip` `translate` and `scale` tracks. |
|
|
3797
3838
|
| Upper-body sway (`chest` → `neck` → `head` `rotate`) | Shoulder lever arm `R_shoulder = \|sleeve_s0.x - chest.x\|` in `bones`, and `CHAIN_LAG` / `TIP_OVER_ROOT` on `handwear` | Floor: `amp(chest) = 0.7°`, `amp(neck) = 0.85°`, `amp(head) = 1.0°` with lag `0.05` (`phase: 0.25, 0.30, 0.35`). **Set `chest` `rotate` `phase` to `0.25` (quadrature, 90° from `chest` `translatey`'s `phase: 0.0`), never near `0.0`:** at `phase ≈ 0`, vertical breath `y(t)` and shoulder lift `Δx · θ(t)` reinforce on one shoulder and cancel on the other, inflating `root_rig_px` on the reinforced sleeve and dropping `tip_rig_px / root_rig_px` below `1.4725`. At `phase = 0.25`, vertical breath and rotational sway are orthogonal on both shoulders alike. |
|
|
3798
|
-
| Sleeve motion (`sleeve_<s>0..2` under `chest`) | `CHECK_TIP_OVER_ROOT` certifies that the lower band of each `handwear` part's box travels more than the upper band (`ratio >= 1.4725`), in the frame of the bone it hangs from; it does not prove physics. Also measure `CHECK_ANIMATIONS_DO_NOT_FOLD`. |
|
|
3839
|
+
| Sleeve motion (`sleeve_<s>0..2` under `chest`) | `CHECK_TIP_OVER_ROOT` certifies that the lower band of each `handwear` part's box travels more than the upper band (`ratio >= 1.4725`), in the frame of the bone it hangs from; it does not prove physics. Also measure `CHECK_ANIMATIONS_DO_NOT_FOLD`. | To draft a named sleeve end through the tool, use the sleeve carrier recipe above and declare its response. For a hand-authored sleeve on the existing keyed-chain geometry, set `"rotate": 1, "mix": 1, "inertia": 1.0, "damping": 0.75, "mass": 1` and taper `strength` down the chain: `[45, 30, 20]` for a 3-link sleeve (`1 : 0.67 : 0.44`). Stiff follow-through springs (`strength: 200`, `inertia: 0.2`) barely bend under a `3.333` s idle and move the sleeve as a rigid unit (`ratio ≈ 1.19..1.22`, failing `TIP_OVER_ROOT`); tapering `45 → 30 → 20` lets cumulative link rotation amplify cuff travel past `2.0x` the shoulder travel while keeping `0` folded triangles in `wave` and `hop`. Those ratios are the world reading `TIP_OVER_ROOT` took until issue #987; it now reads the halves against `chest`, the bone the sleeves hang from, and this recipe on `demo` (the working build reproduced below) reads `9.383` and `9.952` there (`handwear_l`, `handwear_r`; `3.626` and `2.905` in the world, which the row keeps as `world_ratio`) — it passes the reading the line holds (rig-parts at `c17292c` with #987's change, rigc 3.2.1). |
|
|
3799
3840
|
| Hair physics (`hairback_*`, `bang_*` under `head`) | `CLOTH_SETTLES` (`>= 0.01694` rig px/s to the last frame), `CHECK_TEXTURE_STRETCH` (`<= 1.926544`), and `CHECK_ANIMATIONS_DO_NOT_FOLD` | Taper `strength` down each `n`-link chain by `strength_0 * (1 - 0.35 * i / (n - 1))`: on long back-hair chains, `strength_0 = 90` (`[90, 74.25, 58.5]` for 3 links), `inertia = 0.8`, `damping = 0.85`; on shorter fringe chains (`bang_*`), `strength = [130, 105]`, `inertia = 0.2`, `damping = 0.9`. |
|
|
3800
3841
|
| Skirt / `bottomwear` physics (`skirt_*` under `hip`) | `CHECK_TIP_OVER_ROOT` on `bottomwear` (`ratio >= 1.4725`), `CHECK_ANIMATIONS_DO_NOT_FOLD` on `hop`, and `CLOTH_SETTLES` | Keep high restoration `strength` (`[200, 165, 130]` for 3 links, `inertia = 0.5`, `damping = 0.82`) so `bottomwear` does not fold during `hop`. With `hip` unkeyed, floor `"wind": [0.4, 0.6, 0.8]` passes `TIP_OVER_ROOT` (`ratio 1.83`); with `hip` keyed in `rotate` (`amp <= 0.4°`, `phase: 0.20`), set `"wind": 0` on the upper-half link `skirt_*0` and put `"wind"` on the lower links (`[0, 15, 40]`) so `tip / root` stays above `1.4725` and `CLOTH_SETTLES` clears on the default world. |
|
|
3801
3842
|
|
|
@@ -4117,7 +4158,7 @@ full loader before its assemble stage writes anything.
|
|
|
4117
4158
|
rig px, so every origin reads 0, each chain link's tip, length and direction its
|
|
4118
4159
|
config's, and every `<bone>_ctl` the rig stage inserted is the bone between a
|
|
4119
4160
|
keyed mesh bone and its parent (§5).
|
|
4120
|
-
**Before a person looks**, open every `out/check/extremes/<
|
|
4161
|
+
**Before a person looks**, open every `out/check/extremes/<segment>/extremes.png`
|
|
4121
4162
|
after `check` (or the check inside `build`). Read setup, the geometry pair's
|
|
4122
4163
|
min/max, and `|max - min|` at native scale. Crop every changed part boundary
|
|
4123
4164
|
at native size and 4x nearest-neighbour; label it **tear** (background or
|
|
@@ -4431,6 +4472,7 @@ existing hardlinks are refused before artifact output; the ordinary mode names
|
|
|
4431
4472
|
| `sheet --source <png> --layers <path>… --out <png>` | a labelled contact sheet of the painting and every layer or part |
|
|
4432
4473
|
| `assemble --propose-plan … [--write-config <config>]` | propose `assemble.plan` and `extend_below_crop` from the two runs, leaving out an implausible layer with a note naming the rule, naming in a note any full-run body no planned part covers, and naming every layer no row takes with why (empty, taken from the other run only, a plausibility rule; `nose`, never planned, with the row that lets `propose` read the head's pitch). Front/back hair reaching more than 8 rig pixels beyond a side or top edge receives explicit `edges`; each explicit edge has the same strict reach bar. The legacy bottom entry is retained unchanged; qualifying side/top edges receive a separate entry without bottom. With no qualifying side/top edge, the proposal remains unchanged. |
|
|
4433
4474
|
| `assemble --source --full --head --config --out [--seam] [--project]` | merge the two runs into rig-space parts, `parts.json`, the recomposite and its error map, and `run.json` (`spec` `rig-run/1`), and list the uncovered holes |
|
|
4475
|
+
| `diff-drafts --left <dir> --right <dir> --out <json>` | compare two assemble or build outputs (`rig/parts.json` + `rig/parts/` + `render/recomposite_rig.png`, or `parts.json` + `parts/` + `recomposite_rig.png`) and write `rig-parts-draft-diff/1` JSON: per-part status (`same`, `changed`, `added`, `removed`), file `sha256`, rig-pixel `box` and draw-order `index` per present side, `pixels_equal` and rig-space `pixels` (`changed_px`, `colour_px`, `alpha_px`, `bounds`) on changed parts, and `composite` ([Draft-to-draft assemble comparison](#draft-to-draft-assemble-comparison-issue-1369)) |
|
|
4434
4476
|
| `head-crop-preflight --full <run> --canvas WxH --head-box '[left,top,right,bottom]'` | before the head run: JSON on stdout, one advice line per hit tag on stderr, exit 0 even when clipped. Counts original alpha > 8 full-run samples after centre registration through the square pad into painting coordinates: centres below left/top or at/above right/bottom are outside. Fractional boxes are accepted; corner samples count on both edges. No ghost cleanup, resampling, head run or assemble is needed. These counts cannot be compared with `ASSEMBLE_CROP_CLIPPED`, which counts rig pixels at alpha >= 128 after `cleanGhosts`. Preflight reads original samples before the head run exists, so soft fringes and ghost specks can be hits only here. Bottom is distinct because `extend_below_crop` handles it. Zero-hit tags remain in JSON. Existing pipeline outputs stay unchanged; help adds this command and guide reflects these documentation edits. |
|
|
4435
4477
|
| `propose --head-box --full <run> --canvas WxH [--no-back-hair] [--write-config <config>]` | propose `seethrough.head_box` from the full run, held inside the painting; `--no-back-hair` leaves the back-hair layer out of that proposal |
|
|
4436
4478
|
| `propose --parts --source --out [--compare <config>] [--write-config <config> [--only-missing]]` | propose bones, meshes, regions and an idle; draw the overlay; print, per bone, which check read it or that none did and why (its role, its kind of segment), and write `basis.json` beside the proposal — what each bone rests on (a joint, a part's mask, a ratio, other bones) and, with `--compare`, whether the config's bone differs |
|
|
@@ -4447,7 +4489,7 @@ existing hardlinks are refused before artifact output; the ordinary mode names
|
|
|
4447
4489
|
| `mesh-draft --config <json> --parts <dir> --out <dir>` | draft contour meshes for configured lattices, keeping each only where it holds against its lattice through rig-c; write the revised config and measurement report |
|
|
4448
4490
|
| `mesh-stats --config <json> --parts <dir>` | print each configured mesh's vertex and triangle counts and their total through the rig stage's construction; write nothing |
|
|
4449
4491
|
| `painting --keypoints <json> [--person <id>] [--form standee\|illustration] <png>` | before See-through, read the painting against its declared joints (`standee` by default, or `illustration` for a framed illustration where standee border, 8-joint and gap rules report `SKIP`) and refuse named problems; write nothing |
|
|
4450
|
-
| `remesh --rig <dir> --config <json> --parts <dir> --part <name> --out <dir>` | with exactly one of `--mesh <entry.json>` or `--delta <mesh-edit.json>`, re-fit one part of a gated rig into a fresh revision, preserving the input |
|
|
4492
|
+
| `remesh --rig <dir> --config <json> --parts <dir> --part <name> --out <dir>` | with exactly one of `--mesh <entry.json>` or the legacy `--delta <mesh-edit.json>`, re-fit one part of a gated rig into a fresh revision, preserving the input |
|
|
4451
4493
|
| `retune --rig <dir> --config <json> --parts <dir> --out <dir>` | splice the config's constraints and idle onto a gated rig in a fresh revision, carrying its attachments over as bytes |
|
|
4452
4494
|
| `guide <RULE \| §<n> \| §<n>.<m> \| §<n>.<m>.<k>>` | print the one row of [docs/AUTHORING.md](AUTHORING.md) that names a rule (a refusal and the bar it enforces, `CHECK_<LINE>` and `<LINE>`, print together), or one section, `###` subsection or `####` under it, read from the installed file when it runs |
|
|
4453
4495
|
|
|
@@ -4517,7 +4559,7 @@ and a usage error with `--head-box`, `--cloth` or `--from-config`.
|
|
|
4517
4559
|
| `compare` | one line per pair (origin, parent, tip, length, direction — or SKIP and why), then the per-row summary, the unmapped bones of each side, `required:`, each side's roles and the `controls:` line | proposal against the config you corrected: the rows you changed and no others. Config against the `rig.json` `build` writes for it: measured on both examples, every origin within 6.19e-7 px (the rig's offsets are written to 6 places) and every chain link's tip and length within 4.99e-4 px (`length` is written to 3), printed to three places as `0.000` (a signed figure as `+0.000` or `-0.000`); `parent … is the right's ancestor at depth 2, <bone>_ctl between` for every keyed mesh bone, no `DIFFERENT` and no `NOT MAPPED` | `parent DIFFERENT: left a, right b` — a bone hangs from another parent than the other side's; `frames not related` — a rig with no stage (`skeleton.width`/`height`), two configs at different `rig_scale`: the distance rows SKIP, so declare the frame in a `--map` file if the author knows it; `FAIL STRUCTURE_REQUIRED_PRESENT` — a bone the map requires is missing through its pairs |
|
|
4518
4560
|
| `rig` (inside `build`) | one line per mesh: vertices, triangles, bones, influences, `cover`; the `bones` line; the `idle keys` line; then rigc's gate lines (with A15's declared SKIP under `--idle-keys direct`); in `rig.json`, each chain link's (or its `_ctl`'s) `length` and `rotation` | `cover 1.00000` on every mesh, both gate summaries `0 failed` (the compile and the packed pages); every link's `length` the distance to the next link and `rotation` its direction (Spine degrees, counter-clockwise, y up, local to the parent), every offset under it — a child bone's `x, y`, a weight's bind `x, y`, a region's `x, y` — in that turned frame, and a region on a link carrying `rotation` that turns it back upright. Nothing moved: `flattenRig` (`src/rig.ts`) turns every offset back and gives the unturned numbers | `RIG_LATTICE_ONE_LOOP`: change that mesh's `grid` |
|
|
4519
4561
|
| `check` (inside `build`) | the gate lines verbatim, the pack line, `loop:` (and `loop physics:` when the rig declares a physics constraint, §7), `seam:`, the six judgement lines, then — when `motion.json` holds an animation, the idle included — `ANIMATIONS_DO_NOT_FOLD` and one `folds` line per folding mesh, rigc's own (issues #320, #333), then — where a `footwear` part rides a bone that hangs from another — `FEET_STAY_LEVEL` and one `foot` line per such part (issue #348), then — when `parts.json` names a `handwear` part and there is an idle — `STRESS_OFF_CHAIN` (issue #347), then — where `parts.json` holds a limb segment's part — `LIMB_ONE_BONE` and one `limb` line per such part (issue #349), then — where a limb record carries a `range` — `SEAM_OVER_RANGE` and one `joint` line per joint and angle (issue #360), then `SEAM_OVER_MOTION` — a SKIP naming why on a rig that declares no neighbour pair, else the pairs read in every animation; existing internal-joint and explicit-seam pairs retain their `WARN seam` policy (issue #493), while proven body-root tears print `FAIL seam` and fail a counted bar (issue #686), then `CLOTH_SETTLES` — a SKIP naming why on a rig with no physics constraint, else the chains read and one `WARN chain` line per chain whose tip comes to rest before the idle's loop length (issue #501, a warning and never a bar), then `figure_openings:` — `CLEAR` or `WARN` with the undeclared setup-overlapping pairs, animations and cell size read and one `WARN opening` line per pair and animation whose transparent interior opening exceeds the one-cell floor, or a named `SKIP` when there is no `parts.json`, no animation or no undeclared setup-overlapping pair (issue #933, a warning and never a bar), `RECOMPOSITE_HOLES` and, under `--source`, `SETUP_POSE_VS_SOURCE` (§7), `check.json`; the last line says how many of the bars measured — nine, ten with the fold bar, one more each with the feet-level bar, the stress bar, the limb bar, the range bar and, where proven body-root pairs exist, the body-root seam bar — and names the ones that said SKIP, then — where `SEAM_OVER_MOTION` read a pair — how many warnings it printed, `; N warning(s) (SEAM_OVER_MOTION, not a bar)` — with `CLOTH_SETTLES` named beside it, and N their sum, where the rig declares a physics constraint — which no bar counts | `check: PASS; 11 of 11 bar(s) measured, 0 skipped` on `demo` and `scarf`, whose sleeves each ride one chain; `check: PASS; 10 of 11 bar(s) measured, 1 skipped (STRESS_OFF_CHAIN)` on `reference-demo` and `reference-sample`, whose one `sleeves` mesh rides both sleeve chains (issue #347) — no example writes `FEET_STAY_LEVEL`, every shoe riding `root`; a judgement line SKIP only where the character lacks what it reads; on a rig spec with no `parts.json` or no `idle` (a merged rig, §7 *Measuring a rig rig-parts did not assemble*), PASS with the skipped bars named | `CHECK_SEAM_WITHIN_BAR` or `CHECK_LOOP_CLOSES` (§6); `CHECK_ANIMATIONS_DO_NOT_FOLD` — a clip turns a mesh over (§6); `CHECK_STRESS_OFF_CHAIN` — a sleeve weighted off its chain (§6); `CHECK_LIMB_ONE_BONE` — a limb part on a second bone (§6); `CHECK_SEAM_OVER_RANGE` — a joint that opens when bent (§6); `CHECK_SEAM_OVER_MOTION` — a proven body-root seam opens over the existing floor (§6) |
|
|
4520
|
-
| `check` / `build`: extremes observations | `extremes/<
|
|
4562
|
+
| `check` / `build`: extremes observations | `extremes/<segment>/extremes.png` and `extremes.json` beside the other check outputs; `<segment>` follows [Diagnostic path segments](STABILITY.md#diagnostic-path-segments), while JSON retains the original animation; generated by core `render --extremes-only` at 12 fps on its fitted world box at scale 1; one `EXTREMES` geometry-pair frame/distance summary per animation | open the native setup/min/max/diffs and label every changed boundary tear, ghost or clean before human review (step 9) | core's named static/observation SKIPs retain JSON without a PNG; diagnostic failure is `CHECK_EXTREMES_RENDER_FAILED` SKIP and leaves the measured verdict unchanged; `--no-extremes` runs no extra render and removes stale `extremes/` |
|
|
4521
4563
|
| `check --requirements` (and `build --requirements`) | after the lines above, one line per declared requirement, `NAME: PASS`, `FAIL` or `NOT MEASURABLE — …` with its figures, the bar as declared and the worst frame; then `requirements: N declared — M measured (P PASS, F FAIL), K NOT MEASURABLE; not declared: <kinds>`; `check.json`'s `requirements` block, first its `file` record (issue #556); the renders under `requirements/` (§7, *Declared requirements*) — `build` reads `config.requirements` in place of the flag when it is not given | every line PASS and `0 NOT MEASURABLE`; a follow's `released_copy` says whether rigc's consumer-driven door was taken on the throwaway copy; a `stretch` line's `held_by` (issue #321), right after `worst`, names the bones the worst edge's two vertices hang on and their idle chains, in `CHECK_TEXTURE_STRETCH`'s words (§6) and by the same function, on a PASS as on a FAIL | `CHECK_REQUIREMENT_MET` (a figure past its bar; the line names the frame) or `CHECK_REQUIREMENT_MEASURABLE` (the quantity is undefined in the frames: a tip or an axis on a bone of length 0, an aim with no line, a follow no frame of which reaches its least drive); the last line then reads `check: FAIL — B bar(s) not met, R declared requirement(s) not PASS` |
|
|
4522
4564
|
| `compose` | the `[compose]` lines: one per character (its offset, its scale, its placed bounds, the shift and how many first-level bones, regions on `root` and weights bound to `root` it moved, its bone, slot, track and constraint counts, its `rig_scale` and idle), the declared order and the slot count it expands to, rigc's gate lines; then the `[check]` lines as for `check`, and `scene.json` | both gate summaries `0 failed`, `check: PASS` with the bars that measured and the ones that said SKIP named — on a composed rig `4 of 9`: the gate, the loop, `CHAIN_LAG` and `TEXTURE_STRETCH` (there is no `parts.json`; each character's own `build` measured all nine). `scene.json`'s `order.slots` is the order the compiled skeleton draws | a `SCENE_*` refusal (§6, *compose*) — the scene file, a build, or the order; `COMPOSE_RIGC_GREEN` — rigc's own line, quoted |
|
|
4523
4565
|
| `loop` (inside `build --loop`, or `loop --frames … --out …`) | the dropped-duplicate line, or, when the end frame is not frame 0, the jump line: its max \|d\| and px over 40, then why — under `build`, `the rig holds N physics constraint(s), and rigc's render starts every one at rest at frame 0` with the remedy `build --loop --lead-in <n>`, or `the rig holds no physics constraint, so the idle itself does not close` (`CHECK_LOOP_CLOSES`); under `loop --frames`, which reads frames alone, both causes (issue #325); under `build --lead-in`, the lead-in line in its place (the frames kept and the jump at the wrap); each file's line, then `loop: idle.png N B (lossless); idle-indexed.png N B (max …, mean …); idle.gif N B (max …, mean …)` | `f0048.png equals f0000.png byte for byte, so it is dropped` | `LOOP_ENCODE` (§6) |
|
|
@@ -5493,8 +5535,10 @@ See-through with another seed.
|
|
|
5493
5535
|
| <a id="CONFIG_CLOTH_SPLIT_BEFORE_TIP"></a>`CONFIG_CLOTH_SPLIT_BEFORE_TIP` | a `cloth` recipe's `split.at` is at or past its `links`: the trunk would leave no link for the branches (issue #364) | `split.at` below `links`, or leave `split` out |
|
|
5494
5536
|
| <a id="CONFIG_CLOTH_RESPONSE_GROWS_TO_TIP"></a>`CONFIG_CLOTH_RESPONSE_GROWS_TO_TIP` | a `cloth` recipe's `wind` or `gravity` is `[root, tip]` with tip below root: the response grows from the root to the tip, where the motion accumulates down the chain | that pair |
|
|
5495
5537
|
| <a id="CONFIG_CLOTH_ALTERNATE_DIFFERS"></a>`CONFIG_CLOTH_ALTERNATE_DIFFERS` | a `cloth` recipe's `alternate_damping` without `damping`, or equal to it: neighbouring trees are declared out of phase, and an alternate that alternates nothing declares nothing | `damping` beside it, a different value, or leave `alternate_damping` out |
|
|
5538
|
+
| <a id="CONFIG_CLOTH_SLEEVE_PART"></a>`CONFIG_CLOTH_SLEEVE_PART` | a sleeve recipe lacks a singular `part` declaration or carries `parts` | declare one matching carrier by name in `part` |
|
|
5539
|
+
| <a id="CONFIG_CLOTH_EXTENT"></a>`CONFIG_CLOTH_EXTENT` | the declared extent is outside (0, 1], or belongs to a hair or multi-part recipe | declare a finite fraction for a single bottomwear or sleeve carrier |
|
|
5496
5540
|
| <a id="CONFIG_CLOTH_SWING_SCALE_PER_TREE"></a>`CONFIG_CLOTH_SWING_SCALE_PER_TREE` | `swing` on a tag other than `bottomwear`, or `swing.scales` not one scale per tree (`chains`) | one scale per tree, in tree order across the skirt |
|
|
5497
|
-
| <a id="CONFIG_CLOTH_PART_ON_BOTTOMWEAR"></a>`CONFIG_CLOTH_PART_ON_BOTTOMWEAR` | `part` as a string on a `cloth` recipe for a
|
|
5541
|
+
| <a id="CONFIG_CLOTH_PART_ON_BOTTOMWEAR"></a>`CONFIG_CLOTH_PART_ON_BOTTOMWEAR` | `part` as a string on a `cloth` recipe for a hair target (issue #402; hair may use a list in `parts` or `part`, issue #437) | leave it out there, or pass a list of parts in root-to-tip order (`parts: [...]`); a single string `part` hands the skirt's recipe to a `topwear` part that holds a skirt (a dress) |
|
|
5498
5542
|
| <a id="CONFIG_CLOTH_PARTS_UNIQUE"></a>`CONFIG_CLOTH_PARTS_UNIQUE` | a `cloth` recipe sets both `part` and `parts`, or its part list names the same part more than once (issue #437) | set at most one of `part` or `parts`, and list each part once in root-to-tip order |
|
|
5499
5543
|
| <a id="CONFIG_CLOTH_SPRING_STABLE"></a>`CONFIG_CLOTH_SPRING_STABLE` | a `cloth` recipe's strength — declared, or the default 100 / 100 / 50 — whose spring is unstable at a damping the recipe runs at (`damping`, `alternate_damping`, or rig-c's 0.85 when `damping` is left out): k = strength·massInverse·step² at or past 2(1 + damping^(60·step)), step 1/60 and mass 1 (rig-c's defaults; the recipe sets neither). The detail gives k and the bound | a lower strength, or a higher damping |
|
|
5500
5544
|
| <a id="CONFIG_TURN_BONE_FREE"></a>`CONFIG_TURN_BONE_FREE` | the config has `turn` and `bones` declares a bone named `turn`, the control the rig stage adds | rename that bone |
|
|
@@ -5798,7 +5842,17 @@ recorded transform. The record fields and sampling formula are specified in
|
|
|
5798
5842
|
| <a id="ASSEMBLE_TAKE_UNIQUE"></a>`ASSEMBLE_TAKE_UNIQUE` | repeated donor for one target tag at runtime | declare each target run/tag once |
|
|
5799
5843
|
| <a id="CONFIG_TAKE_UNIQUE"></a>`CONFIG_TAKE_UNIQUE` | config selects the same target run/tag more than once | retain one donor per target tag |
|
|
5800
5844
|
| <a id="ASSEMBLE_PART_SOURCE"></a>`ASSEMBLE_PART_SOURCE` | `assemble.editor_receipts.trace_parts` is `true` and a part's pixels are decided by a shape drawn in the config — an `assemble.cuts` (or an alternate set's `cuts`) `polygon`, `seethrough.arm_split`, a limb's `split.line`, an `assemble.patches` `box`, an `assemble.extend_painting` `band`; the object names the part and where the shape is declared, the detail the shape found (issue #947) | `config.json`: remove that entry and paint the piece as an author layer (`author:<label>`) in an image editor with its receipt in `assemble.editor_receipts.receipts`, or take the part whole from a layer of the split (a limb split may use `"edge": "painting"`) |
|
|
5801
|
-
| <a id="EDITED_PART_ARGUMENT"></a>`EDITED_PART_ARGUMENT` | A writer argument is missing or blank. | Supply
|
|
5845
|
+
| <a id="EDITED_PART_ARGUMENT"></a>`EDITED_PART_ARGUMENT` | A writer argument is missing or blank, or both author flags are present. | Supply config, part, file and from, plus exactly one of producer or editor. Omit rig-config or name a non-empty path. |
|
|
5846
|
+
| <a id="EXTERNAL_RECEIPT_ARGUMENT"></a>`EXTERNAL_RECEIPT_ARGUMENT` | Write or verify arguments are absent, malformed or incompatible, or kind is outside the accepted set. | Give one complete write or verify invocation. The accepted kind is mask. |
|
|
5847
|
+
| <a id="EXTERNAL_RECEIPT_SCHEMA"></a>`EXTERNAL_RECEIPT_SCHEMA` | The receipt is unreadable or has invalid JSON, version, keys or field values. | Supply a rig-parts-external-receipt/1 receipt. |
|
|
5848
|
+
| <a id="RECEIPT_PRODUCER"></a>`RECEIPT_PRODUCER` | Producer JSON or its fields are invalid. | Give a nonblank tool, optional nonblank model and exactly one declared lowercase SHA-256 digest. |
|
|
5849
|
+
| <a id="EXTERNAL_RECEIPT_INPUT"></a>`EXTERNAL_RECEIPT_INPUT` | The painting or mask cannot be read. | Supply the named readable PNG. |
|
|
5850
|
+
| <a id="EXTERNAL_RECEIPT_FILE_HASH"></a>`EXTERNAL_RECEIPT_FILE_HASH` | The mask bytes differ from the recorded SHA-256. | Restore the recorded mask bytes. |
|
|
5851
|
+
| <a id="EXTERNAL_RECEIPT_PAINTING_HASH"></a>`EXTERNAL_RECEIPT_PAINTING_HASH` | The painting bytes differ from the recorded SHA-256. | Restore the recorded painting bytes. |
|
|
5852
|
+
| <a id="EXTERNAL_RECEIPT_PNG"></a>`EXTERNAL_RECEIPT_PNG` | An input does not decode as PNG. | Supply a decodable PNG. |
|
|
5853
|
+
| <a id="EXTERNAL_RECEIPT_GRID"></a>`EXTERNAL_RECEIPT_GRID` | The mask or recorded grid differs from the painting dimensions. | Supply the mask on the painting grid and record the measured dimensions. |
|
|
5854
|
+
| <a id="EXTERNAL_RECEIPT_MASK_VALUES"></a>`EXTERNAL_RECEIPT_MASK_VALUES` | The mask contains a pixel outside opaque black and opaque white. | Supply a binary mask with opaque pixels. |
|
|
5855
|
+
| <a id="EXTERNAL_RECEIPT_OUTPUT"></a>`EXTERNAL_RECEIPT_OUTPUT` | The receipt destination cannot be published. | Use an unused path in a writable directory. |
|
|
5802
5856
|
| <a id="EDITED_PART_BLOCK"></a>`EDITED_PART_BLOCK` | A named config has no assemble.edited_parts. | Declare its directory and receipts array before recording. |
|
|
5803
5857
|
| <a id="EDITED_PART_FILE"></a>`EDITED_PART_FILE` | The file or from path is unreadable. | Supply readable PNG files at both explicit paths. |
|
|
5804
5858
|
| <a id="EDITED_PART_PNG"></a>`EDITED_PART_PNG` | The file or from bytes are not a decodable PNG. | Supply PNGs supported by the existing codec. |
|
|
@@ -5852,6 +5906,9 @@ recorded transform. The record fields and sampling formula are specified in
|
|
|
5852
5906
|
| <a id="DIFF_COMPONENTS_INPUT"></a>`DIFF_COMPONENTS_INPUT` | `diff-components` needs readable PNG stack/painting/part images, a writable `--out` target when writing, explicit parts, positive integer floor, a finite threshold in [0,255], matching native dimensions and valid coverage/domain inputs; flags must be unique and known, with nonempty values | Supply the named missing or invalid input; no resampling or inferred figure is performed |
|
|
5853
5907
|
| <a id="DIFF_COMPONENTS_BINDING"></a>`DIFF_COMPONENTS_BINDING` | The shipped report reader found a stack or painting SHA-256 different from the supplied bytes; found and required digests are printed | Regenerate against the bytes being reviewed |
|
|
5854
5908
|
| <a id="DIFF_COMPONENTS_REPORT"></a>`DIFF_COMPONENTS_REPORT` | Invalid report JSON/spec (`rig-parts-diff-components/1` or `rig-parts-diff-components/2` is required, or the spec requested by a narrow reader), or its exhaustive inventory, definition, paths, domain, coverage or topmost `owners` (on `/2`) differs from remeasurement; capped inventories are refused | Regenerate the complete versioned report against the same input paths, bytes, parts and figure domain |
|
|
5909
|
+
| <a id="DIFF_DRAFTS_INPUT"></a>`DIFF_DRAFTS_INPUT` | `diff-drafts` requires unique `--left`, `--right` and `--out` flags with non-empty paths; each input directory must hold either the standalone `assemble` layout (`rig/parts.json`, `rig/parts/<name>.png`, `render/recomposite_rig.png`) or the `build` layout (`parts.json`, `parts/<name>.png`, `recomposite_rig.png`), with readable PNG bytes whose dimensions match `parts.json` | Supply two readable assemble or build output directories |
|
|
5910
|
+
| <a id="DIFF_DRAFTS_CANVAS"></a>`DIFF_DRAFTS_CANVAS` | `--left` and `--right` declare different `rig_size` canvas dimensions in `parts.json`, so the two outputs are not drafts of one rig | Compare two drafts assembled at the same `rig_size` canvas |
|
|
5911
|
+
| <a id="DIFF_DRAFTS_OUT"></a>`DIFF_DRAFTS_OUT` | `--out` already exists, lies inside `--left` or `--right`, or cannot be written | Name a fresh writable output file path outside both input directories |
|
|
5855
5912
|
| <a id="ASSEMBLE_PINHOLES"></a>`ASSEMBLE_PINHOLES` | the requirements file declares `pinholes.required: true` and the flat parts stack holds a pinhole: an 8-connected opening (alpha 0 on every part, enclosed by the parts' alpha above 0) whose every pixel the painting shows as figure. One refusal per pinhole, largest first, naming its box, its px and the parts bordering it; nothing is written (issue #944, [Pinholes at rest](#pinholes-at-rest-issue-944)) | `assemble.plan` / `assemble.take` / the head pass: take the pinhole's pixels from a layer that holds them ([Source before scissors](#source-before-scissors)); where no layer holds them, the defect is the input's. Without the declaration the bar reports SKIP |
|
|
5856
5913
|
| <a id="ASSEMBLE_PATCH_BOX_INSIDE"></a>`ASSEMBLE_PATCH_BOX_INSIDE` | a patch's box reaches past the rig (the painting times `rig_scale`; the detail gives the size) | that patch's `box` — it is in rig pixels, not painting pixels |
|
|
5857
5914
|
| <a id="ASSEMBLE_PATCH_OPAQUE"></a>`ASSEMBLE_PATCH_OPAQUE` | a patch takes no pixel: a `"silhouette"` patch whose box holds none of the figure | move the box onto the figure, or `"alpha": "box"` |
|
|
@@ -5893,6 +5950,7 @@ recorded transform. The record fields and sampling formula are specified in
|
|
|
5893
5950
|
| <a id="PROPOSE_CUT_FROM_RECORDED"></a>`PROPOSE_CUT_FROM_RECORDED` | two parts share one layer and none of them records `cut_from`: a `parts.json` an `assemble` before 1.6.0 wrote with `assemble.cuts`. The records are in draw order, so which is the plan part and which the piece cannot be read off the file; the message names the parts and the layer. Every other reader still takes the file | `--parts`: re-run assemble (1.6.0+) to record `cut_from` |
|
|
5894
5951
|
| <a id="PROPOSE_LIMB_PARTS"></a>`PROPOSE_LIMB_PARTS` | `parts.json` holds a standalone or incomplete limb part `config.limbs` cut at its joints (issues #349, #440) that cannot be reassembled into the source part `of` (a missing segment or `cap` record, or `of` still present beside the limb parts); a complete `assemble` output with `config.limbs` reconstructs its pre-limb parts in the same run | `--parts` a complete `assemble` output (every segment of each limb, with its `cap` record) or a build assembled with `config.limbs` left out; `propose --from-config` reads the config's bones on either build |
|
|
5895
5952
|
| <a id="PROPOSE_FIGURE_LAYER"></a>`PROPOSE_FIGURE_LAYER` | with `--keypoints` (issue #577): a limb is drafted from the figure layer (no handwear or legwear part over 500 px for it), and two or more `topwear` parts each hold every joint and the trunk bones' origins within 15 px with the same opaque px in the 31x31 squares about them, so nothing says which is the figure; or the only `topwear` parts that hold them are named by a cloth recipe (`config.cloth.<tag>.part` or `.parts`, issue #631), whose mesh a limb would take (§3, *A figure of one material*) | leave the others out of `assemble.plan`, or give the arms and legs their own handwear and legwear layers; for a recipe's part, take it out of the recipe |
|
|
5953
|
+
| <a id="PROPOSE_CLOTH_EXTENT"></a>`PROPOSE_CLOTH_EXTENT` | the carrier has no resolved span, a shortened link has no downward span after whole-pixel row rounding, or the fixed mesh transition reaches the end of a tree's first link | choose a carrier with art below its root, increase the extent, declare fewer links for a collapsed span, or use a smaller mesh cell for the transition |
|
|
5896
5954
|
| <a id="PROPOSE_CLOTH_DRAFTED"></a>`PROPOSE_CLOTH_DRAFTED` | with `--cloth` (issue #364): the config's `cloth` block holds a recipe for a tag the proposer drafts no chain on — no part has that tag, or every `back hair` part ends above the shoulders (a bun bone, no chain). A `bottomwear` recipe with no `bottomwear` part names every `topwear` part shaped like a skirt (issue #402) | leave that recipe out, or assemble the layer it is for, or declare the named part in `cloth.bottomwear.part` |
|
|
5897
5955
|
| <a id="PROPOSE_CLOTH_PART"></a>`PROPOSE_CLOTH_PART` | with `--cloth` (issues #402, #437): `cloth.bottomwear.part` (a string) names no part, a part or cut piece whose source is not `topwear` (a `bottomwear` part takes the recipe by its tag already), or a target whose box ends above the hip + 0.25 face heights, the topwear rule's waist line; or `cloth.<tag>.parts` (or `part` as a list, issue #437) names a part not in `parts.json`, a part no link of the drafted tree crosses (`spanCrosses == 0`), or parts out of root-to-tip depth order along the chain | name the `topwear` part or its cut skirt piece that holds the skirt (or leave `part` out), or list only parts in `parts.json` that the drafted tree links cross in root-to-tip order |
|
|
5898
5956
|
| <a id="PROPOSE_WRITE_CONFIG_FRESH"></a>`PROPOSE_WRITE_CONFIG_FRESH` | with `--cloth … --write-config` (issues #537, #356): the out path exists or collides with one of the four artifacts under `--out` — `proposal.json`, `basis.json`, `render/landmarks.png`, `render/landmarks_head.png` — including directory-symlink and hardlink aliases; the config is written to a new file, never over the `--cloth` config or an earlier one (unlike `assemble --propose-plan` and `propose` without `--cloth`, which update an existing `--config` in place; §4, *Saving proposed config fields*) | name a file that does not exist yet, beside the `--cloth` config and separate from all four artifact paths and their aliases |
|
|
@@ -5907,7 +5965,7 @@ recorded transform. The record fields and sampling formula are specified in
|
|
|
5907
5965
|
| <a id="KEYPOINTS_JOINT_KNOWN"></a><a id="KEYPOINTS_JOINT_STATE"></a><a id="KEYPOINTS_POSITION_STATED"></a><a id="KEYPOINTS_POSITION_INSIDE"></a>`KEYPOINTS_JOINT_KNOWN`, `KEYPOINTS_JOINT_STATE`, `KEYPOINTS_POSITION_STATED`, `KEYPOINTS_POSITION_INSIDE` | a joint name outside body-18, a state outside observed / occluded / missing, an observed joint with no `at` or a missing one with one, or a position outside the `width`x`height` image | that joint |
|
|
5908
5966
|
| <a id="KEYPOINTS_PERSON_UNIQUE"></a><a id="KEYPOINTS_PERSON_CHOSEN"></a>`KEYPOINTS_PERSON_UNIQUE`, `KEYPOINTS_PERSON_CHOSEN` | two people share an id; or the file holds more than one person and no `--person` names one, or `--person` names none of them (the message lists the ids) | `--person <id>` |
|
|
5909
5967
|
| <a id="KEYPOINTS_IMAGE_SIZE"></a>`KEYPOINTS_IMAGE_SIZE` | the file's `width`x`height` is not the `--source` painting's | a file measured on this painting |
|
|
5910
|
-
| <a id="PARTS_PAINTING_PRESENT"></a>`PARTS_PAINTING_PRESENT` | The declared rig-resolution painting cannot be read. | Re-run assemble
|
|
5968
|
+
| <a id="PARTS_PAINTING_PRESENT"></a>`PARTS_PAINTING_PRESENT` | The declared rig-resolution painting (`painting_in_rig.png`, beside `parts.json`) cannot be read. `check --parts <build>` reads the complete assemble output folder beside `parts.json`, not `parts.json` copied alone. | Re-run assemble, or copy/keep the complete assemble folder (`parts.json`, `parts/*.png`, `painting_in_rig.png`, and any sidecars assemble wrote) together in `<build>`. |
|
|
5911
5969
|
| <a id="PARTS_PAINTING_SHA256"></a>`PARTS_PAINTING_SHA256` | The declared rig-resolution painting does not match its SHA-256. | Re-run assemble; restore the declared file and manifest together. |
|
|
5912
5970
|
| <a id="PARTS_PAINTING_PNG"></a>`PARTS_PAINTING_PNG` | The declared rig-resolution painting is not a decodable PNG. | Re-run assemble; restore the declared file and manifest together. |
|
|
5913
5971
|
| <a id="PARTS_PAINTING_SIZE"></a>`PARTS_PAINTING_SIZE` | The declared rig-resolution painting dimensions differ from rig_size. | Re-run assemble; restore the declared file and manifest together. |
|
|
@@ -6024,6 +6082,9 @@ exits 0, and `mesh_draft.json` and the console name the reading and the amount.
|
|
|
6024
6082
|
| <a id="REMESH_DELTA_JSON"></a>`REMESH_DELTA_JSON` | `--delta` is missing, does not parse, is not one object, its `schema` is not `rig-review-mesh-edit/1`, or `slot`, `skin`, `attachment` or `source` is not of its shape | export the mesh edit from rig-c/review as it writes it |
|
|
6025
6083
|
| <a id="REMESH_DELTA_BASIS"></a>`REMESH_DELTA_BASIS` | the mesh edit's `basis` is not `"setup"`: it was drawn over a pose, and the producer binds setup positions, so it is refused rather than posed back (the basis found is quoted) | edit the mesh in setup space (rig-c/review #100) and export again |
|
|
6026
6084
|
| <a id="REMESH_DELTA_OPS"></a>`REMESH_DELTA_OPS` | `ops` is not an array, or holds more than 300 ops — review's own cap per attachment | split the edit: apply the first part, then edit the revision |
|
|
6085
|
+
| <a id="REMESH_DELTA_ACT"></a>`REMESH_DELTA_ACT` | the act identity is malformed, a known key has a conflicting source hash or payload digest, its recorded edit is invalid, or its record fails to bind the current rig files | use the finalized act's identity and original binding together with the rig revision its record binds |
|
|
6086
|
+
| <a id="REMESH_DELTA_ACT_SUPERSEDED"></a>`REMESH_DELTA_ACT_SUPERSEDED` | the same act and edit were applied on an earlier, hash-bound revision. The refusal's object is the path to the record that binds the current revision | keep the current revision |
|
|
6087
|
+
| <a id="REMESH_DELTA_DIGEST"></a>`REMESH_DELTA_DIGEST` | the API refused the mesh edit's `payloadSha256` | pass the digest paired with the unchanged `edit` in the finalized act |
|
|
6027
6088
|
| <a id="REMESH_DELTA_SOURCE"></a>`REMESH_DELTA_SOURCE` | the mesh edit was not drawn over this part's mesh: its `slot` or `attachment` is not `--part`, its skin is not `default`, a `source` count (`vertexCount`, `triangleCount`, `hullLength`) or `source.hash` is not the input's (both figures quoted; the hash is SHA-256 of the part's entry in rigc's `skeleton.model.json` over the input); or the input's bindings are not where its uvs and `parts.json` place the image, so no position can be bound | export the edit from the revision you pass as `--rig` |
|
|
6028
6089
|
| <a id="REMESH_DELTA_OP"></a>`REMESH_DELTA_OP` | one op, named `ops[i]` and quoted, does not apply at its place in the replay: an unknown kind, a non-finite number, an id out of range or already removed, a `from` that is not the live position within 0.001 px, a position outside the part's image, a split of an edge the producer's triangulation does not hold or outside its triangles, a free `add` outside every triangle, a move that folds its ring, a removal that leaves fewer than 3 vertices, ends a constraint or leaves a ring no ear clips, an `edge` that duplicates a constraint, is a hull edge, runs through a vertex or crosses the hull or a constraint, or an `unedge` of any edge this edit did not constrain | read the op the line names; an edge the producer flipped is not one review can unedge — redraw it with `edge`, or move the vertices |
|
|
6029
6090
|
| <a id="REMESH_DELTA_TOPOLOGY"></a>`REMESH_DELTA_TOPOLOGY` | the replayed mesh breaks an outline rule (`contourTopologyProblems`' code quoted: one loop, the hull first, every triangle wound one way, no self-intersection, no coincident vertices), or holds more interior edges that are not locally Delaunay than the input did; or the input's own triangles are not wound one way | read the quoted code; the ops that made it are the edit's last ones |
|
|
@@ -6082,7 +6143,43 @@ check measured from other bytes. The revision is always measured. `retune` reads
|
|
|
6082
6143
|
record, so either command's serves the other over the same input. Without either flag
|
|
6083
6144
|
nothing printed or written changes.
|
|
6084
6145
|
|
|
6085
|
-
|
|
6146
|
+
#### Apply a mesh edit act in Bun
|
|
6147
|
+
|
|
6148
|
+
Pass one edit from a finalized `rig-review/act@8` Request changes act to the typed,
|
|
6149
|
+
in-process API (issue #1159). Use the same rig, config and parts paths as for the
|
|
6150
|
+
CLI and choose a fresh revision directory for `out`.
|
|
6151
|
+
|
|
6152
|
+
```ts
|
|
6153
|
+
import { applyMeshEditAct } from '@rig-c/parts/src/remesh-api.ts';
|
|
6154
|
+
|
|
6155
|
+
const revision = applyMeshEditAct({
|
|
6156
|
+
rig, config, parts, part, out,
|
|
6157
|
+
edit: entry.edit,
|
|
6158
|
+
actId: act.actId,
|
|
6159
|
+
actSourceHash: act.source.sourceHash,
|
|
6160
|
+
payloadSha256: entry.sha256,
|
|
6161
|
+
});
|
|
6162
|
+
```
|
|
6163
|
+
|
|
6164
|
+
Here `entry` is the selected item in `act.value.meshEdits`. The caller supplies
|
|
6165
|
+
these values in memory. Before applying any op, Parts recomputes the canonical
|
|
6166
|
+
payload SHA-256 using recursively sorted object keys and checks `source.hash`
|
|
6167
|
+
against the target attachment in its gated model. It checks `source.frame` against
|
|
6168
|
+
the rig size and compares every recorded `source.positions` vertex, in attachment
|
|
6169
|
+
order, with its own position in setup crop pixels. A frame mismatch or a position
|
|
6170
|
+
more than 0.001 px away refuses the edit, including edits with only `add` or
|
|
6171
|
+
`edge` ops. See the [signed mesh-edit contract](https://github.com/rig-c/review/issues/952#issuecomment-7001413869).
|
|
6172
|
+
|
|
6173
|
+
New revisions record the act identity and payload digest in `remesh.json`.
|
|
6174
|
+
Passing the same edit again with the current revision as `rig` returns that
|
|
6175
|
+
revision without writing another when that revision's record binds the rig
|
|
6176
|
+
files and matches the act source hash and payload digest. If the rig has moved
|
|
6177
|
+
past the matching edit, `REMESH_DELTA_ACT_SUPERSEDED` names the record that
|
|
6178
|
+
binds the current revision. A conflicting binding, including one on an earlier
|
|
6179
|
+
revision, or an unbound record still refuses `REMESH_DELTA_ACT`. A new edit
|
|
6180
|
+
bound to a stale source is refused before any output write.
|
|
6181
|
+
|
|
6182
|
+
**Legacy `--delta <mesh-edit.json>`** (in place of `--mesh`, exactly one of the two; issue
|
|
6086
6183
|
#526) reads rig-c/review's mesh edit, `rig-review-mesh-edit/1`: `slot`, `skin`,
|
|
6087
6184
|
`attachment`, `source` (`vertexCount`, `triangleCount`, `hullLength`, `hash`), `units`,
|
|
6088
6185
|
`basis` and up to 300 `ops`, each one of `move {v, from, to}`, `add {at, onEdge?}`,
|
|
@@ -6223,7 +6320,7 @@ outside the consumed inputs pending [#1177](https://github.com/rig-c/parts/issue
|
|
|
6223
6320
|
|
|
6224
6321
|
| rule | means | change |
|
|
6225
6322
|
| --- | --- | --- |
|
|
6226
|
-
| <a id="CHECK_RIGC_PRESENT"></a>`CHECK_RIGC_PRESENT` | no `rigc` binary found
|
|
6323
|
+
| <a id="CHECK_RIGC_PRESENT"></a>`CHECK_RIGC_PRESENT` | no `rigc` binary found in ancestor `node_modules/.bin` directories or on `PATH`. This also applies when the in-process remesh API needs to build a new revision | `bun install` |
|
|
6227
6324
|
| <a id="CHECK_RIGC_PACKAGE"></a>`CHECK_RIGC_PACKAGE` | `node_modules/.bin/rigc` is missing under the package root named: this lookup (the selftest's, issue #337) takes this package's own rigc and no other — no directory above, no `PATH` | `bun install` in that root |
|
|
6228
6325
|
| <a id="CHECK_INPUT_PRESENT"></a><a id="CHECK_INPUT_IS_JSON"></a><a id="CHECK_PART_PNG_PRESENT"></a><a id="CHECK_PART_PNG_MATCHES_BOX"></a><a id="CHECK_PART_SLOT_PRESENT"></a><a id="CHECK_RIG_STAGE_PRESENT"></a><a id="CHECK_RIG_STAGE_IS_THE_CANVAS"></a><a id="CHECK_RIG_ROOT_BONE"></a><a id="CHECK_IDLE_PRESENT"></a>`CHECK_INPUT_PRESENT`, `CHECK_INPUT_IS_JSON`, `CHECK_PART_PNG_PRESENT`, `CHECK_PART_PNG_MATCHES_BOX`, `CHECK_PART_SLOT_PRESENT`, `CHECK_RIG_STAGE_PRESENT`, `CHECK_RIG_STAGE_IS_THE_CANVAS`, `CHECK_RIG_ROOT_BONE`, `CHECK_IDLE_PRESENT` | the rig directory is incomplete or disagrees with `parts.json` (`CHECK_PART_SLOT_PRESENT`: a part with no slot of its own name, which the judgement lines render it by; `CHECK_INPUT_PRESENT` on `--set` / `--all-sets`: no `parts.json`, no `alternates`, or the named set is not in `alternates`). `motion.json` is required even with no animation in it, because `rigc build` takes `--motion` (a spec with `"animations": {}` builds green); `CHECK_IDLE_PRESENT` is an `idle` that is there with no positive `duration` — an absent `idle` is measured around (§7). `CHECK_INPUT_PRESENT` on `…/parts.json`: `--parts` named a directory without `parts.json` — most often `parts/` itself — or, without `--parts`, the rig directory has none while the directory above it does (build's layout, `<out>/rig` under `<out>/parts.json`). The detail says it: "--parts names the directory holding parts.json and parts/, not parts/ itself (after build, that is build's --out, whose rig is <out>/rig); without --parts it is --rig", and names the parent when the parent holds `parts.json`. With neither (no `--parts`, and no `parts.json` beside `rig.json` or above it), the rig is measured without parts and nothing is refused (§7) | re-run rig (`build` does both); for `…/parts.json`, `--parts` — the directory above `parts/` |
|
|
6229
6326
|
| <a id="CHECK_SOURCE_SIZE"></a>`CHECK_SOURCE_SIZE` | the painting `--source` names is not this rig's: no single `rig_scale` takes its width and height to the stage's (assemble makes the canvas `trunc(w × rig_scale)` x `trunc(h × rig_scale)`), or, with `parts.json` read, its `scale_rig_per_source` does not; or the stage is not whole pixels. Refused before anything is built | the painting the rig was made from — the stage's own size, or the painting `assemble` was given |
|
|
@@ -6265,6 +6362,7 @@ outside the consumed inputs pending [#1177](https://github.com/rig-c/parts/issue
|
|
|
6265
6362
|
| <a id="CLOTH_SETTLES"></a>`CLOTH_SETTLES` | **a warning, never a refusal** (issue #501; the owner's ruling: cloth at rest while the character stands may be intended). Every physics chain, read by its tip on the idle `check` renders — `rigc render --animation idle --fps 12 --geometry`, physics on, rigc's default environment. A chain is a **physics leaf** — a bone a physics constraint names (`rig.json`'s `constraints` or `motion.json`'s `physics`) with no such bone under it — and the run of physics bones above it; its tip is the leaf's end (origin plus `length` along its world x axis), or its origin when the leaf has no length; its speed between frames is the tip's distance over their time, from the idle's `geometry.json`. A chain **settles** at the first frame from which every speed to the idle's last frame is under the floor, and each one that does — before the loop's length is out — prints `WARN chain "<root>" .. "<tip>" (N physics link(s)) settles at <t> s of the <d> s idle — its tip's end under 0.01694 rig px/s from there to the last frame (fastest on the idle <v> rig px/s)`. **The floor**, 0.01694 rig px/s, is derived, not chosen: half the slowest tip an idle key drives on the public examples (the repository's floor rule, half the weaker figure) — measured with this port's build of each (rig-c 2.60.0), over the 31 chains a keyed bone at or above the leaf drives (`demo` 12, `reference-sample` 1, `scarf` 11, `wind` 7) the slowest frame-to-frame tip speed is `scarf`'s `skirt_l2`, 0.03388 rig px/s; the ten no key drives — `wind`'s skirt, eight trees and the swing, hung from a `hip` its idle never keys, and `reference-sample`'s `hip_jiggle` — fall under it from 1.5 to 2.75 s on a 3.333 s idle (`hip_jiggle` at 0 s: it never moves) and end at 0.0025 rig px/s or less. `check.json`'s `CLOTH_SETTLES` holds `status` (`WARN`, `CLEAR`), `fps`, `frames`, `duration`, `floor_rig_px_per_s`, `floor`, `levers`, `warnings` and one row per chain (`tip`, `root`, `links`, `point` — `end` or `origin` — `settles_at`, null when it does not, `max_rig_px_per_s`, `min_rig_px_per_s`); it moves no exit status, no `check: PASS` and no bar count — the summary's warning clause names it, `; N warning(s) (CLOTH_SETTLES, not a bar)` (with `SEAM_OVER_MOTION` before it, and N their sum, where that read a pair). It reads the idle alone, one loop from rigc's physics reset at frame 0: a chain that settles later than the idle is long is not seen. **SKIP**, named: no physics constraint (then `check.json` has no key), or no idle — nothing measured, never a pass | if the chain should move while the character stands, one of the consumer's two levers: an environment at render (`rigc render --environment`, wind and gravity in time — rig-c's AUTHORING §8.4), or a consumer's animation that moves the bone the chain hangs from. The drafted idle keys no hip, by measurement: a hip turn at the idle's period fails a bar on all five public examples (issue #502, §3 *What moves them*). A `cloth` recipe's skirt hangs from `hip`, which the drafted idle never keys (§3, *Recipe: cloth and hair that answer the world*, *What moves them*, which has a worked schedule for `wind`). If it is intended, nothing |
|
|
6266
6363
|
| <a id="figure_openings"></a>`figure_openings` | **a warning, never a refusal** (issue #933; see [Openings inside the figure on undeclared layer pairs](#openings-inside-the-figure-on-undeclared-layer-pairs-issue-933)). Reads transparent openings inside the pair's own posed hole-filled union (`alpha == 0` inside `fillHoles(a ∪ b)`, excluding cells already transparent at setup) across every undeclared setup-overlapping (`alpha >= 128`) layer pair in `rig.json` draw order in every animation `motion.json` holds at 12 fps (`scale = 1 / cell`). Prints `figure_openings: CLEAR — N undeclared setup-overlapping pair(s) in M animation(s) (<names>) at 12 fps (cell <cell> world units): 0 warning(s), never a bar` when clean, `figure_openings: WARN — …` followed by one `WARN opening "<a>\|<b>" above "<above>" (under "<under>") on K frame(s) [<frames>], worst frame <f> (t = <t>s) in "<animation>": found <found_cells> cell(s), <= <allowed_cells> cell(s) allowed in <w>x<h> world units at <cell> world units/cell — transparent opening inside the figure over motion on an undeclared layer pair (not a bar)` line per opening above the one-cell floor (`found_cells > allowed_cells`), or `figure_openings: SKIP — <reason>` when there is no `parts.json`, no animation, or no undeclared setup-overlapping pair. `check.json`'s `figure_openings` is written whenever the reader ran (`status` `"CLEAR"` or `"WARN"`), holding `status`, `fps`, `cell`, `pairs`, `animations`, `warnings` and `openings` (`pair`, `under`, `above`, `animation`, `frame`, `time`, `opens`, `cell`, `found_cells`, `allowed_cells`, `box`); it moves no exit status, no `check: PASS` and no bar count | if the opening is an unintended tear where a lower layer lacks opaque art under an opaque upper layer, use `assemble.extend_painting` (not `assemble.keep_under_occluders`, which only preserves existing `alpha >= 250` lower pixels under a translucent cover), or adjust mesh weights / motion keys; if it is a deliberate silhouette loop shifting in world space, nothing |
|
|
6267
6364
|
| <a id="CHECK_FOLDS_READ"></a>`CHECK_FOLDS_READ` | the fold render's `frames.json` names no set for an animation, a `folds.json` is missing, not `rigc-folds/1`, another animation's or another rate's, or a folding mesh has no line rigc printed for it | a rigc problem; report it, with `rigc --version` |
|
|
6365
|
+
| <a id="DIAGNOSTIC_PATH_SEGMENT"></a>`DIAGNOSTIC_PATH_SEGMENT` | an original diagnostic name is empty, its [mapped segment](STABILITY.md#diagnostic-path-segments) including the fixed filename/rate suffix exceeds 255 characters, or sibling mapped folders alias under ASCII case folding; collision preflight names both originals, both folders and the shared case-folded folder before any scope writes | supply nonempty names whose encoded segments fit and whose sibling folders remain distinct under ASCII case folding; uppercase ASCII stays literal, and public names are never silently changed |
|
|
6268
6366
|
| <a id="CHECK_SEAM_FRAME_SIZE"></a><a id="FRAMES_SIDECAR"></a><a id="CHECK_GEOMETRY_FILE"></a>`CHECK_SEAM_FRAME_SIZE`, `FRAMES_SIDECAR`, `CHECK_GEOMETRY_FILE` | rigc's render is not what its `frames.json` says, or its `geometry.json` is not a whole `rigc-geometry/1` export of the frames beside it (a frame count, a mesh whose vertex count differs from its rest entry; for the face half, another viewport than `frames.json`'s, other frame indices, the head bone or a feature's bone missing from a frame, a non-finite transform or time) | a rigc problem; report it |
|
|
6269
6367
|
| <a id="CHECK_SEAM_DOMAIN"></a>`CHECK_SEAM_DOMAIN` | the source-relative common union U cannot prove finite, bounded, exactly representable scale1 coverage of every actual drawn setup state, or official pinned.outside is not empty; U is the enlarged render and A remains the fixed authored denominator | retain the named evidence and report the unavailable or outside-art boundary; do not shrink art, pad the measured domain or infer transparency from geometry alone |
|
|
6270
6368
|
| <a id="CHECK_SEAM_SUPPORT"></a>`CHECK_SEAM_SUPPORT` | the affected-set effect mask does not match the fixed source grid, or the declared source cells leave no mean denominator | report the named support mismatch; no alternate denominator or successful zero is substituted |
|
|
@@ -6421,8 +6519,8 @@ and stay absent).
|
|
|
6421
6519
|
| <a id="SCENE_PLATE_PROVENANCE"></a><a id="SCENE_PLATE_PRESENT"></a><a id="SCENE_PLATE_SIZE"></a>`SCENE_PLATE_PROVENANCE`, `SCENE_PLATE_PRESENT`, `SCENE_PLATE_SIZE` | the plate's `provenance` is not `observed`, `generated` or `unknown`; its image is missing or not a PNG; it is not the canvas's size (it is drawn at canvas (0, 0) and never scaled) | the plate |
|
|
6422
6520
|
| <a id="SCENE_BUILD_PRESENT"></a>`SCENE_BUILD_PRESENT` | a build directory, or a file `build` writes in it (`parts.json`, `rig/rig.json`, `rig/motion.json` with an `idle`, an image its skin names, `check/check.json`), is missing | run `build` for that character |
|
|
6423
6521
|
| <a id="SCENE_PLATE_AT"></a>`SCENE_PLATE_AT` | a named layer's `at` is missing or not two finite integers | declare the image top-left in canvas pixels, y down; negative/outside coordinates are allowed |
|
|
6424
|
-
| <a id="SCENE_PLATE_NAME_UNIQUE"></a><a id="SCENE_PLATE_NAME_FREE"></a>`SCENE_PLATE_NAME_UNIQUE`, `SCENE_PLATE_NAME_FREE` | duplicate plate name or a collision with root, legacy plate, character id, bone, slot or animation | a distinct name and its exact once-only order token |
|
|
6425
|
-
| <a id="SCENE_PLATE_BACKDROP_SIZE"></a>`SCENE_PLATE_BACKDROP_SIZE` | an opaque declared backdrop is smaller than the composed stage in either width or height; the refusal names the layer, found dimensions and both required dimensions | use alpha or a backdrop meeting both canvas dimensions, which equal the stage; positioning
|
|
6522
|
+
| <a id="SCENE_PLATE_NAME_UNIQUE"></a><a id="SCENE_PLATE_NAME_FREE"></a>`SCENE_PLATE_NAME_UNIQUE`, `SCENE_PLATE_NAME_FREE` | duplicate plate name or a collision with root, legacy plate, character id, bone, slot or animation (a plate whose name is refused here does not also draw a cascaded `SCENE_ORDER_COMPLETE`) | a distinct name and its exact once-only order token |
|
|
6523
|
+
| <a id="SCENE_PLATE_BACKDROP_SIZE"></a>`SCENE_PLATE_BACKDROP_SIZE` | an opaque declared backdrop is smaller than the composed stage in either width or height; the refusal names the layer, found dimensions and both required dimensions. `opaque_backdrop` is checked for image size only, not for whether `at: [x, y]` covers the stage | use alpha or a backdrop meeting both canvas dimensions, which equal the stage; positioning the backdrop to cover the stage is the scene author's job |
|
|
6426
6524
|
| <a id="SCENE_PLATE_ALPHA"></a>`SCENE_PLATE_ALPHA` | a named layer is opaque in every decoded texel without its own `opaque_backdrop: true` declaration | export the intended transparency or explicitly declare that layer's backdrop role; rigc A19 is still enforced |
|
|
6427
6525
|
| <a id="SCENE_BUILD_GREEN"></a>`SCENE_BUILD_GREEN` | the build's own `check/check.json` does not say `PASS` and `gate_spine_html_green`; under an accept list (`--accept`, `characters[].accept`), it failed a bar the list does not name, its gate is red, a declared requirement is not PASS, or it names no failing bar — the bars not met and the ones accepted are listed | finish that character first: compose binds finished characters. To look at the scene meanwhile, name the failing bars (§7, *Composing several characters*) |
|
|
6428
6526
|
| <a id="SCENE_ACCEPT_KNOWN"></a>`SCENE_ACCEPT_KNOWN` | an `--accept` name, or one in a character's `accept`, is not a bar `check` holds a build to: a problem code (`CHECK_LOOP_CLOSES`) where the bar's name (`loop`) belongs, a misspelling, or `gate`, which is rig-c's and never accepted | one of the names the message lists |
|
|
@@ -6495,6 +6593,7 @@ and stay absent).
|
|
|
6495
6593
|
| <a id="RIG_TURN_SURFACE_DEPTH_REQUIRED"></a>`RIG_TURN_SURFACE_DEPTH_REQUIRED` | a part with role `"surface"` in `config.turn.roles` or `config.turn.body.roles` carries no depth sheet in `parts.json` | run `assemble` with `config.depth` or provide `<part>_depth.png` in `parts.json` |
|
|
6496
6594
|
| <a id="RIG_TURN_GRID_BUDGET"></a>`RIG_TURN_GRID_BUDGET` | a `"surface"` grid exceeds 2,400 triangles on one slot or 4,000 triangles across all `"surface"` slots | lower `config.turn.grid` / `config.turn.body.grid` `[cols, rows]` within the per-slot and total budgets |
|
|
6497
6595
|
| <a id="RIG_TURN_HEAD_BONE"></a>`RIG_TURN_HEAD_BONE` | `buildRig` found no `"head"` (or body turn root) bone when emitting 2.5D turn carriers | declare `"head"` (or the body turn root bone) in `config.bones` |
|
|
6596
|
+
| <a id="RIG_TURN_BOUNDARY_DEPTH"></a>`RIG_TURN_BOUNDARY_DEPTH` | boundary names or sheets do not resolve; surfaces are not different, abutting without overlap in one group with common units; band is empty/outside/not boundary-reaching; declarations cycle; or grid support is missing | use exact existing parts, different abutting surfaces in one group with common near/zScale, a contained nonempty band reaching their boundary, acyclic declarations and the generated grid support |
|
|
6498
6597
|
| <a id="RIG_TURN_SHARED_DEPTH_SCALE"></a>`RIG_TURN_SHARED_DEPTH_SCALE` | `"surface"` parts bound to one head or body turn declare different `near` polarities or `zScale` values | use one shared `near` and `zScale` across all `"surface"` parts in the turn group |
|
|
6499
6598
|
| <a id="RIG_TURN_UNIT_DEPTH_REQUIRED"></a>`RIG_TURN_UNIT_DEPTH_REQUIRED` | a `"unit"` bone has neither a `unitDepths` entry nor a readable `"surface"` depth sheet | provide a `"surface"` depth sheet or an explicit `unitDepths.<part>` value |
|
|
6500
6599
|
| <a id="RIG_TURN_UNIT_DEPTH_SUPPORT"></a>`RIG_TURN_UNIT_DEPTH_SUPPORT` | WARN only: an implicit unit depth sample is outside the source surface pixel-index bounds or its sampled art alpha is below 255 | author an explicit calibrated `unitDepths.<part>` value when this cross-part extrapolation is unintended; existing scalar sampling and refusal behavior are retained |
|
|
@@ -7200,12 +7299,12 @@ single-character path (§4, steps 0–9) on its own, already isolated input to a
|
|
|
7200
7299
|
| `canvas` | the shared stage, canvas px, y down. The composed rig's stage is the canvas, `root` at its bottom centre, as a single character's is its own |
|
|
7201
7300
|
| `plate` | optional. `image` (relative to the scene file) is a PNG of exactly the canvas's size; `provenance` is `observed` (the painting's own pixels), `generated` or `unknown` (a residual after the people were removed is `unknown` where they stood, and the author says so); `note` is free text. `provenance` and `note` are copied into `scene.json` and **judged by nothing**. Optional `editor_receipts` uses the [editor receipt ledger](#scene-plate-editor-receipts-issue-966), with paths relative to the scene file and verified file hashes; `required: true` demands a matching plate receipt |
|
|
7202
7301
|
| `characters[].id` | the prefix: every bone, slot, attachment (skin entry), constraint (its name, and every bone and path slot it names), `stops` entry (its `chain`, `links` and `against`, issue #431), `invariants.detached` bone, track, group and easing of that character is renamed `<id>:<name>`. `root` is the one shared root. A name resolves to exactly one character, and nothing resolves across characters without its prefix |
|
|
7203
|
-
| `characters[].build` | a
|
|
7302
|
+
| `characters[].build` | a character build directory (relative to the scene file) holding `<build>/parts.json`, `<build>/rig/` and a green `<build>/check/check.json`. When built with standalone `assemble` and `rig` instead of `build`, place the complete assemble folder at `<build>/` beside `<build>/rig/` and run the canonical pre-compose check `rig-parts check --rig <build>/rig --parts <build> --source <painting.png> --requirements <requirements.json> --out <build>/check` (see *Input layout and the pre-compose check* below) |
|
|
7204
7303
|
| `characters[].offset` | `[x, y]`, a translation from the build's rig px to canvas px. Every character is built at one `assemble.rig_scale`, so its rig px are canvas px at scale 1 |
|
|
7205
|
-
| `plates` | optional list of named layers (issue #1345); may coexist with legacy `plate`. Every layer requires `name`, `image`, `provenance` and `at: [x, y]`. `image` resolves against the scene file and keeps its native dimensions and PNG bytes, with no scale or canvas containment requirement. `at` is two finite integers locating the image **top-left in canvas pixels, y down, origin top-left**; negative/outside positions are allowed. Missing, fractional and nonfinite placement is `SCENE_PLATE_AT`. Optional `note` and `editor_receipts` have the legacy plate meanings; every ledger is verified independently. `opaque_backdrop: true` exempts only that declared layer from compose's alpha requirement; otherwise at least one decoded texel must have alpha below 255 (`SCENE_PLATE_ALPHA`), even for an oversized image. An opaque declared backdrop must also have width at least `canvas.width` **and** height at least `canvas.height`, the composed rig's stage dimensions, matching core 3.8.0 A19's rig-spec size inference. A smaller opaque backdrop is refused before output by `SCENE_PLATE_BACKDROP_SIZE`; a transparent layer has no size floor. rigc's A19 remains enabled |
|
|
7206
|
-
| `plates[].name` | the layer's bone, slot and attachment name and exact `order` token. Names must be unique, nonempty and distinct from `root`, legacy `plate`, shared `idle`, every character id and every prefixed character bone/slot/animation (`SCENE_PLATE_NAME_UNIQUE`, `SCENE_PLATE_NAME_FREE`).
|
|
7304
|
+
| `plates` | optional list of named layers (issue #1345); may coexist with legacy `plate`. Every layer requires `name`, `image`, `provenance` and `at: [x, y]`. `image` resolves against the scene file and keeps its native dimensions and PNG bytes, with no scale or canvas containment requirement. `at` is two finite integers locating the image **top-left in canvas pixels, y down, origin top-left**; negative/outside positions are allowed. Missing, fractional and nonfinite placement is `SCENE_PLATE_AT`. Optional `note` and `editor_receipts` have the legacy plate meanings; every ledger is verified independently. `opaque_backdrop: true` exempts only that declared layer from compose's alpha requirement; otherwise at least one decoded texel must have alpha below 255 (`SCENE_PLATE_ALPHA`), even for an oversized image. An opaque declared backdrop must also have width at least `canvas.width` **and** height at least `canvas.height`, the composed rig's stage dimensions, matching core 3.8.0 A19's rig-spec size inference. A smaller opaque backdrop is refused before output by `SCENE_PLATE_BACKDROP_SIZE`; a transparent layer has no size floor. **Size is the only check on `opaque_backdrop`:** whether `at: [x, y]` positions the backdrop to cover the stage is the scene author's job (a canvas-sized backdrop at `[400, 0]` passes size while leaving part of the stage uncovered). rigc's A19 remains enabled |
|
|
7305
|
+
| `plates[].name` | the layer's bone, slot and attachment name and exact `order` token. Names must be unique, nonempty and distinct from `root`, legacy `plate`, shared `idle`, every character id and every prefixed character bone/slot/animation (`SCENE_PLATE_NAME_UNIQUE`, `SCENE_PLATE_NAME_FREE`; a name refused by either does not also draw a cascaded `SCENE_ORDER_COMPLETE`). Emitted image files and packed atlas regions are named by 0-based declaration index (`scene-plate.<index>.png`, atlas region `scene-plate.<index>`, Spine attachment `path: "scene-plate.<index>"`), separately from character images (`SCENE_IMAGE_NAME_FREE` on any collision) — so **reordering `plates[]` renames the `scene-plate.<index>` atlas regions** even when `plates[].name` and `order` are unchanged |
|
|
7207
7306
|
| `characters[].scale` | optional, a positive number; absent is 1, and 1 composes to the bytes a scene without the key writes. The character's size on the canvas, about its stage's top-left corner: a rig px `p` lands at canvas px `scale * p + offset` (issue #197). A character scaled up past its art is drawn soft — the art is not resampled; rebuild it at a higher `assemble.rig_scale` if that matters |
|
|
7208
|
-
| `characters[].accept` | optional, a list of bar names: the bars this character's own check may have failed and still be composed (issue #203). `compose --accept <bar>[,<bar>…]` is the same list for every character; the two are joined, so the command line applies to every character and a character's list adds to it. Each name is one of the bars `check`'s summary names, less the gate — `loop`, `seam`, `BREATH_VISIBLE`, `BLINK_NO_HOLE`, `CHAIN_LAG`, `TIP_OVER_ROOT`, `STILL_REGIONS_DARK`, `TEXTURE_STRETCH`, `ANIMATIONS_DO_NOT_FOLD` (issue #320), `STRESS_OFF_CHAIN` (issue #347), `SEAM_OVER_MOTION` (the body-root bar, issue #686); anything else is `SCENE_ACCEPT_KNOWN`. A build is taken when every bar its `check.json` failed is named; its gate red, a declared requirement not PASS, or a bar not named is `SCENE_BUILD_GREEN` as before. **It is for looking, not for shipping:** the `[compose]` line says which failing bars were accepted, `scene.json` records them as the character's `accepted`, the composed rig's own check measures them again and reports them as it finds them, and the run exits 1 even when that check is PASS (a composed rig has no `parts.json`, so the seam and four judgement lines say SKIP there). A list that accepts nothing — every build green — composes to the bytes a scene without one writes |
|
|
7307
|
+
| `characters[].accept` | optional, a list of bar names: the bars this character's own check may have failed and still be composed (issue #203). `compose --accept <bar>[,<bar>…]` is the same list for every character; the two are joined, so the command line applies to every character and a character's list adds to it. Each name is one of the bars `check`'s summary names, less the gate — `loop`, `seam`, `BREATH_VISIBLE`, `BLINK_NO_HOLE`, `CHAIN_LAG`, `TIP_OVER_ROOT`, `STILL_REGIONS_DARK`, `TEXTURE_STRETCH`, `ANIMATIONS_DO_NOT_FOLD` (issue #320), `STRESS_OFF_CHAIN` (issue #347), `SEAM_OVER_MOTION` (the body-root bar, issue #686); anything else is `SCENE_ACCEPT_KNOWN`. When `check/check.json` declares `spec: "rig-parts-check/1"`, `compose` reads its `bar_outcomes` for the bars whose outcome status is `FAIL` in the report's order (issue #1373); without that spec it keeps the legacy `barsNotMet` reading. A build is taken when every bar its `check.json` failed is named; its gate red, a declared requirement not PASS, or a bar not named is `SCENE_BUILD_GREEN` as before. **It is for looking, not for shipping:** the `[compose]` line says which failing bars were accepted, `scene.json` records them as the character's `accepted`, the composed rig's own check measures them again and reports them as it finds them, and the run exits 1 even when that check is PASS (a composed rig has no `parts.json`, so the seam and four judgement lines say SKIP there). A list that accepts nothing — every build green — composes to the bytes a scene without one writes |
|
|
7209
7308
|
| `animations` | optional map by scene clip name, each value a rigc `MotionAnimation` (`duration`, `tracks`, optional `loop`, `note`, and core timeline collections). Names resolve against the final scene without another prefix or unit conversion: `plate`, declared named plate bones and `<id>:<bone>`, including generated dials. A new name adds; `idle` appends tracks/timelines to the composed idle, preserving its metadata and every existing character track, deform and physics constraint. Its duration must exactly equal the composed idle (`SCENE_DURATION_AGREES`); no retiming. An imported animation name cannot be replaced (`SCENE_ANIMATION_NAME_FREE`). Absent declaration preserves legacy bytes and output paths (issue #1346) |
|
|
7210
7309
|
| `order` | the draw order, back to front: a character id (its slots not named elsewhere, in its own order) or one `<id>:<slot>`. Every slot of every character is drawn exactly once. Interleaving is written by naming slots: `["a", "b:arm_l", "b"]` draws `b`'s left arm between `a` and the rest of `b` |
|
|
7211
7310
|
|
|
@@ -7253,6 +7352,32 @@ or the second `shear` channel. Only the channel that drives that slider is
|
|
|
7253
7352
|
compared to its bounds. Group names must be own declared keys; inherited object
|
|
7254
7353
|
properties are refused with `CE_COMPILE_ANIMATION_GROUP_UNKNOWN`.
|
|
7255
7354
|
|
|
7355
|
+
**Turn-dial sign convention (issue #1358).** On an upright, unmirrored 2.5D
|
|
7356
|
+
turn rig, positive `rotate` keys on `<id>:yaw_dial` turn toward **screen left**
|
|
7357
|
+
(the viewer's left, decreasing world x); negative keys turn toward screen right.
|
|
7358
|
+
The body dial `<id>:<turn.body.slider>` (default `<id>:body_yaw_dial`) has the
|
|
7359
|
+
same sign. To turn toward leftward travel, key a positive yaw/body angle within
|
|
7360
|
+
that dial's declared range. These dials turn the depth layers about their pivot;
|
|
7361
|
+
they do not translate the character's scene root, and counter-moving parts can
|
|
7362
|
+
move in the opposite direction. Positive `<id>:pitch_dial` turns downward
|
|
7363
|
+
(decreasing world y, because rig coordinates are y up).
|
|
7364
|
+
|
|
7365
|
+
Measured example: the synthetic `writeTurnSceneBuild` fixture from
|
|
7366
|
+
`fixtures/scene.ts`, composed as character `a` on a 64×64 canvas at offset
|
|
7367
|
+
`[0, 0]`, was gated through Core 3.8.0 with the `rig-play` profile. Separate clips
|
|
7368
|
+
keyed each dial from `0°` at t=0 to `+4°` at t=1 and back to `0°` at t=2.
|
|
7369
|
+
Posing the packed model gave these carrier world-x readings (rig pixels,
|
|
7370
|
+
rounded to six decimals); the face and torso mesh vertices also moved left:
|
|
7371
|
+
|
|
7372
|
+
| keyed dial | observed carrier | world x at 0° | world x at +4° | displacement |
|
|
7373
|
+
| --- | --- | ---: | ---: | ---: |
|
|
7374
|
+
| `a:yaw_dial` | `a:faceshift` | −0.000001 | −1.392281 | −1.392279 |
|
|
7375
|
+
| `a:body_yaw_dial` | `a:bodyshift` | −0.000001 | −1.392280 | −1.392279 |
|
|
7376
|
+
|
|
7377
|
+
Each carrier returned to its exact starting coordinates at t=2, and the other
|
|
7378
|
+
dial's carrier stayed fixed. In the pitch clip, `a:faceshift` world y moved from
|
|
7379
|
+
28.000000 to 26.606287 at `+4°`, establishing the downward sign independently.
|
|
7380
|
+
|
|
7256
7381
|
For example, this declaration adds a plate take independently of character idle:
|
|
7257
7382
|
|
|
7258
7383
|
```json
|
|
@@ -7357,25 +7482,60 @@ What is composed:
|
|
|
7357
7482
|
declared per-mesh ceilings and actual maxima of members with none. These
|
|
7358
7483
|
counts come from emitted weighted triangles or declared grid dimensions;
|
|
7359
7484
|
scenes with no declared budget gain no budget field.
|
|
7360
|
-
- **
|
|
7361
|
-
|
|
7362
|
-
|
|
7363
|
-
`
|
|
7364
|
-
|
|
7365
|
-
|
|
7366
|
-
|
|
7367
|
-
|
|
7368
|
-
|
|
7369
|
-
|
|
7485
|
+
- **Input layout and the pre-compose `check` (issue #1350).** `compose` expects each
|
|
7486
|
+
character's `build` directory to hold `<build>/parts.json` (with the complete
|
|
7487
|
+
assemble folder beside it), `<build>/rig/` (`rig.json`, `motion.json`, `images/`),
|
|
7488
|
+
and `<build>/check/check.json` in one folder. `rig-parts build --out <build>` writes
|
|
7489
|
+
that layout directly. When a consumer ran `assemble` and `rig` into separate folders
|
|
7490
|
+
(for example `assemble --out work`, which writes `work/rig/parts.json`,
|
|
7491
|
+
`work/rig/parts/*.png` and `work/rig/painting_in_rig.png`, and `rig --out <build>/rig`),
|
|
7492
|
+
`rig-parts rig --out <build>/rig` followed by `rigc build` does not create
|
|
7493
|
+
`<build>/check/check.json` and remains `SCENE_BUILD_PRESENT`, even if the rigc gate
|
|
7494
|
+
is green. Put the **complete assemble folder** at `<build>/` beside `<build>/rig/`
|
|
7495
|
+
— `parts.json`, `parts/<name>.png` (and any alternate/depth PNGs),
|
|
7496
|
+
`painting_in_rig.png`, and any sidecars assemble wrote (`figure_rig.png`,
|
|
7497
|
+
`cut_material_sources.json`, `part_support_domains.json`); copying `parts.json`
|
|
7498
|
+
alone fails `PARTS_PAINTING_PRESENT` on `painting_in_rig.png` and `PARTS_FILE_PRESENT`
|
|
7499
|
+
on `parts/*.png` — then run the one canonical pre-compose check command:
|
|
7500
|
+
`rig-parts check --rig <build>/rig --parts <build> --source <painting.png> --requirements <requirements.json> --out <build>/check`
|
|
7501
|
+
before composing. Standalone `check` does not read `config.requirements`;
|
|
7502
|
+
`--requirements <requirements.json>` and `--source <painting.png>` are its only
|
|
7503
|
+
doors. **Why `SKIP` is not "checked":** `check.json` sets `PASS: true` when every
|
|
7504
|
+
bar that actually measured passed, so a bar or requirement that printed `SKIP` was
|
|
7505
|
+
not measured, not passed. Without `--requirements`, `check.json` writes no
|
|
7506
|
+
`requirements` block at all — every declared requirement (`contact`, `follow`, `aim`,
|
|
7507
|
+
`range`, `stretch`, `seam`) and requirements-driven bar (`setup_painting`,
|
|
7508
|
+
`boundary_colour`, `behind_seams`, `seam_over_motion.required`, `cut_material`,
|
|
7509
|
+
`fixed_skeleton`, `may_fold`, `motion_seams`, `not_planted`, `not_swinging`,
|
|
7510
|
+
`rises`, `rests`) goes unmeasured, `BOUNDARY_COLOUR_STEP` prints
|
|
7511
|
+
`SKIP — not measured, not a pass: no requirements file declares boundary_colour; declare {"boundary_colour": {"max_step_excess": <0-255>}} in the --requirements file (config.requirements under build) to hold every part boundary of the setup and every idle frame to the rig's own pieces`,
|
|
7512
|
+
`BEHIND_PART_SEAMS` prints
|
|
7513
|
+
`SKIP — HOLE: no requirements.behind_seams declares an authored threshold T; not measured, never a pass`,
|
|
7514
|
+
`SEAM_OVER_MOTION` prints
|
|
7515
|
+
`SKIP — no neighbour pair is declared: parts.json holds no limb segment below a joint (config.limbs) and no --requirements seam names two parts`
|
|
7516
|
+
when `parts.json` has no limb segments, and with `--source` alone
|
|
7517
|
+
`SETUP_MATCHES_PAINTING` prints
|
|
7518
|
+
`SKIP — setup_painting is undeclared; setup-to-painting was not measured. To measure it, give --requirements <file> declaring setup_painting.rgb_tolerance and setup_painting.regions with name, box and authored max_pixels limits`.
|
|
7519
|
+
Without `--source`, `SETUP_POSE_VS_SOURCE` is omitted (and a requirements file
|
|
7520
|
+
declaring `setup_painting` is refused as `CHECK_SETUP_PAINTING_SOURCE`). Only a
|
|
7521
|
+
standalone rig with no manifest in its own or parent directory may omit `--parts`;
|
|
7522
|
+
its parts-dependent lines retain named SKIPs. The check must report both
|
|
7523
|
+
`PASS: true` and `gate_spine_html_green: true`; named accepted failing bars keep
|
|
7524
|
+
the existing preview-only semantics. No alternate gated-only admission is implied
|
|
7525
|
+
by the turn contract.
|
|
7526
|
+
- **Gated as `rig` gates its own, and where outputs are written:** `rigc build --profile rig-play --pack`, the
|
|
7370
7527
|
compile and the packed pages on disk, in a scratch directory; `--out` receives
|
|
7371
|
-
`rig/` (`rig.json`, `motion.json`, `images/`
|
|
7528
|
+
`rig/` (`rig.json`, `motion.json`, `images/` — the composed rig spec, not the
|
|
7529
|
+
compiled Spine skeleton) and `scene.json` only when it is
|
|
7372
7530
|
green. `--page-size <px>` (a positive integer, refused as `PACK_PAGE_SIZE`
|
|
7373
7531
|
otherwise; issue #1352) is forwarded to both packed builds and recorded as
|
|
7374
7532
|
`pack_mode.page_size` in `scene.json` and `check/check.json` only when given;
|
|
7375
7533
|
without it, rigc's default 2048 px page and padding 2 on each side bound any
|
|
7376
7534
|
plate or region side to at most 2044 px before `CE_ATLAS_REGION_EXCEEDS_PAGE`
|
|
7377
7535
|
(`COMPOSE_RIGC_GREEN`). Then `check` runs over `rig/` into `check/`, as on any rig it did not
|
|
7378
|
-
build:
|
|
7536
|
+
build: **the compiled Spine model and packed atlas (`skeleton.json`,
|
|
7537
|
+
`skeleton.model.json`, `skeleton.atlas`, `skeleton.png`) are written only under
|
|
7538
|
+
`<out>/check/build/`** (there is no `<out>/build/` at the root). Without a `parts.json` the seam, `BREATH_VISIBLE`, `BLINK_NO_HOLE`,
|
|
7379
7539
|
`TIP_OVER_ROOT`, `STILL_REGIONS_DARK` and `RECOMPOSITE_HOLES` say SKIP and why,
|
|
7380
7540
|
and the gate, the loop, `CHAIN_LAG` and `TEXTURE_STRETCH` measure.
|
|
7381
7541
|
`--requirements` is forwarded, and its names are `<id>:<name>`. Every bar and
|
|
@@ -7384,10 +7544,13 @@ What is composed:
|
|
|
7384
7544
|
(`CHAIN_LAG`, a `range` in degrees) does not move with it, while a requirement's
|
|
7385
7545
|
px figures and its px bar are canvas px — a character composed at 0.5 shows half
|
|
7386
7546
|
the px its own `build` measured.
|
|
7387
|
-
- **`scene.json`** (`spine-parts-scene-report/1
|
|
7547
|
+
- **`scene.json`** (`spine-parts-scene-report/1`, written at `<out>/scene.json` —
|
|
7548
|
+
**the same filename as a typical input `--scene scene.json` file**, so write `--out`
|
|
7549
|
+
to a separate output directory rather than the directory holding the input scene
|
|
7550
|
+
file): the scene file's path as given,
|
|
7388
7551
|
the canvas, the rig's name (the ids joined by `+`), the pack flags, the plate (its
|
|
7389
7552
|
image, provenance, note, bone, slot, size, `sha256` of the PNG's bytes as compose read them — issue #1183, additive —
|
|
7390
|
-
and `judged_by: "nothing"`), per character
|
|
7553
|
+
and `judged_by: "nothing"`), `plates` when `scene.plates` is declared (each named plate's declaration, bone, slot, size, `sha256` and `judged_by: "nothing"`; the `[compose]` header line also names them in declaration order as `<N> named plate(s): <name>, ...`, and prints `no plate` only when neither `plate` nor `plates[]` is present), per character
|
|
7391
7554
|
its build, offset, `scale` (only when it is not 1), `rig_size`, `rig_scale`, placed bounds (the union of its part
|
|
7392
7555
|
boxes, canvas px), shift and what it moved (`shifted`: the first-level bones, the
|
|
7393
7556
|
regions on `root`, the count of weights bound to `root`), its counts and `accepted`
|
|
@@ -8363,6 +8526,71 @@ including unselected frames, before reading the worst pose. Identical static
|
|
|
8363
8526
|
ranges on a bone deduplicate; conflicting ranges are explicitly ambiguous,
|
|
8364
8527
|
never described as no declared range.
|
|
8365
8528
|
|
|
8529
|
+
## Declared boundary depths (#1342)
|
|
8530
|
+
|
|
8531
|
+
Optional `turn.boundaryDepths` and `turn.body.boundaryDepths` are maps keyed by
|
|
8532
|
+
an exact target part name. Every entry requires `neighbour` and `band`, both
|
|
8533
|
+
exact existing names in `parts.json`. Target and neighbour must be different
|
|
8534
|
+
`surface` parts in that same turn group, with common `near` and `zScale`.
|
|
8535
|
+
The band can be the target itself or another part whose nonzero alpha support
|
|
8536
|
+
is contained in the target and reaches its shared boundary with the neighbour.
|
|
8537
|
+
Missing fields use `CONFIG_FIELD_PRESENT`; malformed fields use
|
|
8538
|
+
`CONFIG_FIELD_TYPE`; unresolved config names use `CONFIG_NAME_RESOLVES`.
|
|
8539
|
+
Rig-time support failures and reciprocal or longer cycles use
|
|
8540
|
+
[`RIG_TURN_BOUNDARY_DEPTH`](#RIG_TURN_BOUNDARY_DEPTH).
|
|
8541
|
+
|
|
8542
|
+
A contained rectangular band already has a producer: `assemble.patches`.
|
|
8543
|
+
For example, on a target occupying `[18,20,34,44]` and a neighbour ending at
|
|
8544
|
+
`y=20`, add this patch and its ordinary region binding to the existing config:
|
|
8545
|
+
|
|
8546
|
+
```json
|
|
8547
|
+
{
|
|
8548
|
+
"assemble": {
|
|
8549
|
+
"patches": [{"name":"band_mask","box":[18,20,26,28],"alpha":"box","draw":"back"}]
|
|
8550
|
+
},
|
|
8551
|
+
"regions": {"band_mask":"chest"},
|
|
8552
|
+
"turn": {
|
|
8553
|
+
"body": {
|
|
8554
|
+
"boundaryDepths": {"garment":{"neighbour":"upper","band":"band_mask"}}
|
|
8555
|
+
}
|
|
8556
|
+
}
|
|
8557
|
+
}
|
|
8558
|
+
```
|
|
8559
|
+
|
|
8560
|
+
Merge these fields into a complete config with the existing plan, regions or
|
|
8561
|
+
meshes, body roles and pivot. The patch reads the painting in rig pixels and
|
|
8562
|
+
makes a separate opaque part without subtracting any target pixels. Verify
|
|
8563
|
+
its support lies inside the actual target alpha, not merely its bounding box.
|
|
8564
|
+
It is an ordinary drawn region: use a back drawing order that the target
|
|
8565
|
+
covers. `trace_parts: true` rejects painting patches; this route does not
|
|
8566
|
+
claim traced source-part provenance. A separately authored layer added to
|
|
8567
|
+
`assemble.plan` can also supply an existing named support part. No band
|
|
8568
|
+
producer, inferred width or hidden drawing is introduced by this feature.
|
|
8569
|
+
|
|
8570
|
+
Support is the union of closed native pixel cells with alpha greater than
|
|
8571
|
+
zero. Target and neighbour must share cell edges and have no overlapping
|
|
8572
|
+
support; corner-only contact is not an abutting edge. Inside the band each
|
|
8573
|
+
sample projects onto the nearest shared edge and bilinearly samples the
|
|
8574
|
+
**original**, silhouette-extended neighbour sheet there. Distinct equidistant
|
|
8575
|
+
projection points contribute their arithmetic mean, once per point. The
|
|
8576
|
+
result stays floating point until the existing motion encoding; no corrected
|
|
8577
|
+
sheet is written. Outside the band the original target sample is used exactly:
|
|
8578
|
+
a hard switch with no blend. Transparent silhouette and image-padding samples
|
|
8579
|
+
inherit their nearest opaque target cell, as with the existing scalar extension.
|
|
8580
|
+
Sample locations are the existing generated grid
|
|
8581
|
+
or authored mesh vertices; mesh interpolation between them still applies.
|
|
8582
|
+
A partial boundary band only constrains the boundary it reaches.
|
|
8583
|
+
|
|
8584
|
+
The original group anchor stays unchanged. A neighbour that has its own
|
|
8585
|
+
boundary declaration still lends its original sheet, so declaration order
|
|
8586
|
+
cannot feed corrections back into another target. Head yaw/pitch and body yaw
|
|
8587
|
+
use the same scalar rule. Without declarations, existing rig, motion, art,
|
|
8588
|
+
sheet and compiled output bytes remain unchanged. This opt-in changes motion,
|
|
8589
|
+
not prepared maps, bindings, calibration or setup geometry. Inspect both turn
|
|
8590
|
+
extremes and the inner band edge: the hard switch can stretch or fold cells.
|
|
8591
|
+
Existing fold, stretch and seam checks keep their existing bars and scope;
|
|
8592
|
+
a depth-continuity reading alone does not establish composite visibility.
|
|
8593
|
+
|
|
8366
8594
|
## Per-layer depth sheets (#773)
|
|
8367
8595
|
|
|
8368
8596
|
`depth_filename` is a legacy source hint. Only an explicit `config.depth` block
|
|
@@ -9099,6 +9327,64 @@ compare those to their own policy. The report does not choose which components
|
|
|
9099
9327
|
a consumer accepts. The named refusals are `DIFF_COMPONENTS_INPUT`,
|
|
9100
9328
|
`DIFF_COMPONENTS_BINDING` and `DIFF_COMPONENTS_REPORT` in the rule table.
|
|
9101
9329
|
|
|
9330
|
+
### Draft-to-draft assemble comparison (issue #1369)
|
|
9331
|
+
|
|
9332
|
+
`rig-parts diff-drafts --left <dir> --right <dir> --out <json>` reads two
|
|
9333
|
+
assemble outputs and writes one JSON report, spec `rig-parts-draft-diff/1`, with
|
|
9334
|
+
fixed key order, no clock and no file paths. Each input directory may use either
|
|
9335
|
+
the standalone `assemble --out <dir>` layout (`<dir>/rig/parts.json`,
|
|
9336
|
+
`<dir>/rig/parts/<name>.png`, `<dir>/render/recomposite_rig.png`) or the
|
|
9337
|
+
`build --out <dir>` layout (`<dir>/parts.json`, `<dir>/parts/<name>.png`,
|
|
9338
|
+
`<dir>/recomposite_rig.png`); a directory holding neither layout (or both) is
|
|
9339
|
+
refused by name (`DIFF_DRAFTS_INPUT`). `--out` must not already exist and must
|
|
9340
|
+
not lie inside `--left` or `--right` (`DIFF_DRAFTS_OUT`). Different `rig_size`
|
|
9341
|
+
canvas dimensions between `--left` and `--right` are refused by name
|
|
9342
|
+
(`DIFF_DRAFTS_CANVAS`). The command records no threshold and makes no verdict;
|
|
9343
|
+
it exits 0 whenever the report is written.
|
|
9344
|
+
|
|
9345
|
+
The top-level fields of `rig-parts-draft-diff/1`, in key order:
|
|
9346
|
+
|
|
9347
|
+
| Field | Shape | Meaning |
|
|
9348
|
+
| --- | --- | --- |
|
|
9349
|
+
| `spec` | `"rig-parts-draft-diff/1"` | Schema identifier. |
|
|
9350
|
+
| `left` | `{ parts_sha256: string, part_count: number, composite_sha256: string }` | Lowercase 64-hex SHA-256 of the raw left `parts.json` bytes, `parts.length`, and lowercase 64-hex SHA-256 of the left `recomposite_rig.png` bytes. The command only records these hashes; a consumer that holds the two pictures can detect a report that does not belong to them by comparing hashes. |
|
|
9351
|
+
| `right` | `{ parts_sha256: string, part_count: number, composite_sha256: string }` | Lowercase 64-hex SHA-256 of the raw right `parts.json` bytes, `parts.length`, and lowercase 64-hex SHA-256 of the right `recomposite_rig.png` bytes. |
|
|
9352
|
+
| `canvas` | `{ width: number, height: number }` | Shared `rig_size` dimensions `[width, height]` in rig pixels. |
|
|
9353
|
+
| `order` | `"same" \| "changed"` | `"same"` when the part names in `parts.json` draw order are equal as lists; `"changed"` otherwise. |
|
|
9354
|
+
| `parts` | `DiffDraftPart[]` | One entry per part name in the union of left and right, sorted by `name` in UTF-16 code-unit order. |
|
|
9355
|
+
| `composite` | `{ changed_px: number, colour_px: number, alpha_px: number, bounds: { x: number, y: number, w: number, h: number } \| null }` | Pixel comparison in rig-pixel space between the two `recomposite_rig.png` rasters. The recomposite is drawn on opaque white, so an alpha change there shows as a colour change; alpha is read from the per-part rows. |
|
|
9356
|
+
| `summary` | `{ same: number, changed: number, added: number, removed: number }` | Counts of `parts` entries by `status`. |
|
|
9357
|
+
|
|
9358
|
+
Each `parts[i]` entry carries, in key order:
|
|
9359
|
+
|
|
9360
|
+
- `name`: the part name.
|
|
9361
|
+
- `status`: `"same"` when the part is present on both sides with equal PNG file
|
|
9362
|
+
`sha256` and equal `box`; `"added"` when only `right` has it; `"removed"` when
|
|
9363
|
+
only `left` has it; otherwise `"changed"`.
|
|
9364
|
+
- `left` (present on `"same"`, `"changed"` and `"removed"`):
|
|
9365
|
+
`{ sha256: string, box: { x: number, y: number, w: number, h: number }, index: number }`,
|
|
9366
|
+
where `sha256` is the lowercase 64-hex SHA-256 of the part PNG file bytes,
|
|
9367
|
+
`box` is the part's rig-pixel crop box from `parts.json`, and `index` is its
|
|
9368
|
+
0-based draw-order index in `parts.json`.
|
|
9369
|
+
- `right` (present on `"same"`, `"changed"` and `"added"`):
|
|
9370
|
+
`{ sha256: string, box: { x: number, y: number, w: number, h: number }, index: number }`.
|
|
9371
|
+
- `pixels_equal` (present on `"changed"` only): `true` or `false`. `true`
|
|
9372
|
+
exactly when the two decoded part images have the same width and height and
|
|
9373
|
+
are equal in every RGBA channel at every position of the part's own crop,
|
|
9374
|
+
whatever their boxes. A re-encoded PNG with identical decoded RGBA pixels has
|
|
9375
|
+
`status: "changed"`, `pixels_equal: true` and `pixels.changed_px: 0`; a part
|
|
9376
|
+
that moved (`left.box` != `right.box`) with the same art has
|
|
9377
|
+
`status: "changed"`, `pixels_equal: true` and non-zero rig-space `pixels`
|
|
9378
|
+
counts; a repaint has `status: "changed"` and `pixels_equal: false`.
|
|
9379
|
+
- `pixels` (present on `"changed"` only):
|
|
9380
|
+
`{ changed_px: number, colour_px: number, alpha_px: number, bounds: { x: number, y: number, w: number, h: number } \| null }`,
|
|
9381
|
+
compared in rig-pixel space over the union of `left.box` and `right.box`, with
|
|
9382
|
+
any position outside a side's box counting as RGBA `0, 0, 0, 0`. `changed_px`
|
|
9383
|
+
counts rig pixels where any of R, G, B or A differs; `colour_px` where any of
|
|
9384
|
+
R, G or B differs; `alpha_px` where A differs; `bounds` is the bounding box
|
|
9385
|
+
`{ x, y, w, h }` of the changed rig positions, or `null` when
|
|
9386
|
+
`changed_px` is `0`.
|
|
9387
|
+
|
|
9102
9388
|
|
|
9103
9389
|
### Consumer check rows (issue #1089)
|
|
9104
9390
|
|
|
@@ -9173,8 +9459,8 @@ Internal `SeamSupport.drawings` never enters check JSON. Named requirement
|
|
|
9173
9459
|
<!-- check-row-table:begin -->
|
|
9174
9460
|
| Row family | Registered JSON paths | row_scope | row_kind | row_subjects (producer expression) | Producer |
|
|
9175
9461
|
| --- | --- | --- | --- | --- | --- |
|
|
9176
|
-
| `ANIMATIONS_DO_NOT_FOLD.declared_not_folding` | `ANIMATIONS_DO_NOT_FOLD.declared_not_folding` | part when the supplied mapping resolves a piece; otherwise rig | finding | resolved piece for e.slot; otherwise [] | [check.ts:
|
|
9177
|
-
| `ANIMATIONS_DO_NOT_FOLD.folding` | `ANIMATIONS_DO_NOT_FOLD.folding` | part when the supplied mapping resolves a piece; otherwise rig | finding when entry === undefined; otherwise evidence | resolved piece for slot; otherwise [] | [check.ts:
|
|
9462
|
+
| `ANIMATIONS_DO_NOT_FOLD.declared_not_folding` | `ANIMATIONS_DO_NOT_FOLD.declared_not_folding` | part when the supplied mapping resolves a piece; otherwise rig | finding | resolved piece for e.slot; otherwise [] | [check.ts:3696](../src/check.ts#L3696) |
|
|
9463
|
+
| `ANIMATIONS_DO_NOT_FOLD.folding` | `ANIMATIONS_DO_NOT_FOLD.folding` | part when the supplied mapping resolves a piece; otherwise rig | finding when entry === undefined; otherwise evidence | resolved piece for slot; otherwise [] | [check.ts:3658](../src/check.ts#L3658) |
|
|
9178
9464
|
| `ART_JOINT_DISTANCE.joints` | `ART_JOINT_DISTANCE.joints` | 'rig' | finding when status === 'FAIL'; otherwise evidence | [] | [artjoints.ts:86](../src/artjoints.ts#L86) |
|
|
9179
9465
|
| `BEHIND_PART_SEAMS.contributors` | `BEHIND_PART_SEAMS.turn.pairs[].frames[].standing.samples[].contributors`; `BEHIND_PART_SEAMS.turn.pairs[].frames[].motion_opened.samples[].contributors`; `BEHIND_PART_SEAMS.pairs[].setup.motion_opened.samples[].contributors`; `BEHIND_PART_SEAMS.pairs[].setup.standing.samples[].contributors`; `BEHIND_PART_SEAMS.pairs[].frames[].motion_opened.samples[].contributors`; `BEHIND_PART_SEAMS.pairs[].frames[].standing.samples[].contributors` | 'pair' | evidence | [pair.a, pair.b] | [behindseams.ts:396](../src/behindseams.ts#L396) |
|
|
9180
9466
|
| `BEHIND_PART_SEAMS.hits` | `BEHIND_PART_SEAMS.pairs[].motion_opened.frames`; `BEHIND_PART_SEAMS.pairs[].standing.frames`; `BEHIND_PART_SEAMS.pairs[].motion_opened.worst`; `BEHIND_PART_SEAMS.pairs[].standing.worst` | 'pair' | finding when r.px > allowance; otherwise evidence | parts | [behindseams.ts:456](../src/behindseams.ts#L456) |
|
|
@@ -9190,50 +9476,50 @@ Internal `SeamSupport.drawings` never enters check JSON. Named requirement
|
|
|
9190
9476
|
| `BEHIND_PART_SEAMS.unread_corridors` | `BEHIND_PART_SEAMS.turn.pairs[].frames[].standing.unread_corridors`; `BEHIND_PART_SEAMS.pairs[].setup.standing.unread_corridors`; `BEHIND_PART_SEAMS.pairs[].frames[].standing.unread_corridors` | 'pair' | evidence | [pair.a, pair.b] | [behindseams.ts:319](../src/behindseams.ts#L319) |
|
|
9191
9477
|
| `BOUNDARY_COLOUR_STEP.over` | `BOUNDARY_COLOUR_STEP.over` | 'pair' | finding | r.parts | [boundarycolour.ts:221](../src/boundarycolour.ts#L221) |
|
|
9192
9478
|
| `BOUNDARY_COLOUR_STEP.unmeasured` | `BOUNDARY_COLOUR_STEP.unmeasured` | part when the supplied mapping resolves a piece; otherwise rig | evidence | resolved piece for r.slot; otherwise [] | [boundarycolour.ts:222](../src/boundarycolour.ts#L222) |
|
|
9193
|
-
| `CLOTH_SETTLES.rows` | `CLOTH_SETTLES.rows` | 'rig' | finding when speeds.length > 0 && s < speeds.length; otherwise evidence | [] | [check.ts:
|
|
9479
|
+
| `CLOTH_SETTLES.rows` | `CLOTH_SETTLES.rows` | 'rig' | finding when speeds.length > 0 && s < speeds.length; otherwise evidence | [] | [check.ts:6143](../src/check.ts#L6143) |
|
|
9194
9480
|
| `CUT_JOINT_MATERIAL.rows` | `CUT_JOINT_MATERIAL.rows` | 'part' | finding when r.status === 'FAIL'; otherwise evidence | [r.part] | [cutmaterial.ts:280](../src/cutmaterial.ts#L280) |
|
|
9195
|
-
| `FEET_STAY_LEVEL.feet` | `FEET_STAY_LEVEL.feet` | 'part' | finding when row.status === 'FAIL'; otherwise evidence | [row.part] | [check.ts:
|
|
9196
|
-
| `FEET_STAY_LEVEL.feet[].worst.through` | `FEET_STAY_LEVEL.feet[].worst.through` | 'rig' | evidence | [] | [check.ts:
|
|
9197
|
-
| `LIMB_ONE_BONE.parts` | `LIMB_ONE_BONE.parts` | 'part' | finding when fail; otherwise evidence | [p.name] | [check.ts:
|
|
9481
|
+
| `FEET_STAY_LEVEL.feet` | `FEET_STAY_LEVEL.feet` | 'part' | finding when row.status === 'FAIL'; otherwise evidence | [row.part] | [check.ts:3897](../src/check.ts#L3897) |
|
|
9482
|
+
| `FEET_STAY_LEVEL.feet[].worst.through` | `FEET_STAY_LEVEL.feet[].worst.through` | 'rig' | evidence | [] | [check.ts:3872](../src/check.ts#L3872) |
|
|
9483
|
+
| `LIMB_ONE_BONE.parts` | `LIMB_ONE_BONE.parts` | 'part' | finding when fail; otherwise evidence | [p.name] | [check.ts:4189](../src/check.ts#L4189) |
|
|
9198
9484
|
| `PART_SUPPORT_REPORT.pairs` | `PART_SUPPORT_REPORT.pairs` | 'pair' | evidence; finding when length > 0; otherwise evidence | [F.name, B.name] | [coincide.ts:114](../src/coincide.ts#L114), [coincide.ts:130](../src/coincide.ts#L130) |
|
|
9199
9485
|
| `PART_SUPPORT_REPORT.raw_pairs` | `PART_SUPPORT_REPORT.raw_pairs` | 'pair' | evidence | [F.name, B.name] | [coincide.ts:110](../src/coincide.ts#L110) |
|
|
9200
9486
|
| `PART_SUPPORT_REPORT.unowned.regions` | `PART_SUPPORT_REPORT.unowned.regions` | 'rig' | finding | [] | [coincide.ts:145](../src/coincide.ts#L145) |
|
|
9201
|
-
| `SEAM_OVER_MOTION.pairs` | `SEAM_OVER_MOTION.pairs` | 'pair' | evidence | [p.a, p.b] | [check.ts:
|
|
9202
|
-
| `SEAM_OVER_MOTION.required.pairs` | `SEAM_OVER_MOTION.required.pairs` | 'pair' | finding when open > 0; otherwise evidence | [p.a, p.b] | [check.ts:
|
|
9203
|
-
| `SEAM_OVER_MOTION.required.pairs[].open_frames` | `SEAM_OVER_MOTION.required.pairs[].open_frames` | 'pair' | evidence | [p.a, p.b] | [check.ts:
|
|
9204
|
-
| `SEAM_OVER_MOTION.roots.unmeasured` | `SEAM_OVER_MOTION.roots.unmeasured` | 'part' | evidence | [root.part] | [check.ts:
|
|
9205
|
-
| `SEAM_OVER_MOTION.rows` | `SEAM_OVER_MOTION.rows` | 'pair'; unique ? 'pair' : 'rig' | finding when motionSeamFinding(want.root !== undefined, p.status, p.banded, opens.length); otherwise evidence; finding when motionSeamFinding(rootNames.has(r.pair), r.status, r.banded, r.opens.length); otherwise evidence | [want.a, want.b]; unique ? [pair.a, pair.b] : [] | [check.ts:
|
|
9206
|
-
| `SEAM_OVER_MOTION.rows[].cells` | `SEAM_OVER_MOTION.rows[].cells` | 'pair' | evidence | [want.a, want.b] | [check.ts:
|
|
9207
|
-
| `SEAM_OVER_MOTION.rows[].joint_contact.reasons` | `SEAM_OVER_MOTION.rows[].joint_contact.reasons` | 'pair' | evidence | [want.a, want.b] | [check.ts:
|
|
9487
|
+
| `SEAM_OVER_MOTION.pairs` | `SEAM_OVER_MOTION.pairs` | 'pair' | evidence | [p.a, p.b] | [check.ts:5540](../src/check.ts#L5540) |
|
|
9488
|
+
| `SEAM_OVER_MOTION.required.pairs` | `SEAM_OVER_MOTION.required.pairs` | 'pair' | finding when open > 0; otherwise evidence | [p.a, p.b] | [check.ts:4859](../src/check.ts#L4859) |
|
|
9489
|
+
| `SEAM_OVER_MOTION.required.pairs[].open_frames` | `SEAM_OVER_MOTION.required.pairs[].open_frames` | 'pair' | evidence | [p.a, p.b] | [check.ts:4851](../src/check.ts#L4851) |
|
|
9490
|
+
| `SEAM_OVER_MOTION.roots.unmeasured` | `SEAM_OVER_MOTION.roots.unmeasured` | 'part' | evidence | [root.part] | [check.ts:5517](../src/check.ts#L5517) |
|
|
9491
|
+
| `SEAM_OVER_MOTION.rows` | `SEAM_OVER_MOTION.rows` | 'pair'; unique ? 'pair' : 'rig' | finding when motionSeamFinding(want.root !== undefined, p.status, p.banded, opens.length); otherwise evidence; finding when motionSeamFinding(rootNames.has(r.pair), r.status, r.banded, r.opens.length); otherwise evidence | [want.a, want.b]; unique ? [pair.a, pair.b] : [] | [check.ts:5474](../src/check.ts#L5474), [check.ts:5546](../src/check.ts#L5546) |
|
|
9492
|
+
| `SEAM_OVER_MOTION.rows[].cells` | `SEAM_OVER_MOTION.rows[].cells` | 'pair' | evidence | [want.a, want.b] | [check.ts:5487](../src/check.ts#L5487) |
|
|
9493
|
+
| `SEAM_OVER_MOTION.rows[].joint_contact.reasons` | `SEAM_OVER_MOTION.rows[].joint_contact.reasons` | 'pair' | evidence | [want.a, want.b] | [check.ts:5477](../src/check.ts#L5477) |
|
|
9208
9494
|
| `SEAM_OVER_MOTION.rows[].pose_at_worst.joints` | `SEAM_OVER_MOTION.rows[].pose_at_worst.joints` | 'rig' | evidence | [] | [motionseampose.ts:53](../src/motionseampose.ts#L53) |
|
|
9209
|
-
| `SEAM_OVER_MOTION.worlds.*.rows` | `SEAM_OVER_MOTION.worlds.*.rows` | 'pair' | evidence | [want.a, want.b] | [check.ts:
|
|
9210
|
-
| `SEAM_OVER_RANGE.joints` | `SEAM_OVER_RANGE.joints` | 'part' | evidence; finding when poses.some(p => p.status === 'FAIL'); otherwise evidence | [j.part] | [check.ts:
|
|
9211
|
-
| `SEAM_OVER_RANGE.joints[].poses` | `SEAM_OVER_RANGE.joints[].poses` | 'part' | finding when fail; otherwise evidence | [j.part] | [check.ts:
|
|
9495
|
+
| `SEAM_OVER_MOTION.worlds.*.rows` | `SEAM_OVER_MOTION.worlds.*.rows` | 'pair' | evidence | [want.a, want.b] | [check.ts:5471](../src/check.ts#L5471) |
|
|
9496
|
+
| `SEAM_OVER_RANGE.joints` | `SEAM_OVER_RANGE.joints` | 'part' | evidence; finding when poses.some(p => p.status === 'FAIL'); otherwise evidence | [j.part] | [check.ts:4513](../src/check.ts#L4513), [check.ts:4559](../src/check.ts#L4559) |
|
|
9497
|
+
| `SEAM_OVER_RANGE.joints[].poses` | `SEAM_OVER_RANGE.joints[].poses` | 'part' | finding when fail; otherwise evidence | [j.part] | [check.ts:4557](../src/check.ts#L4557) |
|
|
9212
9498
|
| `SETUP_MATCHES_PAINTING.regions` | `SETUP_MATCHES_PAINTING.regions` | 'rig' | finding when status === 'FAIL'; otherwise evidence | [] | [setuppainting.ts:175](../src/setuppainting.ts#L175) |
|
|
9213
9499
|
| `SETUP_MATCHES_PAINTING.regions[].slots` | `SETUP_MATCHES_PAINTING.regions[].slots` | part when the supplied mapping resolves a piece; otherwise rig | evidence | resolved piece for slot; otherwise [] | [setuppainting.ts:176](../src/setuppainting.ts#L176) |
|
|
9214
|
-
| `STILL_REGIONS_DARK.*.crossing` | `STILL_REGIONS_DARK.*.crossing` | part when the supplied mapping resolves a piece; otherwise rig | finding | resolved piece for sl.name; otherwise [] | [check.ts:
|
|
9215
|
-
| `STILL_REGIONS_DARK.*.still_slots` | `STILL_REGIONS_DARK.*.still_slots` | part when the supplied mapping resolves a piece; otherwise rig | evidence; finding when r.max > tolerance; otherwise evidence | resolved piece for slot; otherwise [] | [check.ts:
|
|
9216
|
-
| `STRESS_OFF_CHAIN.not_read` | `STRESS_OFF_CHAIN.not_read` | 'part' | evidence | [r.part] | [check.ts:
|
|
9217
|
-
| `STRESS_OFF_CHAIN.per_part` | `STRESS_OFF_CHAIN.per_part` | 'part' | finding when poses.some(p => typeof p.reading === 'number' && p.reading > STRESS_RIGID); otherwise evidence | [r.part] | [check.ts:
|
|
9218
|
-
| `STRESS_OFF_CHAIN.per_part[].off_chain` | `STRESS_OFF_CHAIN.per_part[].off_chain` | 'part' | evidence | [r.part] | [check.ts:
|
|
9219
|
-
| `STRESS_OFF_CHAIN.per_part[].poses` | `STRESS_OFF_CHAIN.per_part[].poses` | 'part' | evidence; finding when shown > STRESS_RIGID; otherwise evidence | [r.part] | [check.ts:
|
|
9220
|
-
| `TEXTURE_STRETCH.per_mesh` | `TEXTURE_STRETCH.per_mesh` | part when the supplied mapping resolves a piece; otherwise rig | evidence; finding when severity > TEXTURE_STRETCH_CEILING; otherwise evidence | resolved piece for m.slot; otherwise [] | [check.ts:
|
|
9221
|
-
| `TIP_OVER_ROOT.parts` | `TIP_OVER_ROOT.parts` | 'part' | evidence; finding when !ok && !(!rigid && hanging.onLink && Math.max(c.root, c.tip) < TIP_TRAVEL_FLOOR); otherwise evidence | [p.name] | [check.ts:
|
|
9222
|
-
| `WIND_BAND.pairs` | `WIND_BAND.pairs` | 'pair' | finding when !holdsAll; otherwise evidence | [p.a, p.b] | [check.ts:
|
|
9223
|
-
| `WIND_BAND.pairs[].steps` | `WIND_BAND.pairs[].steps` | 'pair' | finding when !s.holds; otherwise evidence | [p.a, p.b] | [check.ts:
|
|
9224
|
-
| `figure_openings.openings` | `figure_openings.openings` | 'pair' | finding | [ps.under, ps.above] | [check.ts:
|
|
9225
|
-
| `loop_physics` | `loop_physics` | 'rig' | evidence | [] | [check.ts:
|
|
9226
|
-
| `requirements.lines.* (bone)` | `requirements.lines.*` | 'rig' | finding when line.status === 'FAIL'; otherwise evidence | [] | [check.ts:
|
|
9227
|
-
| `requirements.lines.* (seam)` | `requirements.lines.*` | 'pair' | finding when line.status === 'FAIL'; otherwise evidence | [r.part, r.neighbour] | [check.ts:
|
|
9228
|
-
| `requirements.lines.* (stretch)` | `requirements.lines.*` | part when the supplied mapping resolves a piece; otherwise rig | finding when line.status === 'FAIL'; otherwise evidence | resolved piece for r.slot; otherwise [] | [check.ts:
|
|
9229
|
-
| `seam_cells.frames` | `frames` | 'pair' | evidence | [p.a, p.b] | [check.ts:
|
|
9230
|
-
| `seam_cells.frames[].cells` | `frames[].cells` | part when the supplied mapping resolves a piece; otherwise rig | evidence | resolved piece for cell.setupTop ?? ''; otherwise [] | [check.ts:
|
|
9231
|
-
| `seam_pairs` | `seam_pairs`; `seam_scope.whole_pairs`; `sets.*.seam_pairs`; `sets.*.seam_scope.whole_pairs` | subjects.length === 0 ? 'rig' : subjects.length === 1 ? 'part' : 'pair' | evidence | subjects | [check.ts:
|
|
9232
|
-
| `seam_scope.changes` | `seam_scope.changes`; `sets.*.seam_scope.changes` | 'rig' | evidence | [] | [check.ts:
|
|
9233
|
-
| `seam_scope.domain.states` | `seam_scope.domain.states`; `sets.*.seam_scope.domain.states` | 'rig' | evidence | [] | [check.ts:
|
|
9234
|
-
| `seam_scope.pairs` | `seam_scope.pairs`; `sets.*.seam_scope.pairs` | subjects.length === 0 ? 'rig' : subjects.length === 1 ? 'part' : 'pair' | evidence | subjects | [check.ts:
|
|
9235
|
-
| `seam_scope.population.pairs` | `seam_scope.population.pairs`; `sets.*.seam_scope.population.pairs` | 'pair' | evidence | row.parts | [check.ts:
|
|
9236
|
-
| `seam_scope.population.single_art` | `seam_scope.population.single_art`; `sets.*.seam_scope.population.single_art` | 'part' | evidence | [row.part] | [check.ts:
|
|
9500
|
+
| `STILL_REGIONS_DARK.*.crossing` | `STILL_REGIONS_DARK.*.crossing` | part when the supplied mapping resolves a piece; otherwise rig | finding | resolved piece for sl.name; otherwise [] | [check.ts:9280](../src/check.ts#L9280) |
|
|
9501
|
+
| `STILL_REGIONS_DARK.*.still_slots` | `STILL_REGIONS_DARK.*.still_slots` | part when the supplied mapping resolves a piece; otherwise rig | evidence; finding when r.max > tolerance; otherwise evidence | resolved piece for slot; otherwise [] | [check.ts:9266](../src/check.ts#L9266), [check.ts:9271](../src/check.ts#L9271) |
|
|
9502
|
+
| `STRESS_OFF_CHAIN.not_read` | `STRESS_OFF_CHAIN.not_read` | 'part' | evidence | [r.part] | [check.ts:4117](../src/check.ts#L4117) |
|
|
9503
|
+
| `STRESS_OFF_CHAIN.per_part` | `STRESS_OFF_CHAIN.per_part` | 'part' | finding when poses.some(p => typeof p.reading === 'number' && p.reading > STRESS_RIGID); otherwise evidence | [r.part] | [check.ts:4105](../src/check.ts#L4105) |
|
|
9504
|
+
| `STRESS_OFF_CHAIN.per_part[].off_chain` | `STRESS_OFF_CHAIN.per_part[].off_chain` | 'part' | evidence | [r.part] | [check.ts:4105](../src/check.ts#L4105) |
|
|
9505
|
+
| `STRESS_OFF_CHAIN.per_part[].poses` | `STRESS_OFF_CHAIN.per_part[].poses` | 'part' | evidence; finding when shown > STRESS_RIGID; otherwise evidence | [r.part] | [check.ts:4073](../src/check.ts#L4073), [check.ts:4091](../src/check.ts#L4091) |
|
|
9506
|
+
| `TEXTURE_STRETCH.per_mesh` | `TEXTURE_STRETCH.per_mesh` | part when the supplied mapping resolves a piece; otherwise rig | evidence; finding when severity > TEXTURE_STRETCH_CEILING; otherwise evidence | resolved piece for m.slot; otherwise [] | [check.ts:9930](../src/check.ts#L9930), [check.ts:9940](../src/check.ts#L9940) |
|
|
9507
|
+
| `TIP_OVER_ROOT.parts` | `TIP_OVER_ROOT.parts` | 'part' | evidence; finding when !ok && !(!rigid && hanging.onLink && Math.max(c.root, c.tip) < TIP_TRAVEL_FLOOR); otherwise evidence | [p.name] | [check.ts:8655](../src/check.ts#L8655), [check.ts:8660](../src/check.ts#L8660), [check.ts:8681](../src/check.ts#L8681), [check.ts:8692](../src/check.ts#L8692) |
|
|
9508
|
+
| `WIND_BAND.pairs` | `WIND_BAND.pairs` | 'pair' | finding when !holdsAll; otherwise evidence | [p.a, p.b] | [check.ts:6647](../src/check.ts#L6647) |
|
|
9509
|
+
| `WIND_BAND.pairs[].steps` | `WIND_BAND.pairs[].steps` | 'pair' | finding when !s.holds; otherwise evidence | [p.a, p.b] | [check.ts:6658](../src/check.ts#L6658) |
|
|
9510
|
+
| `figure_openings.openings` | `figure_openings.openings` | 'pair' | finding | [ps.under, ps.above] | [check.ts:5964](../src/check.ts#L5964) |
|
|
9511
|
+
| `loop_physics` | `loop_physics` | 'rig' | evidence | [] | [check.ts:7696](../src/check.ts#L7696) |
|
|
9512
|
+
| `requirements.lines.* (bone)` | `requirements.lines.*` | 'rig' | finding when line.status === 'FAIL'; otherwise evidence | [] | [check.ts:8023](../src/check.ts#L8023) |
|
|
9513
|
+
| `requirements.lines.* (seam)` | `requirements.lines.*` | 'pair' | finding when line.status === 'FAIL'; otherwise evidence | [r.part, r.neighbour] | [check.ts:8023](../src/check.ts#L8023) |
|
|
9514
|
+
| `requirements.lines.* (stretch)` | `requirements.lines.*` | part when the supplied mapping resolves a piece; otherwise rig | finding when line.status === 'FAIL'; otherwise evidence | resolved piece for r.slot; otherwise [] | [check.ts:8023](../src/check.ts#L8023) |
|
|
9515
|
+
| `seam_cells.frames` | `frames` | 'pair' | evidence | [p.a, p.b] | [check.ts:4848](../src/check.ts#L4848) |
|
|
9516
|
+
| `seam_cells.frames[].cells` | `frames[].cells` | part when the supplied mapping resolves a piece; otherwise rig | evidence | resolved piece for cell.setupTop ?? ''; otherwise [] | [check.ts:4808](../src/check.ts#L4808) |
|
|
9517
|
+
| `seam_pairs` | `seam_pairs`; `seam_scope.whole_pairs`; `sets.*.seam_pairs`; `sets.*.seam_scope.whole_pairs` | subjects.length === 0 ? 'rig' : subjects.length === 1 ? 'part' : 'pair' | evidence | subjects | [check.ts:2547](../src/check.ts#L2547) |
|
|
9518
|
+
| `seam_scope.changes` | `seam_scope.changes`; `sets.*.seam_scope.changes` | 'rig' | evidence | [] | [check.ts:2025](../src/check.ts#L2025) |
|
|
9519
|
+
| `seam_scope.domain.states` | `seam_scope.domain.states`; `sets.*.seam_scope.domain.states` | 'rig' | evidence | [] | [check.ts:2110](../src/check.ts#L2110) |
|
|
9520
|
+
| `seam_scope.pairs` | `seam_scope.pairs`; `sets.*.seam_scope.pairs` | subjects.length === 0 ? 'rig' : subjects.length === 1 ? 'part' : 'pair' | evidence | subjects | [check.ts:7557](../src/check.ts#L7557) |
|
|
9521
|
+
| `seam_scope.population.pairs` | `seam_scope.population.pairs`; `sets.*.seam_scope.population.pairs` | 'pair' | evidence | row.parts | [check.ts:2481](../src/check.ts#L2481) |
|
|
9522
|
+
| `seam_scope.population.single_art` | `seam_scope.population.single_art`; `sets.*.seam_scope.population.single_art` | 'part' | evidence | [row.part] | [check.ts:2482](../src/check.ts#L2482) |
|
|
9237
9523
|
|
|
9238
9524
|
| Open serialized type path | Reason for schema exclusion |
|
|
9239
9525
|
| --- | --- |
|