@rig-c/parts 2.50.0 → 2.52.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/cli.ts +130 -14
- package/docs/AUTHORING.md +163 -56
- package/docs/DEPTH.md +22 -2
- package/docs/STABILITY.md +81 -24
- package/package.json +3 -2
- package/src/build.ts +2 -0
- package/src/bustlandmarks.ts +64 -8
- package/src/check.ts +55 -26
- package/src/checkrow.ts +1 -0
- package/src/cloth-targets.json +10 -0
- package/src/config.ts +50 -43
- package/src/configwrite.ts +70 -12
- package/src/depthworkflow.ts +38 -4
- package/src/editedparts.ts +43 -1
- package/src/instruments.ts +2 -2
- package/src/outputpaths.ts +24 -0
- package/src/parts.ts +35 -2
- package/src/physicscontrib.ts +311 -0
- package/src/propose.ts +30 -22
- package/src/rig.ts +13 -0
package/docs/AUTHORING.md
CHANGED
|
@@ -267,12 +267,39 @@ on a drafted rig, and the act review emits carries them. The order is:
|
|
|
267
267
|
writes the landmarks file from that row. It writes
|
|
268
268
|
`<landmarks.json>.provenance.json` beside it. When the person changed a
|
|
269
269
|
shape field (`alpha`, `clearance`, `bone_r`, `bone_l`, `spacing`) and the
|
|
270
|
-
config already declares `contour.bust
|
|
271
|
-
act's five values into that `contour.bust`
|
|
272
|
-
file. When the config declares no
|
|
273
|
-
changed fields are recorded as a
|
|
274
|
-
|
|
270
|
+
config already declares `contour.bust` at the act's own three points, add
|
|
271
|
+
`--write-config`: it takes the act's five values into that `contour.bust`
|
|
272
|
+
and then writes the landmarks file. When the config declares no
|
|
273
|
+
`contour.bust` yet (the first draft), the changed fields are recorded as a
|
|
274
|
+
**pending** shape in the record. The same happens on a second correction
|
|
275
|
+
that moves the points (issue #1443), with or without `--write-config`: the
|
|
276
|
+
act's apex_r or apex_l differs from the declared one in either coordinate,
|
|
277
|
+
its cleavage differs, or it has no cleavage. The command writes nothing into
|
|
278
|
+
the config then. A shape written against the old points could refuse what
|
|
279
|
+
the new points fit, and `propose` writes the points and the shape together.
|
|
280
|
+
Each field whose value differs from the config's (after defaults) is
|
|
281
|
+
pending. A field the config declares and the act leaves out is pending as
|
|
282
|
+
the default's value. `bust-landmarks` never writes the three points. Either
|
|
283
|
+
way the command ends by printing the one that applies the file:
|
|
284
|
+
`next, to apply it: rig-parts propose … --write-config <config.json> --bust-landmarks <landmarks.json>`,
|
|
285
|
+
with the config it read. Without `--write-config`, `propose` writes only
|
|
286
|
+
`proposal.json`. Before it writes, the command checks the three points
|
|
287
|
+
against the shape step 4 will check them with, and refuses the same points
|
|
288
|
+
(`CONFIG_BUST_CLEARANCE`). A cleavage the act leaves out is checked in step 4,
|
|
289
|
+
where it is derived.
|
|
275
290
|
4. Redraft with `propose … --write-config <config.json> --bust-landmarks <landmarks.json>`.
|
|
291
|
+
On a sampled body-turn neck config the same command, without `--full` and
|
|
292
|
+
`--head`, writes the chest alone and keeps the neck draft
|
|
293
|
+
([A neck that moves on its own](#a-neck-that-moves-on-its-own)). Such a config
|
|
294
|
+
gets its contour carrier in this order: step 1 before `turn.body` is written,
|
|
295
|
+
then `turn.body` and the neck draft, then steps 2 to 4.
|
|
296
|
+
On either route the points are checked with the **effective shape**, the one
|
|
297
|
+
the config write keeps (issue #1441). Each of `alpha`, `clearance`, `bone_r`,
|
|
298
|
+
`bone_l` and `spacing` is the pending record's value where it names one, else
|
|
299
|
+
the config's declared `contour.bust` field, else the default. Points that fit
|
|
300
|
+
only the tuned shape are written. Points that fit neither are refused, and the
|
|
301
|
+
refusal ends with the alpha and clearance it used and where each came from:
|
|
302
|
+
`the shape checked: alpha 0.22 (the default), clearance 8 (the pending record)`.
|
|
276
303
|
It writes `contour.bust` with the three points, and with a pending shape it
|
|
277
304
|
writes those fields too, in the same staged write, and marks the record
|
|
278
305
|
applied. The redraft keeps the config's declared shape fields (#1428).
|
|
@@ -300,7 +327,9 @@ rows of `value.chestLandmarks`. From each row it reads `edit.slot`, `edit.skin`,
|
|
|
300
327
|
- an `edit.source.frame` other than `parts.json`'s `rig_size`, the frame the
|
|
301
328
|
points are rig px in (`BUST_LANDMARKS_FRAME`);
|
|
302
329
|
- an `alpha`, `clearance`, `spacing`, `bone_r` or `bone_l` that differs from the
|
|
303
|
-
config's `meshes.<part>.contour.bust` after defaults
|
|
330
|
+
config's `meshes.<part>.contour.bust` after defaults, for an act at the
|
|
331
|
+
declared points and without `--write-config` (`BUST_LANDMARKS_SHAPE`). An act
|
|
332
|
+
that moves the points leaves the difference pending instead.
|
|
304
333
|
The landmarks file carries none of the five, so a different value would be
|
|
305
334
|
dropped. A config with no `contour.bust` yet, the first draft made with
|
|
306
335
|
`--no-bust`, compares against the defaults (alpha 0.22, clearance 3.8,
|
|
@@ -341,9 +370,11 @@ record sits beside the landmarks file because `propose --bust-landmarks` refuses
|
|
|
341
370
|
any key but the three points.
|
|
342
371
|
|
|
343
372
|
A **pending** shape is the record's last key, `shape`, present only when the
|
|
344
|
-
|
|
373
|
+
act's shape differs from the config's and the config declared no `contour.bust`
|
|
374
|
+
or the act moves its points (issue #1443):
|
|
345
375
|
`{"status": "pending", "fields": {…}}`, the act's fields whose value differs from
|
|
346
|
-
the
|
|
376
|
+
the config's after defaults (with no `contour.bust`, from the default), in the
|
|
377
|
+
shorthand's key order (`alpha`, `clearance`, `bone_r`,
|
|
347
378
|
`bone_l`, `spacing`). An all-default act writes no `shape`, so its record is the
|
|
348
379
|
same bytes as before. `propose --bust-landmarks <file>` reads `<file>.provenance.json`
|
|
349
380
|
when it is there; with none it reads the landmarks file as before. A record there
|
|
@@ -373,7 +404,7 @@ config hash: the act carries none.
|
|
|
373
404
|
| <a id="BUST_LANDMARKS_PART_ROWS"></a>`BUST_LANDMARKS_PART_ROWS` | the act has more than one row for one part | keep one chest-landmarks row for the part in review |
|
|
374
405
|
| <a id="BUST_LANDMARKS_ROWS"></a>`BUST_LANDMARKS_ROWS` | the act has rows for more than one part; `propose` drafts one chest carrier | keep the row for the chest carrier only |
|
|
375
406
|
| <a id="BUST_LANDMARKS_FRAME"></a>`BUST_LANDMARKS_FRAME` | the row's `edit.source.frame` is not `parts.json`'s `rig_size` | pass the `--parts` directory of the rig the act was made on |
|
|
376
|
-
| <a id="BUST_LANDMARKS_SHAPE"></a>`BUST_LANDMARKS_SHAPE` | the row's `alpha`, `clearance`, `spacing`, `bone_r` or `bone_l` differs from the config's declared `meshes.<part>.contour.bust` after defaults (with no `contour.bust`, a difference is recorded pending instead) | run again with `--write-config` to take the act's value into the config, or put the config's value back in review and emit the act again |
|
|
407
|
+
| <a id="BUST_LANDMARKS_SHAPE"></a>`BUST_LANDMARKS_SHAPE` | the row's `alpha`, `clearance`, `spacing`, `bone_r` or `bone_l` differs from the config's declared `meshes.<part>.contour.bust` after defaults, for an act at the declared points without `--write-config` (with no `contour.bust`, or with points the act moves, a difference is recorded pending instead) | run again with `--write-config` to take the act's value into the config, or put the config's value back in review and emit the act again |
|
|
377
408
|
| <a id="BUST_LANDMARKS_OUT"></a>`BUST_LANDMARKS_OUT` | `--out` or `<out>.provenance.json` lies inside `--parts`, is the act, the config or `parts.json` (by path or as a hard link), is a directory or a read-only file, or cannot be staged or replaced | choose a path outside the parts directory that is no input, in an existing writable directory; remove a leftover `.<name>.rig-parts.tmp` the detail names |
|
|
378
409
|
|
|
379
410
|
Drafted torso bytes change from lattice (or a figure trunk's region) to contour.
|
|
@@ -1284,7 +1315,9 @@ mask's own path and hash. See the [refusal ledger](#EXTERNAL_RECEIPT_ARGUMENT).
|
|
|
1284
1315
|
### Edited rig-space parts (`assemble.edited_parts`, issue #1278)
|
|
1285
1316
|
|
|
1286
1317
|
Use this block for a PNG edited at the exact crop and scale written by
|
|
1287
|
-
`assemble`, such as an alpha edge retouch.
|
|
1318
|
+
`assemble`, such as an alpha edge retouch. An in-place overwrite of an emitted
|
|
1319
|
+
`parts/<name>.png` is refused by `rig` (`RIG_PNG_MATCHES_OPAQUE_PX`); edit
|
|
1320
|
+
through `edited-part`. Author-made run-space layers and
|
|
1288
1321
|
`assemble.editor_receipts` keep their existing behavior; a receipt ledger
|
|
1289
1322
|
alone does not apply a replacement.
|
|
1290
1323
|
|
|
@@ -1392,6 +1425,7 @@ counts relative to the normal assembled PNG:
|
|
|
1392
1425
|
| `changed_counted_px` | Changed positions whose final alpha is above 8. |
|
|
1393
1426
|
| `changed_excluded_px` | Changed positions whose final alpha is at most 8, including deletions. Together with `changed_counted_px`, sums to `changed_px`. |
|
|
1394
1427
|
| `removed_opaque_px` | Positions whose baseline alpha was above 8 and final alpha is at most 8; a subset of `changed_excluded_px`. |
|
|
1428
|
+
| `removed_opaque_regions` | Where those removed positions are (issue #1383): one `{box: [x, y, w, h], px}` per 8-connected region of removed positions, the box in the part PNG's own pixels and `px` the removed positions inside it. The `px` values sum to `removed_opaque_px`; entries are sorted by `y`, `x`, `h`, `w`, `px`. Written only when `removed_opaque_px` is above 0, so an edit that removes nothing keeps its bytes. |
|
|
1395
1429
|
|
|
1396
1430
|
The existing value partition is preserved:
|
|
1397
1431
|
`unchanged_layer_px + hand_px + automatic_px = opaque_px`. `hand_px` counts
|
|
@@ -1406,6 +1440,34 @@ final-alpha partition and resolve replacement writer IDs through the sidecar's
|
|
|
1406
1440
|
receipt-associated; this does not exempt other config shapes or baseline
|
|
1407
1441
|
inputs from their existing source/receipt checks.
|
|
1408
1442
|
|
|
1443
|
+
#### Outline specks at an ownership boundary (issue #1383)
|
|
1444
|
+
|
|
1445
|
+
Projection by ownership can carry fragments of the painting's outline into a
|
|
1446
|
+
part along the edge where another part was visible: dark specks a part should
|
|
1447
|
+
not hold. Parts does not remove them. No assemble option, projection rule or
|
|
1448
|
+
filter decides which pixels are outline, because at the same boundary an
|
|
1449
|
+
outline fragment and real painting detail look alike, and a wrong deletion
|
|
1450
|
+
would be silent. The route is an image-editor edit with a receipt:
|
|
1451
|
+
|
|
1452
|
+
1. Assemble, and keep the manifest (`parts.json`).
|
|
1453
|
+
2. Edit the part PNG written by that assembly in an image editor: erase the
|
|
1454
|
+
specks (alpha 0) and keep the crop and size.
|
|
1455
|
+
3. Write the receipt with `rig-parts edited-part --config <config> --parts
|
|
1456
|
+
<parts.json> --part <name> --file <edited.png> --from <assembled.png>
|
|
1457
|
+
--editor <text>` (or `--producer <json>`).
|
|
1458
|
+
4. Rebuild (`assemble` or `build`) from the config that holds the receipt.
|
|
1459
|
+
|
|
1460
|
+
The rebuilt part is the edited file. An edited file whose bytes do not match
|
|
1461
|
+
its receipt is refused (`ASSEMBLE_EDITED_PART_SHA256`), and a file with no
|
|
1462
|
+
receipt row is never read, whether or not `editor_receipts.required` is set.
|
|
1463
|
+
A reviewer reads the part's `provenance.edited_part` in `parts.json`: the
|
|
1464
|
+
receipt names the editor and both file hashes, `removed_opaque_px` counts the
|
|
1465
|
+
erased opaque pixels, and `removed_opaque_regions` gives a box and a count for
|
|
1466
|
+
each connected group of them, so every removed speck can be found in the part
|
|
1467
|
+
PNG. With `assemble.stage_map`, `stage-map.json` carries the same record.
|
|
1468
|
+
Overwriting a written `parts/<name>.png` in place, without the receipt and a
|
|
1469
|
+
rebuild, is not this route: nothing records it.
|
|
1470
|
+
|
|
1409
1471
|
At admission, `assemble` also prints an `edited part front colour:` measurement
|
|
1410
1472
|
line for each receipted part (issue #1290): surviving pixels (`alpha > 8`) that
|
|
1411
1473
|
the edit changed or added against the base part (`from_sha256`), where the
|
|
@@ -3039,7 +3101,9 @@ issue #320). [`examples/reference-sample`](https://github.com/rig-c/parts/tree/m
|
|
|
3039
3101
|
[check] beside the idle: 1 animation(s), hop — built and gated by rigc with the rig; ANIMATIONS_DO_NOT_FOLD reads each for folds, every other bar here reads the idle
|
|
3040
3102
|
[check] ANIMATIONS_DO_NOT_FOLD: PASS — 2 animation(s) read by rigc render --folds at 12 fps, with its 2 physics constraint(s) on and off (idle, hop): 0 folding mesh(es), 0 not declared in may_fold (<= 0)
|
|
3041
3103
|
[check] STRESS_OFF_CHAIN: SKIP — "sleeves": its weights ride 2 chains ("sleeve_r0_ctl", "sleeve_l0_ctl"): turning one stretches the part toward the other by construction; a part riding one chain is read until a limbs block names each limb
|
|
3042
|
-
[check]
|
|
3104
|
+
[check] PHYSICS_CONTRIBUTES: WARN — 2 part(s) under physics posed with physics on and off (49 frame(s) at 12 fps, core poser, rig-c's default environment): 1 of them read 0 — 1 warning(s), never a bar; off is the same compiled build posed with the poser's physics off (spine-core Physics.none, rig-c physicsMode 'off') over the same frames — not the rig spec with its physics constraints stripped and built again
|
|
3105
|
+
[check] WARN PHYSICS_CONTRIBUTES: part "bottomwear" is under physics constraint(s) "hip_phys" and reads 0 over 48 frame(s): none of its 324 art vertices is moved by physics on the idle; physics moves a part through its constraints' inertia (how much of its carrier's motion it takes up), wind and gravity (a force from the world) and mix, and only while something moves its carrier or the world pushes it
|
|
3106
|
+
[check] check: PASS; 10 of 11 bar(s) measured, 1 skipped (STRESS_OFF_CHAIN); 2 warning(s) (CLOTH_SETTLES, PHYSICS_CONTRIBUTES, not a bar)
|
|
3043
3107
|
```
|
|
3044
3108
|
|
|
3045
3109
|
A bone the rig lacks is rigc's refusal at the rig stage, in rigc's words (`RIG_RIGC_GREEN`); a
|
|
@@ -3867,6 +3931,27 @@ missing pivot is refused by name; legacy `depth_median` is never converted to
|
|
|
3867
3931
|
world units. Other proposal modes (`--keypoints`, `--compare`, `--grid-rule`,
|
|
3868
3932
|
`--only-missing`) must run separately and are refused in this mode.
|
|
3869
3933
|
|
|
3934
|
+
**The chest on such a config (issue #1436).** With `--bust-landmarks <file>` or
|
|
3935
|
+
`--no-bust "<reason>"` and without `--full` and `--head`, `propose --write-config`
|
|
3936
|
+
on this config is the chest-only write:
|
|
3937
|
+
|
|
3938
|
+
```sh
|
|
3939
|
+
rig-parts propose --parts neck-draft/rig --source painting.png --out chest/ --write-config config.json --bust-landmarks landmarks.json
|
|
3940
|
+
```
|
|
3941
|
+
|
|
3942
|
+
It writes the chest carrier's `meshes.<part>.contour.bust` (the three points,
|
|
3943
|
+
the shape fields the config declares, and a pending shape from the record) and
|
|
3944
|
+
the bones `boob_r` / `boob_l` under `chest` at the apices, and no other entry:
|
|
3945
|
+
the neck draft, `turn`, `assemble`, `regions` and `motion` keep their bytes.
|
|
3946
|
+
`--no-bust` removes the two where present. The record beside the landmarks file
|
|
3947
|
+
is checked and marked applied as on the ordinary route. A file without
|
|
3948
|
+
`cleavage` has it derived at the crossing of the apex segment and the config's
|
|
3949
|
+
own `neck` -> `hip` midline (the config is the record; a fresh draft's midline
|
|
3950
|
+
is not read), and the printed `propose: chest-only write …` line and the
|
|
3951
|
+
proposal's torso note say which source it came from. The carrier must already
|
|
3952
|
+
be a contour mesh (`PROPOSE_BUST_CARRIER_MESH`); the chest flags with `--full` or
|
|
3953
|
+
`--head` are refused as `PROPOSE_NECK_MODE`, naming this command.
|
|
3954
|
+
|
|
3870
3955
|
| rule | means | change |
|
|
3871
3956
|
| --- | --- | --- |
|
|
3872
3957
|
| <a id="PROPOSE_TORSO_ISLAND_LEFT_OUT"></a>`PROPOSE_TORSO_ISLAND_LEFT_OUT` | WARN: a non-dust island smaller than one drafted sampling cell is omitted; names its art px and rig-pixel box | inspect the omitted art; separate it if it needs its own mesh; `contour.stray` records the largest omitted island |
|
|
@@ -3885,7 +3970,8 @@ world units. Other proposal modes (`--keypoints`, `--compare`, `--grid-rule`,
|
|
|
3885
3970
|
| <a id="PROPOSE_NECK_REASSEMBLY"></a>`PROPOSE_NECK_REASSEMBLY` | neck structural operations or alternate sets require separate assembly | follow this recipe and supply the named input; the refusal writes no config |
|
|
3886
3971
|
| <a id="PROPOSE_NECK_RUNS"></a>`PROPOSE_NECK_RUNS` | full/head runs not both supplied | follow this recipe and supply the named input; the refusal writes no config |
|
|
3887
3972
|
| <a id="PROPOSE_NECK_OUT_FRESH"></a>`PROPOSE_NECK_OUT_FRESH` | output rig directory already exists or aliases input parts | choose a fresh output directory |
|
|
3888
|
-
| <a id="PROPOSE_NECK_MODE"></a>`PROPOSE_NECK_MODE` | incompatible proposal mode requested | follow this recipe and supply the named input; the refusal writes no config |
|
|
3973
|
+
| <a id="PROPOSE_NECK_MODE"></a>`PROPOSE_NECK_MODE` | incompatible proposal mode requested, or the chest flags given with `--full` / `--head` | follow this recipe and supply the named input; write the chest with the chest-only command the detail names, without `--full` and `--head`; the refusal writes no config |
|
|
3974
|
+
| <a id="PROPOSE_BUST_CARRIER_MESH"></a>`PROPOSE_BUST_CARRIER_MESH` | the chest-only write on a sampled body-turn neck config found the chest carrier's config mesh is not a contour (names the mesh mode found) | draft the torso with `propose … --write-config <config> --no-bust "<reason>"` before `turn.body` is written, then write `turn.body` and draft the neck; the refusal writes nothing |
|
|
3889
3975
|
|
|
3890
3976
|
Build through the normal gate, then use `rigc render --extremes` (requires
|
|
3891
3977
|
`@rig-c/core` 2.81.0 or later) on `body_turn`, `turn` and `tilt`. Read setup, min,
|
|
@@ -3991,7 +4077,7 @@ step-up method below.
|
|
|
3991
4077
|
| `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. |
|
|
3992
4078
|
| 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. |
|
|
3993
4079
|
| 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. |
|
|
3994
|
-
| 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). |
|
|
4080
|
+
| 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 — `PHYSICS_CONTRIBUTES` reports what physics adds to each sleeve over the same build posed with physics off, and warns on a 0. 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). |
|
|
3995
4081
|
| 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`. |
|
|
3996
4082
|
| 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. |
|
|
3997
4083
|
|
|
@@ -4768,7 +4854,7 @@ that check the manifest against a config refuse a stale digest as
|
|
|
4768
4854
|
| `propose` | `note:` lines, `LINT` lines, the `coverage` lines, `landmarks.png`, `basis.json` | no LINT line: every chain link lies on its mesh's art, and the hip is below the chest and the figure's top quarter; the `coverage:` summary says how many bones that verdict covers — a `not checked` bone was read by no check (its line says why), and a `ratio` or `fallback` bone in `basis.json` is a guess | a link off the art (a bone on the background) — move it onto the layer; `LINT <link> at … runs to … N degrees off the head's down axis …` — a fringe link that does not lean with the head (§3, the fringe in the head's frame): move it along the lock it drives; `LINT <bone> under <parent>: amplitude <a> below the link above's <b> in the keyed chain …` — under `--cloth`, a keyed sibling the recipe left the only keyed child of its parent, which `CHAIN_LAG` would refuse (issue #572, §3 *A keyed sibling left behind*): raise the field it names to `<b>` or more in size; `LINT hairback_… on mesh '<part>' (side <r\|l>): <N> tree(s) for <M> visible hair mass(es) (mass 0 columns x=<minX>..<maxX>, y=<minY>..<maxY>; …)` — back-hair cloth trees whose count does not match the side's visible hair masses (`max(1, floor(w / (4 * grid)) + 1)` per mass) or whose link or tip leaves its mass's column range (issues #445, #461): omit `chains` on `cloth."back hair"` or draft trees per visible hair mass inside its columns; `LINT <a_limb> and <b_limb> on <part> (<from>) cross at [x, y] with no per-limb split: …` — two limbs sharing one layer cross in an X without a per-limb split (issue #446): declare `config.limbs.<covering>.split` (`{ "line": [[x, y], …] }` or `{ "edge": "painting" }`, §3 *Which limb*); `LINT foot_<s> at [x, y], the <s>_ankle joint and leg_<s>1's tip, lies on none of leg_<s>'s art within 1 px along its joint line (the nearest of it on that line is the pixel [x, y], D px from the joint): …` — an ankle keypoint off its leg's art on the line `assemble` sizes the ankle's cap by (issue #517): `propose` drafts every leg without its ankle cut, the shoe layer stays one part, and nothing is moved onto the art; move that ankle keypoint onto the leg's or the shoe's art and re-run `propose` (`(the line crosses none of it)` when no art lies on that line at all); `LINT stop on <chain> (<firstLink> at [x0, y0]) against <against> (at [ax, ay]) places <chain>_touch at [tx, ty], above <firstLink>'s root (rest R deg, \|rest\| + outward B deg): …` — a stop's contact point `<chain>_touch` lies above `links[0]`'s root in rig px or pushes `\|rest\| + outward` past `180°` (issue #447, §2 `stops`): stop against the descending limb bone below `firstLink`, set `links` to start at a link below `<chain>_touch`, or omit the stop on a rising limb; `LINT hip at [x, y] is not below chest at [x, y]: …` or `LINT hip at [x, y] is above 0.25 of the figure height (figure y T..B, so hip y must be at least L): a hip at the shoulders` — move `hip` down to the waist (and `chest` between it and the neck); a `hanging strand … -- no chain proposed` note — that strand hangs stiff until you add a chain down the x and rows it names (§3); a `no blink: …` or `blink without brows: …` note — the idle will not blink (or its brows will not drop), because no part came from an `eyewhite` (or `eyebrow`) layer; the note names the tags looked for; a `no eyewhite part for eye_<s> …` note — the iris and lash parts it names ride `head` and do not blink, because no `eyewhite-<s>` part made that side's eye bone: take the eyewhite from the other run, or keep them on `head`; a `no face part: face box derived from …` note (always the first) — `head`, `neck` and every face-height scale come from a box guessed off the hair and neck (§3): check `head` and `neck` on `landmarks_head.png` and move them; when it adds `the blink shuts the eyes over no face part`, read `BLINK_NO_HOLE` after `check` — an eye with no face under it can open a hole (the `reference-sample` with only its face removed: 587 px). Under `--keypoints`: the `lint rule set:` line first (joints, or screen and why), then the joint notes — `missing: the rule "…" placed bone X instead` is a bone still guessed; `not used — …` names why an arm's joints did not place its sleeve (for a wrist on no part, the nearest part and the `--wrist-snap` that would bind it); a `wrist snap: …` note is a wrist bound past 15 px by the flag — check that chain's tip on `landmarks.png`; a `one handwear part holds both wrists` note is two chains on one mesh — use another layer/run first; when no separate layer exists, a structural `assemble.cuts` entry separates the independently moving arms ([Source before scissors](#source-before-scissors)); `LINT chest at … is not between the neck joint …`, `LINT hip at … is not past chest …`, `LINT hip at … is nearer the neck joint …` and `LINT <chain><i> at … does not advance from <s>_shoulder toward <s>_wrist` are the joint-frame lines: move that bone between, past or along the joints they name |
|
|
4769
4855
|
| `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 |
|
|
4770
4856
|
| `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` |
|
|
4771
|
-
| `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
|
|
4857
|
+
| `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 `PHYSICS_CONTRIBUTES` — where a part is under physics — how many parts it read against the same build posed with physics off, and one `WARN PHYSICS_CONTRIBUTES` line per part that reads exactly 0 (issue #1320, a report 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 where the rig declares a physics constraint, and `PHYSICS_CONTRIBUTES` after that where it printed a warning, and N their sum — 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) |
|
|
4772
4858
|
| `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/` |
|
|
4773
4859
|
| `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` |
|
|
4774
4860
|
| `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 |
|
|
@@ -5758,7 +5844,7 @@ See-through with another seed.
|
|
|
5758
5844
|
| <a id="CONFIG_TURN_REQUIRED"></a>`CONFIG_TURN_REQUIRED` | `motion.animations_from` carries `turn` or `tilt` `derive` keys while `config.turn` is absent, or an attached head part (`face`, `hair_front`, `hair_back`) is missing from `config.turn.depths` (issue #478): without `turn.depths` the head pivot and back-of-head counter-parallax cannot be derived | run `propose --full` (or `--head`) to draft `config.turn`, or declare `config.turn` with `pivot` and `depths` covering `face`, `hair_front` and `hair_back` |
|
|
5759
5845
|
| <a id="CONFIG_FACE_BAND_EXCEEDED"></a>`CONFIG_FACE_BAND_EXCEEDED` | `turn.band` or a `motion.animations_from` `turn`/`tilt` `derive.degrees` exceeds the single-plate rated band (`FACE_RATED_BAND`: `yaw <= 15°`, `pitch <= 12°`, issue #472) while no `assemble.alternates` entry replaces `face`; the detail gives the requested angle, the rated limit and both remedies | clamp the angle to `±15°` yaw / `±12°` pitch, or declare an `assemble.alternates` entry covering `face` for the 3/4 or profile plate |
|
|
5760
5846
|
| <a id="CONFIG_PROPOSED_RIG_SCALE"></a>`CONFIG_PROPOSED_RIG_SCALE` | `proposed_rig_scale` (the `scale_rig_per_source` `propose` drafted the rig sections at, issue #354) differs from `assemble.rig_scale`: the coordinates in `bones`, `meshes`, `limbs` and `motion` are in that rig canvas's pixels and do not scale when `assemble.rig_scale` changes | re-run `assemble` and `propose` at the new `assemble.rig_scale`, or restore `assemble.rig_scale` to `proposed_rig_scale` |
|
|
5761
|
-
| <a id="CONFIG_BUST_CLEARANCE"></a>`CONFIG_BUST_CLEARANCE` | `meshes.<part>.contour.bust`: `clearance <= 0`, `R_r + R_l >= D` where `R_s = round(d_s - clearance)` and `D = \|apex_r − apex_l\|`, a non-positive core `r_s = round(alpha × R_s)`, or a negative band `R_s − r_s`; the detail names the rounded values found | use the detail's first passing clearance on 0.01 px steps, checked against the same rounded rules (not the unrounded distance bound); if no such value exists, move `cleavage` or the apices, or change `alpha`, then retry. A larger clearance can also erase a core, so do not keep increasing it blindly |
|
|
5847
|
+
| <a id="CONFIG_BUST_CLEARANCE"></a>`CONFIG_BUST_CLEARANCE` | `meshes.<part>.contour.bust`: `clearance <= 0`, `R_r + R_l >= D` where `R_s = round(d_s - clearance)` and `D = \|apex_r − apex_l\|`, a non-positive core `r_s = round(alpha × R_s)`, or a negative band `R_s − r_s`; the detail names the rounded values found. From `propose --bust-landmarks` with a declared or pending `alpha` or `clearance`, and from `bust-landmarks`, it ends with the shape checked, each value with its source (`the config`, `the pending record` or `the default`) | use the detail's first passing clearance on 0.01 px steps, checked against the same rounded rules (not the unrounded distance bound); if no such value exists, move `cleavage` or the apices, or change `alpha`, then retry. A larger clearance can also erase a core, so do not keep increasing it blindly |
|
|
5762
5848
|
| <a id="CONFIG_SET_COVERS_SLOT"></a>`CONFIG_SET_COVERS_SLOT` | `motion.animations_from` (issue #473): a track key carries `"set": "<name>" \| null` on a track other than `property: "attachment"`, names an alternate set not declared in `assemble.alternates`, or names an alternate set that does not cover the track's `slot` (neither in `slots` nor in `hides`); the detail names the set, the slot and the slots that set covers | declare the set in `assemble.alternates`, add the slot to that set's `parts` (or `hides`), or key `"set"` on a slot the set covers |
|
|
5763
5849
|
| <a id="CONFIG_SET_COVERS_BONE"></a>`CONFIG_SET_COVERS_BONE` | `assemble.alternates[i].drawn.<bone>` (issue #476): a subset set (`parts` present) states a `drawn` world angle for a bone none of its covered parts ride; the detail names the bone, the set, and the bones its covered parts ride | remove the uncovered bone from that set's `drawn`, or add the part that rides it to `parts` |
|
|
5764
5850
|
| <a id="CONFIG_LIMB_SET_JOINTS"></a>`CONFIG_LIMB_SET_JOINTS` | `assemble.alternates[i]` (issue #476): a gesture set over a limb chain declared in `config.limbs.<limb>` names the unsplit `from` layer instead of the limb's segment `part`s, covers (or hides) only a subset of the limb chain's segments, or declares custom polygon `cuts` on the limb; the detail names the limb and its segment parts | cover all segment `part`s of `config.limbs.<limb>` in `parts` with no custom `cuts`, so `assemble` cuts the set at the base's joints |
|
|
@@ -6200,6 +6286,7 @@ recorded transform. The record fields and sampling formula are specified in
|
|
|
6200
6286
|
| --- | --- | --- |
|
|
6201
6287
|
| <a id="RIG_PART_PRESENT"></a><a id="RIG_PART_ATTACHED"></a>`RIG_PART_PRESENT`, `RIG_PART_ATTACHED` | a `meshes`/`regions` key that is not in `parts.json`, a part with neither, or a `painting:` part with a mesh | the config and the plan must name the same parts; a patch is a region. A `drape_<s>` or `hand_<s>` from `full:drape-<s>` / `full:hand-<s>` is the 1.37.0 arm split's (issue #490), new to a config proposed before it: the detail names [MIGRATION](MIGRATION.md#after-1370-merged-arm-layers-are-split-issue-490), whose remedy is `propose … --write-config <config> --only-missing` (the two plan rows and the two entries) |
|
|
6202
6288
|
| <a id="RIG_PNG_PRESENT"></a><a id="RIG_PNG_MATCHES_BOX"></a><a id="RIG_PART_HAS_ART"></a>`RIG_PNG_PRESENT`, `RIG_PNG_MATCHES_BOX`, `RIG_PART_HAS_ART` | a part's PNG is missing, the wrong size, or has no art pixel | re-run assemble |
|
|
6289
|
+
| <a id="RIG_PNG_MATCHES_OPAQUE_PX"></a>`RIG_PNG_MATCHES_OPAQUE_PX` | a part's `parts/<name>.png` has a different opaque pixel count (`alpha > 8`) than `parts.json` records as `opaque_px` (for example after an in-place overwrite of an emitted part PNG) | re-run assemble, or record the part replacement through `edited-part` (`assemble.edited_parts`) and re-run assemble |
|
|
6203
6290
|
| <a id="RIG_NAME_RESOLVES"></a><a id="RIG_SEGMENT_DEFINED"></a><a id="RIG_CHAIN_POINTS"></a>`RIG_NAME_RESOLVES`, `RIG_SEGMENT_DEFINED`, `RIG_CHAIN_POINTS` | a segment names an undeclared bone, a bone with no `tip` and no next link, or a chain too short to make a link | that bone's `tip`, or write the segment out as `[bone, [x0,y0], [x1,y1]]` |
|
|
6204
6291
|
| <a id="RIG_INFLUENCES_KEPT"></a>`RIG_INFLUENCES_KEPT` | a mesh's declared `influences` leaves a vertex with no bone: every capped share is under 0.03 (at or under it, for the continuous floor). The largest of k shares is at least 1/k, so this needs 34 or more kept bones; the default cap of 4 never reaches it (issue #284). The detail names the first vertex, how many more, and its largest share | declare `maxInfluences` 33 or less, or name fewer bones in `segments` |
|
|
6205
6292
|
| <a id="RIG_LATTICE_STATION"></a>`RIG_LATTICE_STATION` | a requested lattice subdivision row is not finite | supply finite source-image row coordinates |
|
|
@@ -6572,11 +6659,12 @@ outside the consumed inputs pending [#1177](https://github.com/rig-c/parts/issue
|
|
|
6572
6659
|
| <a id="CHECK_MOTION_SEAM_ROOT"></a>`CHECK_MOTION_SEAM_ROOT` | a body-root declaration has missing or ambiguous segment0, bone, parent, slot or default-skin attachment; the refusal names the part and candidates | supply the declared one-to-one hierarchy/slot/provenance binding; no nearest or mesh-influence fallback |
|
|
6573
6660
|
| <a id="CHECK_SEAM_OVER_MOTION"></a>`CHECK_SEAM_OVER_MOTION` | a proven body-root pair has an active animation gapOpen plus UNDER-owned ghost above the unchanged one-cell floor; the refusal names pair, animation, frame, cells, cell size and world box | [Source before scissors](#source-before-scissors) first; repair the declared rest overlap or authored motion; the existing internal-joint warning policy and physics reference worlds are unchanged |
|
|
6574
6661
|
| <a id="CHECK_SEAM_OVER_MOTION_REQUIRED"></a>`CHECK_SEAM_OVER_MOTION_REQUIRED` | the requirements file declares `seam_over_motion.required: true` (issue #941; [Background over every frame](#background-over-every-frame-issue-941)) and a declared seam pair — body-root, internal-joint or explicit — shows background on a frame: rigc's `gapOpen` (a gap cell inside the carried setup-overlap band where the whole skeleton composite has alpha 0) above 0 on any frame of any animation `motion.json` holds, every frame at 12 fps, no floor. The refusal names the class, the pair, the animation, the worst frame and its time, the frames that open, the cells found, the cell size and the world box, against 0 required. Also refused under the declaration, since a SKIP is never a pass: `SEAM_OVER_MOTION` itself a SKIP (no pair or no animation to read), a pair naming a slot `rig.json` lacks, or a pair and animation rigc read no band in | the art or the motion, by the file the refusal points at: [Source before scissors](#source-before-scissors) first — the layer that holds the pixels under the joint (`config.assemble`, `extend_painting`); then the joint's cap (`config.limbs`, *Limbs: cut at their joints*), or the keys that pull the pieces apart (`motion.json` through `config.motion` or the animations file `animations_from` names). For a SKIP, declare the pairs (`config.limbs`, `config.motion_seams`, a `--requirements` `seam`) or drop the declaration from the requirements file. For a `figure` gapOpen classification, declare `assemble.require_hidden_extent: [{part, occluder}]` to learn whether the original layer carries the enclosed hidden extent. See [Original hidden extent required](#original-hidden-extent-required). |
|
|
6575
|
-
| <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
|
|
6662
|
+
| <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 where that read a pair, `PHYSICS_CONTRIBUTES` after it where that printed a warning, and N their sum). 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 |
|
|
6663
|
+
| <a id="PHYSICS_CONTRIBUTES"></a>`PHYSICS_CONTRIBUTES` | **a report, never a refusal and never a bar** (issue #1320: no threshold is derivable, so nothing is judged). A part is **under physics** when a bone it is bound to (its attachment's bones, or its slot's bone) is a bone a physics constraint names (`rig.json`'s `constraints` or `motion.json`'s `physics`), a bone under one, or a bone a transform constraint moves from one of those. Each such part is posed on the idle with physics on and with physics **off** — the same compiled build posed with the poser's physics off (spine-core `Physics.none`, rig-c `physicsMode: 'off'`) over the same frames, not the rig spec with its physics constraints left out and built again, which is what the fold bar's `physics_off` and the loop's keyed render read. Its residual at a frame is each point's displacement from frame 0 with physics on, less the same with physics off, in rig px; the points are every vertex of a rest triangle that holds a pixel centre of the part's art, and the row takes the largest per frame over frames 1..N-1, under rigc's default environment. Prints `PHYSICS_CONTRIBUTES: <status> — N part(s) under physics posed with physics on and off (<frames> frame(s) at <fps> fps, <poser> poser, rig-c's default environment)[, k of them under a constraint that declares wind or gravity]: W of them read 0 — W warning(s), never a bar; off is …` (the figures are `check.json`'s rows, not printed), then for each part that reads exactly 0, `WARN PHYSICS_CONTRIBUTES: part "<part>" is under physics constraint(s) "<constraint>", … and reads 0 over <N> frame(s): none of its <V> art vertices is moved by physics on the idle[; external force is declared on …]; physics moves a part through its constraints' inertia (how much of its carrier's motion it takes up), wind and gravity (a force from the world) and mix, and only while something moves its carrier or the world pushes it`. `check.json`'s `PHYSICS_CONTRIBUTES` holds `status` (`WARN`, `CLEAR`), `off`, `points`, `world`, `poser`, `fps`, `frames`, `warnings` and one row per part (`part`, `constraints`, `external_force` — the constraints of the part's that declare wind or gravity — then `vertices`, `frames_read`, `max_rig_px`, `p95_rig_px`, `mean_rig_px`, `max_of_diagonal`, `moves`, or `unmeasured` naming why); it moves no exit status, no `check: PASS` and no bar count, and the summary's warning clause names it only when it printed a warning. A 0 is exact: a part no physics reaches is not a row, and a part whose constraints take up none of their carrier's motion (`inertia: 0`, no wind, no gravity) reads 0.000. A non-zero figure says physics moved the art, not that it moved it enough or well: `TIP_OVER_ROOT` passes on carrier motion alone (issue #1318). **SKIP**, named: no physics constraint, no part bound to a bone one reaches, no idle, or no `parts.json` (then `check.json` has no key) — nothing measured, never a pass | if the part should answer its physics: the fields the warning names — the constraints' `inertia`, `wind` and `gravity`, `mix` — and something that moves its carrier (an idle key above the chain, or an environment at render, rig-c's AUTHORING §8.4); no value is prescribed. If the part is meant to stay put, nothing |
|
|
6576
6664
|
| <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 |
|
|
6577
6665
|
| <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` |
|
|
6578
6666
|
| <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 |
|
|
6579
|
-
| <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 |
|
|
6667
|
+
| <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 (for a retained render, a `sets[].dir` that is not one safe path segment, or two that share a case-folded folder, issue #1367), 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 |
|
|
6580
6668
|
| <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 |
|
|
6581
6669
|
| <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 |
|
|
6582
6670
|
| <a id="RENDERER_API_UNAVAILABLE"></a>`RENDERER_API_UNAVAILABLE` | the official renderer read API needed to identify a set's semantic support is unavailable | all cells remain conservatively affected; this is an informational capability reason, not an inherited-PASS proof |
|
|
@@ -9297,6 +9385,22 @@ skeleton names remain names. A selected part whose provenance records
|
|
|
9297
9385
|
to a transported scalar reference. Unselected authored units keep
|
|
9298
9386
|
their original representation. Roles and draw order stay the author's.
|
|
9299
9387
|
|
|
9388
|
+
`--groups <name>[,<name>…]` (#1449) applies only the named recipe groups with
|
|
9389
|
+
the same manifest. A left-out group's recipe parts get no new sheet and lose
|
|
9390
|
+
any depth reference they carried; their maps are not read, and its
|
|
9391
|
+
`unitDepths` and `pivot` are not written. `config.turn.body` is required only
|
|
9392
|
+
when the body group is applied. A rig config that declares the turn of a
|
|
9393
|
+
left-out group — `turn.body` for body, `turn.roles` or `turn.depths` for head —
|
|
9394
|
+
is refused as [`DEPTH_GROUP_LEFT_OUT`](#DEPTH_GROUP_LEFT_OUT), since `rig`
|
|
9395
|
+
builds a group's dial and animation from that block. An empty list, a name the
|
|
9396
|
+
recipe does not declare, or a repeated name is refused as
|
|
9397
|
+
[`DEPTH_GROUP_SELECTION`](#DEPTH_GROUP_SELECTION); every problem in the list is
|
|
9398
|
+
named at once. The report then carries `selection`, after `cleared` and before
|
|
9399
|
+
`parts`: `{"groups": [...], "leftOut": [...]}`, groups in the recipe's order and
|
|
9400
|
+
parts in `parts.json` order. `recipeSha256` and `manifestSha256` are the full
|
|
9401
|
+
recipe's. Without the flag, `selection` is absent and every output byte is
|
|
9402
|
+
unchanged.
|
|
9403
|
+
|
|
9300
9404
|
Maps are UTF-8 JSON `{"spec":"rig-parts-map/1","width":2,"height":2,
|
|
9301
9405
|
"channels":1,"data":[0.125,0.25,0.5,0.875]}`: row-major finite numeric values,
|
|
9302
9406
|
with channels interleaved for signed XYZ normals (`channels:3`). JSON is open,
|
|
@@ -9423,6 +9527,8 @@ by `rig`, so their output requires no alternate compiler or dependency pin.
|
|
|
9423
9527
|
| <a id="DEPTH_NORMAL_VECTOR"></a>`DEPTH_NORMAL_VECTOR` | a sampled support normal is zero | provide nonzero signed XYZ normals |
|
|
9424
9528
|
| <a id="DEPTH_NORMAL_CONVEXITY"></a>`DEPTH_NORMAL_CONVEXITY` | core/rim or its convexity sign is unresolved | larger closed convex mask or scalar source |
|
|
9425
9529
|
| <a id="DEPTH_GROUP_BINDING"></a>`DEPTH_GROUP_BINDING` | part outside declared turn roles, mixed retained near/zScale, or filename collision | register exact roles and one shared scale/polarity, replace/clear conflicting sheets, use distinct names |
|
|
9530
|
+
| <a id="DEPTH_GROUP_SELECTION"></a>`DEPTH_GROUP_SELECTION` | `depth-apply --groups` with an empty list, a group the recipe does not declare, or a group named twice | name each group to apply once, from the recipe's `groups` |
|
|
9531
|
+
| <a id="DEPTH_GROUP_LEFT_OUT"></a>`DEPTH_GROUP_LEFT_OUT` | `depth-apply --groups` leaves a group out while the rig config declares that group's turn (`turn.body`; `turn.roles` or `turn.depths` for head) | remove that turn block from the rig config, or name the group in `--groups` |
|
|
9426
9532
|
| <a id="DEPTH_AUTHORED_UNIT_CONFLICT"></a>`DEPTH_AUTHORED_UNIT_CONFLICT` | a selected part already records `provenance.depth.kind: "authored-unit"`; adding scalar depth would make its two representations conflict | retain the authored unit or supply an explicitly reassembled scalar-compatible input; apply never replaces the provenance automatically |
|
|
9427
9533
|
|
|
9428
9534
|
### Unit depth precedence
|
|
@@ -9810,8 +9916,8 @@ Internal `SeamSupport.drawings` never enters check JSON. Named requirement
|
|
|
9810
9916
|
<!-- check-row-table:begin -->
|
|
9811
9917
|
| Row family | Registered JSON paths | row_scope | row_kind | row_subjects (producer expression) | Producer |
|
|
9812
9918
|
| --- | --- | --- | --- | --- | --- |
|
|
9813
|
-
| `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:
|
|
9814
|
-
| `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:
|
|
9919
|
+
| `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:3711](../src/check.ts#L3711) |
|
|
9920
|
+
| `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:3673](../src/check.ts#L3673) |
|
|
9815
9921
|
| `ART_JOINT_DISTANCE.joints` | `ART_JOINT_DISTANCE.joints` | 'rig' | finding when status === 'FAIL'; otherwise evidence | [] | [artjoints.ts:86](../src/artjoints.ts#L86) |
|
|
9816
9922
|
| `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:664](../src/behindseams.ts#L664) |
|
|
9817
9923
|
| `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:750](../src/behindseams.ts#L750) |
|
|
@@ -9827,50 +9933,51 @@ Internal `SeamSupport.drawings` never enters check JSON. Named requirement
|
|
|
9827
9933
|
| `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:585](../src/behindseams.ts#L585) |
|
|
9828
9934
|
| `BOUNDARY_COLOUR_STEP.over` | `BOUNDARY_COLOUR_STEP.over` | 'pair' | finding | r.parts | [boundarycolour.ts:221](../src/boundarycolour.ts#L221) |
|
|
9829
9935
|
| `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) |
|
|
9830
|
-
| `CLOTH_SETTLES.rows` | `CLOTH_SETTLES.rows` | 'rig' | finding when speeds.length > 0 && s < speeds.length; otherwise evidence | [] | [check.ts:
|
|
9936
|
+
| `CLOTH_SETTLES.rows` | `CLOTH_SETTLES.rows` | 'rig' | finding when speeds.length > 0 && s < speeds.length; otherwise evidence | [] | [check.ts:6158](../src/check.ts#L6158) |
|
|
9831
9937
|
| `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) |
|
|
9832
|
-
| `FEET_STAY_LEVEL.feet` | `FEET_STAY_LEVEL.feet` | 'part' | finding when row.status === 'FAIL'; otherwise evidence | [row.part] | [check.ts:
|
|
9833
|
-
| `FEET_STAY_LEVEL.feet[].worst.through` | `FEET_STAY_LEVEL.feet[].worst.through` | 'rig' | evidence | [] | [check.ts:
|
|
9834
|
-
| `LIMB_ONE_BONE.parts` | `LIMB_ONE_BONE.parts` | 'part' | finding when fail; otherwise evidence | [p.name] | [check.ts:
|
|
9938
|
+
| `FEET_STAY_LEVEL.feet` | `FEET_STAY_LEVEL.feet` | 'part' | finding when row.status === 'FAIL'; otherwise evidence | [row.part] | [check.ts:3912](../src/check.ts#L3912) |
|
|
9939
|
+
| `FEET_STAY_LEVEL.feet[].worst.through` | `FEET_STAY_LEVEL.feet[].worst.through` | 'rig' | evidence | [] | [check.ts:3887](../src/check.ts#L3887) |
|
|
9940
|
+
| `LIMB_ONE_BONE.parts` | `LIMB_ONE_BONE.parts` | 'part' | finding when fail; otherwise evidence | [p.name] | [check.ts:4204](../src/check.ts#L4204) |
|
|
9835
9941
|
| `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) |
|
|
9836
9942
|
| `PART_SUPPORT_REPORT.raw_pairs` | `PART_SUPPORT_REPORT.raw_pairs` | 'pair' | evidence | [F.name, B.name] | [coincide.ts:110](../src/coincide.ts#L110) |
|
|
9837
9943
|
| `PART_SUPPORT_REPORT.unowned.regions` | `PART_SUPPORT_REPORT.unowned.regions` | 'rig' | finding | [] | [coincide.ts:145](../src/coincide.ts#L145) |
|
|
9838
|
-
| `
|
|
9839
|
-
| `SEAM_OVER_MOTION.
|
|
9840
|
-
| `SEAM_OVER_MOTION.required.pairs
|
|
9841
|
-
| `SEAM_OVER_MOTION.
|
|
9842
|
-
| `SEAM_OVER_MOTION.
|
|
9843
|
-
| `SEAM_OVER_MOTION.rows
|
|
9844
|
-
| `SEAM_OVER_MOTION.rows[].
|
|
9944
|
+
| `PHYSICS_CONTRIBUTES.rows` | `PHYSICS_CONTRIBUTES.rows` | 'part' | evidence; finding when !moves; otherwise evidence | [part] | [physicscontrib.ts:217](../src/physicscontrib.ts#L217), [physicscontrib.ts:220](../src/physicscontrib.ts#L220) |
|
|
9945
|
+
| `SEAM_OVER_MOTION.pairs` | `SEAM_OVER_MOTION.pairs` | 'pair' | evidence | [p.a, p.b] | [check.ts:5555](../src/check.ts#L5555) |
|
|
9946
|
+
| `SEAM_OVER_MOTION.required.pairs` | `SEAM_OVER_MOTION.required.pairs` | 'pair' | finding when open > 0; otherwise evidence | [p.a, p.b] | [check.ts:4874](../src/check.ts#L4874) |
|
|
9947
|
+
| `SEAM_OVER_MOTION.required.pairs[].open_frames` | `SEAM_OVER_MOTION.required.pairs[].open_frames` | 'pair' | evidence | [p.a, p.b] | [check.ts:4866](../src/check.ts#L4866) |
|
|
9948
|
+
| `SEAM_OVER_MOTION.roots.unmeasured` | `SEAM_OVER_MOTION.roots.unmeasured` | 'part' | evidence | [root.part] | [check.ts:5532](../src/check.ts#L5532) |
|
|
9949
|
+
| `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:5489](../src/check.ts#L5489), [check.ts:5561](../src/check.ts#L5561) |
|
|
9950
|
+
| `SEAM_OVER_MOTION.rows[].cells` | `SEAM_OVER_MOTION.rows[].cells` | 'pair' | evidence | [want.a, want.b] | [check.ts:5502](../src/check.ts#L5502) |
|
|
9951
|
+
| `SEAM_OVER_MOTION.rows[].joint_contact.reasons` | `SEAM_OVER_MOTION.rows[].joint_contact.reasons` | 'pair' | evidence | [want.a, want.b] | [check.ts:5492](../src/check.ts#L5492) |
|
|
9845
9952
|
| `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) |
|
|
9846
|
-
| `SEAM_OVER_MOTION.worlds.*.rows` | `SEAM_OVER_MOTION.worlds.*.rows` | 'pair' | evidence | [want.a, want.b] | [check.ts:
|
|
9847
|
-
| `SEAM_OVER_RANGE.joints` | `SEAM_OVER_RANGE.joints` | 'part' | evidence; finding when poses.some(p => p.status === 'FAIL'); otherwise evidence | [j.part] | [check.ts:
|
|
9848
|
-
| `SEAM_OVER_RANGE.joints[].poses` | `SEAM_OVER_RANGE.joints[].poses` | 'part' | finding when fail; otherwise evidence | [j.part] | [check.ts:
|
|
9953
|
+
| `SEAM_OVER_MOTION.worlds.*.rows` | `SEAM_OVER_MOTION.worlds.*.rows` | 'pair' | evidence | [want.a, want.b] | [check.ts:5486](../src/check.ts#L5486) |
|
|
9954
|
+
| `SEAM_OVER_RANGE.joints` | `SEAM_OVER_RANGE.joints` | 'part' | evidence; finding when poses.some(p => p.status === 'FAIL'); otherwise evidence | [j.part] | [check.ts:4528](../src/check.ts#L4528), [check.ts:4574](../src/check.ts#L4574) |
|
|
9955
|
+
| `SEAM_OVER_RANGE.joints[].poses` | `SEAM_OVER_RANGE.joints[].poses` | 'part' | finding when fail; otherwise evidence | [j.part] | [check.ts:4572](../src/check.ts#L4572) |
|
|
9849
9956
|
| `SETUP_MATCHES_PAINTING.regions` | `SETUP_MATCHES_PAINTING.regions` | 'rig' | finding when status === 'FAIL'; otherwise evidence | [] | [setuppainting.ts:175](../src/setuppainting.ts#L175) |
|
|
9850
9957
|
| `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) |
|
|
9851
|
-
| `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:
|
|
9852
|
-
| `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:
|
|
9853
|
-
| `STRESS_OFF_CHAIN.not_read` | `STRESS_OFF_CHAIN.not_read` | 'part' | evidence | [r.part] | [check.ts:
|
|
9854
|
-
| `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:
|
|
9855
|
-
| `STRESS_OFF_CHAIN.per_part[].off_chain` | `STRESS_OFF_CHAIN.per_part[].off_chain` | 'part' | evidence | [r.part] | [check.ts:
|
|
9856
|
-
| `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:
|
|
9857
|
-
| `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:
|
|
9858
|
-
| `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:
|
|
9859
|
-
| `WIND_BAND.pairs` | `WIND_BAND.pairs` | 'pair' | finding when !holdsAll; otherwise evidence | [p.a, p.b] | [check.ts:
|
|
9860
|
-
| `WIND_BAND.pairs[].steps` | `WIND_BAND.pairs[].steps` | 'pair' | finding when !s.holds; otherwise evidence | [p.a, p.b] | [check.ts:
|
|
9861
|
-
| `figure_openings.openings` | `figure_openings.openings` | 'pair' | finding | [ps.under, ps.above] | [check.ts:
|
|
9862
|
-
| `loop_physics` | `loop_physics` | 'rig' | evidence | [] | [check.ts:
|
|
9863
|
-
| `requirements.lines.* (bone)` | `requirements.lines.*` | 'rig' | finding when line.status === 'FAIL'; otherwise evidence | [] | [check.ts:
|
|
9864
|
-
| `requirements.lines.* (seam)` | `requirements.lines.*` | 'pair' | finding when line.status === 'FAIL'; otherwise evidence | [r.part, r.neighbour] | [check.ts:
|
|
9865
|
-
| `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:
|
|
9866
|
-
| `seam_cells.frames` | `frames` | 'pair' | evidence | [p.a, p.b] | [check.ts:
|
|
9867
|
-
| `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:
|
|
9868
|
-
| `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:
|
|
9869
|
-
| `seam_scope.changes` | `seam_scope.changes`; `sets.*.seam_scope.changes` | 'rig' | evidence | [] | [check.ts:
|
|
9870
|
-
| `seam_scope.domain.states` | `seam_scope.domain.states`; `sets.*.seam_scope.domain.states` | 'rig' | evidence | [] | [check.ts:
|
|
9871
|
-
| `seam_scope.pairs` | `seam_scope.pairs`; `sets.*.seam_scope.pairs` | subjects.length === 0 ? 'rig' : subjects.length === 1 ? 'part' : 'pair' | evidence | subjects | [check.ts:
|
|
9872
|
-
| `seam_scope.population.pairs` | `seam_scope.population.pairs`; `sets.*.seam_scope.population.pairs` | 'pair' | evidence | row.parts | [check.ts:
|
|
9873
|
-
| `seam_scope.population.single_art` | `seam_scope.population.single_art`; `sets.*.seam_scope.population.single_art` | 'part' | evidence | [row.part] | [check.ts:
|
|
9958
|
+
| `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:9317](../src/check.ts#L9317) |
|
|
9959
|
+
| `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:9303](../src/check.ts#L9303), [check.ts:9308](../src/check.ts#L9308) |
|
|
9960
|
+
| `STRESS_OFF_CHAIN.not_read` | `STRESS_OFF_CHAIN.not_read` | 'part' | evidence | [r.part] | [check.ts:4132](../src/check.ts#L4132) |
|
|
9961
|
+
| `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:4120](../src/check.ts#L4120) |
|
|
9962
|
+
| `STRESS_OFF_CHAIN.per_part[].off_chain` | `STRESS_OFF_CHAIN.per_part[].off_chain` | 'part' | evidence | [r.part] | [check.ts:4120](../src/check.ts#L4120) |
|
|
9963
|
+
| `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:4088](../src/check.ts#L4088), [check.ts:4106](../src/check.ts#L4106) |
|
|
9964
|
+
| `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:9967](../src/check.ts#L9967), [check.ts:9977](../src/check.ts#L9977) |
|
|
9965
|
+
| `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:8692](../src/check.ts#L8692), [check.ts:8697](../src/check.ts#L8697), [check.ts:8718](../src/check.ts#L8718), [check.ts:8729](../src/check.ts#L8729) |
|
|
9966
|
+
| `WIND_BAND.pairs` | `WIND_BAND.pairs` | 'pair' | finding when !holdsAll; otherwise evidence | [p.a, p.b] | [check.ts:6662](../src/check.ts#L6662) |
|
|
9967
|
+
| `WIND_BAND.pairs[].steps` | `WIND_BAND.pairs[].steps` | 'pair' | finding when !s.holds; otherwise evidence | [p.a, p.b] | [check.ts:6673](../src/check.ts#L6673) |
|
|
9968
|
+
| `figure_openings.openings` | `figure_openings.openings` | 'pair' | finding | [ps.under, ps.above] | [check.ts:5979](../src/check.ts#L5979) |
|
|
9969
|
+
| `loop_physics` | `loop_physics` | 'rig' | evidence | [] | [check.ts:7731](../src/check.ts#L7731) |
|
|
9970
|
+
| `requirements.lines.* (bone)` | `requirements.lines.*` | 'rig' | finding when line.status === 'FAIL'; otherwise evidence | [] | [check.ts:8060](../src/check.ts#L8060) |
|
|
9971
|
+
| `requirements.lines.* (seam)` | `requirements.lines.*` | 'pair' | finding when line.status === 'FAIL'; otherwise evidence | [r.part, r.neighbour] | [check.ts:8060](../src/check.ts#L8060) |
|
|
9972
|
+
| `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:8060](../src/check.ts#L8060) |
|
|
9973
|
+
| `seam_cells.frames` | `frames` | 'pair' | evidence | [p.a, p.b] | [check.ts:4863](../src/check.ts#L4863) |
|
|
9974
|
+
| `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:4823](../src/check.ts#L4823) |
|
|
9975
|
+
| `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:2558](../src/check.ts#L2558) |
|
|
9976
|
+
| `seam_scope.changes` | `seam_scope.changes`; `sets.*.seam_scope.changes` | 'rig' | evidence | [] | [check.ts:2036](../src/check.ts#L2036) |
|
|
9977
|
+
| `seam_scope.domain.states` | `seam_scope.domain.states`; `sets.*.seam_scope.domain.states` | 'rig' | evidence | [] | [check.ts:2121](../src/check.ts#L2121) |
|
|
9978
|
+
| `seam_scope.pairs` | `seam_scope.pairs`; `sets.*.seam_scope.pairs` | subjects.length === 0 ? 'rig' : subjects.length === 1 ? 'part' : 'pair' | evidence | subjects | [check.ts:7590](../src/check.ts#L7590) |
|
|
9979
|
+
| `seam_scope.population.pairs` | `seam_scope.population.pairs`; `sets.*.seam_scope.population.pairs` | 'pair' | evidence | row.parts | [check.ts:2492](../src/check.ts#L2492) |
|
|
9980
|
+
| `seam_scope.population.single_art` | `seam_scope.population.single_art`; `sets.*.seam_scope.population.single_art` | 'part' | evidence | [row.part] | [check.ts:2493](../src/check.ts#L2493) |
|
|
9874
9981
|
|
|
9875
9982
|
| Open serialized type path | Reason for schema exclusion |
|
|
9876
9983
|
| --- | --- |
|
package/docs/DEPTH.md
CHANGED
|
@@ -199,6 +199,23 @@ in `work/rig` or your original config is touched. Any mismatch — a recipe edit
|
|
|
199
199
|
after prepare, a part that moved, a map of the wrong size, a part your
|
|
200
200
|
`turn.roles` does not name — is refused by name before a byte is written.
|
|
201
201
|
|
|
202
|
+
**Apply only some groups.** A recipe prepared with a head and a body group
|
|
203
|
+
can answer for the head alone, with the same manifest and no new inference:
|
|
204
|
+
|
|
205
|
+
```sh
|
|
206
|
+
rig-parts depth-apply --parts work/rig --manifest inference/manifest.json --config depth.json --rig-config head-config.json --out mapped-head --groups head
|
|
207
|
+
```
|
|
208
|
+
|
|
209
|
+
Only the named groups' parts get sheets. A left-out group's parts keep their
|
|
210
|
+
art and lose any sheet they had, so nothing stale is carried into the rig,
|
|
211
|
+
and their maps are not read. `config.turn.body` is required only when the
|
|
212
|
+
body group is applied; a rig config that still declares the turn of a group
|
|
213
|
+
left out (`turn.body` for body, `turn.roles` or `turn.depths` for head) is
|
|
214
|
+
refused, because the rig builds a turn from that block and not from the
|
|
215
|
+
sheets. `depth-report.json` records the run under `selection`: the groups
|
|
216
|
+
applied and the parts left out. The recipe and manifest hashes stay those of
|
|
217
|
+
the full recipe.
|
|
218
|
+
|
|
202
219
|
### 5. Rig, and look
|
|
203
220
|
|
|
204
221
|
```sh
|
|
@@ -209,7 +226,8 @@ The rig stage is the ordinary one. With `turn.roles` declared it builds the
|
|
|
209
226
|
depth-sampled turn: `surface` parts become grids that bend with their sheets,
|
|
210
227
|
`unit` parts ride a carrier at their own depth, and the motion gains `turn` and
|
|
211
228
|
`tilt` animations driven by `yaw_dial` and `pitch_dial` (a body group adds
|
|
212
|
-
`
|
|
229
|
+
a `body_turn` animation and its dial, `body_yaw_dial` unless
|
|
230
|
+
`turn.body.slider` names another). On the check fixture above the compiled motion carried
|
|
213
231
|
`idle`, `tilt` and `turn`, and the bones `faceshift`, `face_surface`,
|
|
214
232
|
`yaw_dial` and `pitch_dial` beside the head. It also writes
|
|
215
233
|
`depth_sheets.json`, which names every sheet the build consumed. rig-c's gate
|
|
@@ -228,7 +246,9 @@ rigc build --rig candidate/rig.json --motion candidate/motion.json --out built -
|
|
|
228
246
|
```
|
|
229
247
|
|
|
230
248
|
The motion comes out with `turn`, `tilt` and `body_turn`, and the rig with
|
|
231
|
-
`yaw_dial`, `pitch_dial` and `body_dial
|
|
249
|
+
`yaw_dial`, `pitch_dial` and `body_dial` (the name `look/config.json` gives
|
|
250
|
+
the body dial in `turn.body.slider`; without it the dial is `body_yaw_dial`), so
|
|
251
|
+
`look/config.json` is also a worked
|
|
232
252
|
`turn.roles` to start your own from. To try the per-part route, run
|
|
233
253
|
`depth-prepare` on `assembled/rig` with a recipe like the one above. From step 2
|
|
234
254
|
on, the maps are your model's.
|