agent (cont.)

+0:13
  • read_file{"Path":"~/context/lowmarch.md"}

    input

    {
      "Path": "~/context/lowmarch.md"
    }

    result, 518 lines

    Showing lines 1-517 of 517
    1: # lowmarch (handoff, 2026-10-30)
    2: 
    3: Tab: personal/lowmarch. Repo: ~/Projects/lowmarch (local git, no remote; 32 commits, 2026-10-08 to 10-13; tree clean).
    4: The deepest context is the old severian-dev session 16fadb50 (10-07 to 10-13). Read `docs/portrait-guide.md` first
    5: (31 numbered lessons, each with what the owner asked and what changed).
    6: **Since 11-08, start at `docs/handbook.md` instead:** it marks each rule earned or guessed, and has the first-session kit (`tools/session/`, `review/frame/`). `docs/map.md` and
    7: `docs/todos-2026-11-08.md` hold the housekeeping.
    8: 
    9: ## What it is
    10: 
    11: The character art pipeline for Lowmarch, a tactics game. The battle scenes aim at Unicorn Overlord's style, and
    12: FE8 (GBA) portraits are kept as a second renderer. Characters are built by code, not modelled by hand:
    13: - VRoid models as bases: the CC0 bodies, plus the 26 AvatarSample faces and their hair (`docs/vroid.md`);
    14: - bodies reshaped by MakeHuman references;
    15: - costumes, plate armour and hair kits generated and fitted in code;
    16: - everything drawn by our own numpy rasterizer (`tools/vrm.py`). Deps: numpy and PIL only.
    17: 
    18: **Blender is not in the pipeline.** One spike used a portable Blender 4.5 to export Blender Studio base meshes
    19: (`docs/quaternius.md`). Blender 5.2.3 at ~/.local/opt is unused by lowmarch so far.
    20: 
    21: **The pixel renderer is abandoned (owner, 2026-10-30).** The armory's painted renderer (`review/vroid-02/index.html`)
    22: is the target. `tools/vroid_portrait.py` stays because the build uses its Portrait class, but nothing new is ported
    23: to its pixel path.
    24: 
    25: **Every camera is orthographic:**
    26: - the pixel and painted renderers project with a scale and no depth divide (`tools/vroid_portrait.py:730-734`);
    27: - every review page uses three.js `OrthographicCamera` (`review/out/*/site/index.html`).
    28: 
    29: Data lives outside the repo, in `~/.local/share/lowmarch/`: vroid, makehuman, quaternius, anthro, refs and
    30: blender-base-meshes. The FE8 refs are study only: never trace or ship them (`docs/study.md`).
    31: 
    32: ## How far it got
    33: 
    34: - **10-07:** the FE8 portrait study, which set the house style. The 96x80 portrait goes through `tools/pix.py` and
    35:   `vroid_portrait.py`.
    36: - **10-08:** the following were built:
    37:   - Aldric (frozen at viewer v9, now retired as a study) and Elaine;
    38:   - a Saber benchmark (study only, never for the game);
    39:   - the costume, outline-plate and hair kits, and common enemies;
    40:   - a two-character sword bind, and a painted renderer next to the pixel one;
    41:   - browser review pages that show the 3D model and both renders.
    42: - **10-09:** a base spike tried MakeHuman, Quaternius and Blender Studio meshes. VRoid bodies shaped by MakeHuman
    43:   won. VRoid Studio on the Windows side is driven from WSL (`tools/winvroid`).
    44: - **Armory v1 to v12.1 (10-09 to 10-13):** 14 T-posed bodies (`arm_m_*`, `arm_f_*`):
    45:   - proportions are held by code (`docs/proportions.md`), and bodies are read against NHANES and ANSUR
    46:     (`docs/anthro.md`);
    47:   - the heroic man and sexy woman lines, real hands and breast spring bones;
    48:   - v9 and v10: heads from VRoid sample faces, blended by look;
    49:   - v11: VRoid hair with spring physics;
    50:   - v12: collision spheres fitted to each body's skin;
    51:   - v12.1: a fix to the face-blend order.
    52: - **The owner's last verdicts:** bodies "look perfect" (10-12). Faces were "too sharp" at some angles. That fault was
    53:   our ratio fitter, so v10 keeps faces as VRoid built them (lesson 30).
    54: 
    55: ## How to run
    56: 
    57: These commands come from the tools' docstrings; none was re-run this session.
    58: - `python3 tools/vroid_portrait.py MODEL.vrm --yaw 35 --png out.png --scale 6` renders one portrait.
    59: - `LOWMARCH_SITE=armory python3 review/vroid-02/build.py` builds the armory page. Output goes to
    60:   `review/out/armory/site/`. The models are base64 GLBs, `{"glb": ...}` in `<name>.glb.json`.
    61: - Without `LOWMARCH_SITE`, the same command builds the cast viewer (vroid-02): Aldric, Elaine, Saber, the mobs and
    62:   the duel. Other sites: `mh-workshop`, `base-spike`.
    63: - `python3 tools/cage.py [NAME...]` builds armory bodies, and `python3 tools/heads.py BASE SAMPLE` builds one head.
    64: - `python3 tools/regress.py NAME [TAG]` diffs a build's geometry against the last published version.
    65: - `python3 tools/winvroid/winvroid.py bases|samples` drives VRoid Studio on Windows. It takes over the PC, so it needs
    66:   the owner's go.
    67: 
    68: ## Open threads
    69: 
    70: - **VRoid driver blocked:** `tools/winvroid`'s rebuilt V.dll is refused by Windows application control. The owner
    71:   must allow it before the driver works (`docs/vroid.md`, face session).
    72: - **Faces:**
    73:   - all 26 samples are young. A mature or sultry face needs VRoid's editor (the "option 2" session, done with the
    74:     owner away from the PC).
    75:   - The first try, `faces/face_sexy.vrm`, read cute and was set aside. Next time, start from preset 3 or 5.
    76: - **Not started:**
    77:   - the neck, which waits on the head work;
    78:   - a second armour pass (Aldric is retired);
    79:   - Unicorn Overlord-style battle animation, map sprites and fabric textures.
    80: - **Sortie** (severian-dev/sortie, tab of 10-28) borrows lowmarch VRoid bodies for its pilots. See memory
    81:   project_sortie_mech_game.
    82: 
    83: ## Research: the "flat lattice" Blender extension (2026-10-30)
    84: 
    85: **Short answer:**
    86: - **It exists, twice:** "Flattice" (flat + lattice) is the name of two unrelated add-ons. Both build a lattice aimed
    87:   at the camera, and a shape key on it squashes the mesh along the view axis. That is a per-object longer lens: the
    88:   near parts of the face (nose, cheeks) stop looming. The rumor is almost certainly DillonGoo's, which is made for
    89:   faces and went on sale this week.
    90: - **Not worth trying for lowmarch:** our cameras are orthographic, so there is no lens distortion to remove.
    91: - **Where it could help:** sortie's perspective close-ups. There the trick is a few lines of shader or numpy, not a
    92:   Blender add-on.
    93: 
    94: ### The two Flattices
    95: 
    96: | | Flattice: Stylized Flattener | Flattice |
    97: |---|---|---|
    98: | Author | Dillon Goo (DillonGoo Studios, who make Goo Engine) [1][2] | Merlin Perry [5] |
    99: | Where | Superhive [1], Gumroad [3], linked from the studio's add-ons page [4] | Blender Extensions platform [5], GitHub (README and licence only, no source) [6] |
    100: | Price | $2 [1][3] | free [5] |
    101: | Version | not stated [1] | 1.0.8, 2026-08-14 (first release 1.0.6, 2026-07-30) [7] |
    102: | Blender | 3.6 to 5.1 in the text, 3.6 to 5.2 in the table; Goo Engine 3.6 to 4.4 [1] | 4.2 and newer [5] |
    103: | Licence | GPL [1] | GPL-3.0-or-later [5] |
    104: | Packaging | legacy add-on zip (`goo_flattice_generator.zip`), Install from Disk, N panel "Goo Rigging Tools" [2] | extension, 19.6 KB, one 790-line `__init__.py`; read, not run (zip sha256 eafab40c...ed1458) |
    105: | Traction | Superhive: 100+ sales, published "3 days ago" (so about 10-27) [1]; Gumroad: 2 ratings, 5.0 [3] | 595 downloads, no reviews [5] |
    106: 
    107: **DillonGoo's (the face one):**
    108: - **Inputs:** a parent bone, any number of meshes, and the 3D cursor set at the chin [2].
    109: - **What it builds:**
    110:   - a vertex group weighted from the cursor down (with a Falloff setting), so the face flattens and the body below
    111:     doesn't;
    112:   - an empty that follows the active camera 1:1, and a lattice parent that tracks that empty;
    113:   - a low-resolution lattice with a shape key that flattens it to a plane [2].
    114: - **The switch:** a "Flattice" property on a bone, 0 to 1. It can be animated and library-overridden [1][2].
    115: - **The author's reason:** it "disconnects the focal length of the face from the focal length of the camera" [1][3].
    116: - **FAQ:** the flattening "mimics a higher focal length". The tool was built years ago, and "Geometry Nodes can
    117:   totally do it now" [8].
    118: 
    119: **Merlin Perry's (object level):**
    120: - **Create Flattice** fits a 2x2xN lattice to the selected objects' bounds and adds a Damped Track to the camera.
    121: - A `Flatten` shape key sets every point's local z to 0. A driver ties it to a `flatten` property on the camera,
    122:   from -10 to 10: 1 is flat, 0 is the model as built, negatives exaggerate depth [5][6].
    123: - **No falloff:** whole objects flatten. On a VRoid model only the Face mesh would flatten, so it would come apart
    124:   from the body at the neck.
    125: - **Possibly headless:** besides `bpy.ops.flattice.create`, the build path uses only the data API and context
    126:   (selected objects, `scene.camera`). Calling it from `blender -b` should work. Not tested.
    127: 
    128: ### What it is and isn't, against the known approaches
    129: 
    130: - **Is:** the focal-length cheat. It only does anything under a perspective camera, which it moves toward an
    131:   orthographic read.
    132: - **Isn't:**
    133:   - per-view shape correction (the anime nose and mouth cheat);
    134:   - squash and stretch of eyes or mouth;
    135:   - normal editing. Recomputed normals follow the squashed geometry, so shading flattens a little, but only as a
    136:     side effect.
    137: - **Lattice Magic, Camera Lattice** (Blender Studio, free extension 1.0.1, Blender 4.2+, GPL):
    138:   - a lattice in a camera's view that you sculpt shot by shot, with one shape key per frame;
    139:   - "like Liquify but on vertices" [9][10].
    140:   - For fixing individual shots, not a standing rig.
    141: - **View-angle shape keys, CamKeys** (beyonddev on Booth, ¥2,999, v3.4.5):
    142:   - drives shape keys from the camera's angle and distance; you sculpt the corrections yourself;
    143:   - also has a "Forced Perspective" per-object focal length, which is the same idea as Flattice [11].
    144:   - Of the add-ons found, this is the one aimed at the nose and mouth cheat.
    145: - **Face normals:**
    146:   - Easy Custom Normals (Fondant, Superhive, $10, or $20 with the Anime Face Proxy; GPL; Blender 4.3 and 4.4)
    147:     derives face normals from a rigged curve proxy through Geometry Nodes [12]. Older coverage called the proxy
    148:     "next up" [13]; the store page now sells it.
    149:   - Blender's own Data Transfer modifier copies custom normals from a proxy mesh [14].
    150: - **SDF face shadow maps:**
    151:   - a baked texture that the shader thresholds against the light's direction, giving a clean, controlled face
    152:     shadow [15].
    153:   - This is shader-side, mostly Unity and Unreal; a standalone baker exists on Booth [16]. It isn't a Blender
    154:     deformation.
    155: - **Grease Pencil Line Art:** lines from geometry [17]. Not relevant here: lowmarch draws its own outlines.
    156: 
    157: ### Fit for lowmarch
    158: 
    159: - **Under orthographic cameras, flattening along the view axis changes no silhouette.** Lowmarch already renders the
    160:   look Flattice is chasing. The owner's "too sharp at some angles" came from our fitter, not from perspective
    161:   (lesson 30).
    162: - **It would matter if:**
    163:   - Lowmarch's Unicorn Overlord-style battle scenes move to a perspective camera, or
    164:   - sortie's pilots appear in its perspective three.js cameras (`src/game/game.ts:168`, `src/view/cameras.ts:36`).
    165: - **In those cases the add-on itself doesn't carry over.** The effect is a scale of camera-space depth about the
    166:   head's center, weighted from the chin up. That is a few lines in a vertex shader, or in numpy before projection.
    167: - **If faces still read wrong at some angles, two ideas fit lowmarch better:**
    168:   - view-angle correctives, keyed by yaw in code, since every render knows its yaw;
    169:   - face normals taken from a fitted ellipsoid before shading.
    170: 
    171: ### Trial, run 2026-10-30 (DillonGoo's add-on, bought by the owner)
    172: 
    173: **Purchases:** the owner bought Flattice and DillonGoo's "Yin and Yang twin anime rigs". The files are in Windows
    174: Downloads (`[redacted: Windows home]\Downloads`):
    175: - `Flattice-Goo-fixed.zip`;
    176: - `_Yin_*` and `_Yang_*` zips in three builds each: EV (EEVEE) 4.3+, GE (Goo Engine) 4.3+, and GE Legacy 4.0+.
    177: 
    178: **Where things are:** scripts and results are in `~/.local/share/lowmarch/trials/flattice-2026-10-30/`. Nothing was
    179: installed. The add-on was imported from a scratch copy and registered for each run only.
    180: 
    181: **The add-on's code** (legacy add-on, `bl_info` credits Cody Winchester and Crabnuts, about 300 lines):
    182: - **What it builds:**
    183:   - a 4x2x4 lattice, a fixed 1 m cube centred on the parent bone's head;
    184:   - a Flatten shape key that collapses the lattice's local Y;
    185:   - an empty that tracks the camera with a Damped Track. A Camera_Reference empty follows `scene.camera` through
    186:     context-property drivers.
    187: - **The falloff:** a `MOD-Flattice` vertex group, weight 1 above the 3D cursor's Z, fading to 0 over `falloff`
    188:   metres below it.
    189: - **The switch:** a "Flattice" property, 0 to 1, on the parent or properties bone. It drives the Flatten key.
    190: - **Bugs found by reading:**
    191:   - with no rig set it crashes: it checks `target_rig == ""` on a pointer;
    192:   - "no meshes selected" reports an error but doesn't stop;
    193:   - re-running resets the bone property, because `hasattr` can't see custom properties;
    194:   - the panel's chin-height setting is unused; the cursor's Z is what counts.
    195: 
    196: **Headless works.** Set `scene.Flattice_Props` (target rig, parent bone, falloff), select the meshes, put the cursor
    197: at the chin, then call `bpy.ops.setup.addflattice()`. On a VRoid armory body (`arm_f_sexy`):
    198: - the parent bone was `J_Bip_C_Head`;
    199: - the cursor sat at the face mesh's lowest point plus 1 cm;
    200: - the body mesh had to go in too, because VRoid's skull is in it. The falloff kept the neck and body out, as the
    201:   renders show.
    202: 
    203: **How the views were made:**
    204: - Cycles on the CPU, with one grey cel material: Workbench and EEVEE abort headless here, as there is no libEGL.
    205: - 512 px, framing 0.42 m of the head plane.
    206: - Lenses: 24, 35 and 85 mm, against an orthographic view, at yaw 0, 35 and 60.
    207: - "Shape" is the silhouette overlap with the orthographic view after matching size and position.
    208: 
    209: **Results (Yin rig, its own Flattice; clean masks of only the flattened meshes):**
    210: 
    211: | Lens | Shape at flatten 0, yaw 0 / 35 / 60 | Shape at flatten 1, yaw 0 / 35 / 60 |
    212: |---|---|---|
    213: | 24 mm | 0.91 / 0.90 / 0.89 | 0.93 / 0.90 / 0.91 |
    214: | 35 mm | 0.94 / 0.93 / 0.92 | 0.96 / 0.93 / 0.94 |
    215: | 85 mm | 0.97 / 0.96 / 0.95 | 0.98 / 0.97 / 0.98 |
    216: | orthographic | 1.00 | 0.99 to 1.00 (no change) |
    217: 
    218: **What the numbers mean:**
    219: - Flattening moves perspective silhouettes a little toward the orthographic one. Its visible effect is inside the face:
    220:   at 24 and 35 mm the nose and mouth stop bulging (see the sheets).
    221: - **The pivot is the neck, not the camera axis.** The flatten plane faces the line from the parent bone's head to the
    222:   camera. At very close range that line tilts: 21 degrees with the camera 0.32 m from the face. The flattened head then
    223:   shrinks vertically, so raw overlap at 24 mm got worse (0.89 to 0.85) and only the size-matched score improved.
    224: - **Under orthographic cameras it changes nothing:** overlap is 0.99 or better. That confirms there is no gain for
    225:   lowmarch's current renderers.
    226: - **The VRoid numbers are not usable.** The armory model is T-posed, so its arms are in frame and in the mask. Read the
    227:   VRoid sheet visually only.
    228: 
    229: **Shading is the catch, and the Yin rig shows the fix:**
    230: - Flattening the mesh flattens its normals. On Yin's head, the share of face normals pointing at the camera went from
    231:   19% to 47%, and normal-based cel shading washed out (my grey renders at flatten 1).
    232: - Yin's own materials don't shade from mesh normals. Skin, Scalera and Iris read a `vs_nrm` attribute, stored before the
    233:   Lattice by the GN group "Head Vertex Skeleton Normals":
    234:   - normals are blended toward directions from two locator empties, `Yin_Head_Pos` (factor 0.5) and `Yin_Neck_Pos`
    235:     (factor 0.95);
    236:   - the blend is weighted by the `NRM_Head` and `NRM_Neck` attributes, then blurred.
    237:   - So their designed shading survives the flatten.
    238: - That modifier is off in the viewport and on for renders.
    239: - **For lowmarch:** we already shade from stored vertex normals, so a depth squash in our renderer wouldn't touch
    240:   shading. The head-locator normal blend is worth copying anyway, for faces that read soft at every angle.
    241: 
    242: **Result:** Flattice does what it says, scripts headless, and costs nothing to keep. Lowmarch gets nothing from it while
    243: its cameras are orthographic. If a perspective camera comes (Unicorn Overlord-style battles, sortie close-ups), the
    244: recipe is a depth scale about the head with a chin falloff. Shade from normals stored before the squash.
    245: 
    246: ### Yin and Yang twin rigs (DillonGoo, bought 2026-10-30): review
    247: 
    248: The full review is in `~/.local/share/lowmarch/trials/yin-yang-review-2026-10-30/` (`REVIEW.md`), done by a worker on the
    249: EEVEE builds, opened headless with autoexec off.
    250: - **Use `contact_sheet_armory.png`.** Its lowmarch rows come from the armory page's own painted renderer, head and whole
    251:   body, shot headless from a patched scratch copy of the built page (`scripts/arm_shoot.py`, `scripts/compare_sheet.py`).
    252: - The first sheet (`contact_sheet.png`) wrongly used `tools/vroid_portrait.py`, the old pixel path. It crops to a bust
    253:   and mangles armory bodies.
    254: 
    255: **Not a base.**
    256: - **Licence** ("Editorial" on Superhive; $40 to $70 tiers): personal or educational use only. No redistribution "in
    257:   original or modified form", and the Yin and Yang characters can't be used commercially
    258:   (https://superhivemarket.com/products/yin-yang-twins-anime-rig-pack, and the Gumroad listing
    259:   dillongoo.gumroad.com/l/yin-yang-anime-twins-rig-pack). A game build would redistribute them.
    260: - **Technically a poor fit:**
    261:   - the clothes are the body: Yin has no skin under the shirt and pants;
    262:   - a Rigify A-pose rig split over 3 armatures, about 1,640 bones;
    263:   - expressions are bones, not shape keys.
    264: - Reimplementing their techniques in our own code copies no asset.
    265: 
    266: **Lessons for lowmarch, ranked:**
    267: 1. **Proxy shading normals ("Vertex Skeleton Normals")** in `vs_nrm`:
    268:    - `n = normalize(P - mix(mean of the skeleton, nearest point on a short vertical edge inside the head, 0.5))`;
    269:    - blended in by a painted mask, blurred 5 times, renormalized; the neck uses a capsule (factor 0.95).
    270:    - Bake it at build time into the GLB normals (`tools/export_glb.py` / `review/vroid-02/build.py`). Then the armory
    271:      page's painted renderer (`review/vroid-02/index.html`), the pixel path and later the game all get it. Paint the
    272:      mask once on VRoid's shared face template. Led #1114.
    273:    - The contact sheet's A/B (our 4 bands and headlight on their mesh) shows the difference. Mesh normals give noisy
    274:      nose and cheek patches that move with yaw; the proxy gives clean ovals at every angle.
    275: 2. **One proxy for the whole head:** hair, brows, lashes and mouth use it too, so shade edges carry from hair into face.
    276: 3. **Two skin tones split at N.L 0.1**, with the rest authored. That is fewer bands than our 4.
    277: 4. **Authored shade:** a painted per-corner `Shadows` attribute, plus tiny nose, lip and eyelid shadow cards. Yang's nose
    278:    card flips sides with the light; for us that would be UV marks picked by the light's side.
    279: 5. **Line-only geometry:** `Eyelids` is edges only, for Line Art. For us, lid and nose lines as 3D polylines projected
    280:    per frame, like `draw_curve_mouth`.
    281: 
    282: **Proportions:**
    283: - Yin: 7.3 heads, eye line 0.58 down from the crown.
    284: - Yang: about 7.8 heads, eyes at 0.55, higher than any VRoid sample.
    285: - Ours: arm_f_slender 7.3 heads, arm_m_youth 6.5, both with eyes at 0.61.
    286: 
    287: **Not checked:**
    288: - the Goo Engine look;
    289: - the Wiggle 2 dependency;
    290: - GN input values beyond the group defaults;
    291: - (Since checked: the owner ran the shipped-shader turnaround with autoexec on. All 8 renders, both rigs at 4 yaws, are
    292:   pixel-identical to the autoexec-off ones. The 6 Python drivers don't touch the rest pose.)
    293: - Line Art draws nothing headless, so the sheet's outlines are approximate.
    294: 
    295: ### Face shading from the rigs' lessons (2026-10-30, owner's go)
    296: 
    297: Commits **Armory v13** (`121a1e4`, `face_normals`), **v13.1** (`dc3c532`) and **v13.2** (`fbffd7c`), in
    298: `tools/vroid_portrait.py` and on by default; portrait guide lessons 32 and 33.
    299: - **v13:** the face, brows, lines, mouth and skull are shaded from normals pointing away from a line inside the head.
    300:   The nose patch and the blotchy jaw are gone.
    301:   - The line sits at the head's middle (`forward=0.0`), not Yin's 13% forward: VRoid faces are flatter.
    302:   - Hair is off: the trick flattens the strands in the painted renderer.
    303: - **v13.1 (superseded):** a nose shadow and the chin's V on the neck, made by turning normals down in soft patches.
    304:   The owner saw scars: the edges followed the mesh's triangles.
    305: - **v13.2** (`fbffd7c`, `shadow_cards`): designed geometry instead, like the Yin rig's shadow cards.
    306:   - A crescent on the neck under the real jaw line, and a half-moon under the nose tip.
    307:   - New role "shadow": skin that only darkens into its shade tone (export, the painted page
    308:     `review/vroid-02/index.html`, the pixel path).
    309:   - `face_normals` gains a neck cylinder. Portrait guide lesson 34. Sheet: `shadow-cards.png`.
    310: - **v13.3:** the neck's line now comes from the skeleton (`neck_frame`: neck bone to head bone).
    311:   - The skin-slice estimate had broken the slender woman's card in the T-pose, which is why she and the youth
    312:     looked different. `neck-isolated.png` shows it with the neck held lit.
    313:   - The crescent is shallower and tapers before the jaw's angle, and cards darken only to a soft shade
    314:     (`min(lit, 0.37)`).
    315: - **v13.4 (`5e928b9`, kept by the owner 10-30, hair-strand shadows included):** the chin's shadow is cast in screen space from the jaw and hair (portrait guide
    316:   lesson 35, after Anime Shading Plus's depth-offset shadows).
    317:   - The painted renderer draws its info pass first; body skin walks toward the key across it.
    318:   - The chin card is off (`CHIN_CARD`). Sheet: `cast-shadows.png`.
    319: - **Light, not changed:** the armory's light is a camera headlight from the upper left, with a slightly blue shade
    320:   tint. `light-test.png` shows other directions and a warm tint; the owner found the shape, not the light, was the
    321:   problem.
    322: - **Fewer tones:** already true on faces after these two steps, so the shared skin shader was left alone.
    323: - **Step 3 (lid crease) dropped.** Painted into the face texture it can't get darker than about 55% (the skin
    324:   shader's clamp), and bangs hide it. Doing it as ink on VRoid's eyeline overlay is optional follow-up (led).
    325: - **Only arm_f_slender and arm_m_youth are rebuilt** (local `review/out/armory/site`). The other 12, and the
    326:   published armory page, are still v12.1.
    327:   - Every edit to `vroid_portrait.py` changes `tools/cage.py`'s cache key. A full refresh is
    328:     `python3 -I tools/cage.py`, then `LOWMARCH_SITE=armory python3 review/vroid-02/build.py`, then `sheets.py`,
    329:     then republishing (owner's go). Bodies come out byte-identical; it costs about a minute a body.
    330: - **Sheets and scripts:** `~/.local/share/lowmarch/trials/face-shading-2026-10-30/`.
    331:   - `arm_shoot.py` shoots a patched copy of the built armory page headless.
    332:   - `variant_build.py` builds settings variants into a scratch site without touching the repo.
    333:   - `armsite_before_v13/` is the v12.1 site with Head and Body rows at 0/35/60/90.
    334: 
    335: **Flattice in the armory renderer** (`flattice-slender-before-after.png`, same folder): `patch_lens_flattice.py`
    336: gives a scratch copy of the built page a perspective lens per tile, perspective-aware outline depth, and Flattice as
    337: a vertex-shader squash (pivot at the head bone, along pivot to camera, chin falloff, normals untouched).
    338: - At flatten 1 every head layer lands on one plane and the depth buffer can't order them (z-fighting), so it uses
    339:   0.85 and scales the outline pass's depth step by the same amount.
    340: - **The chin is the cursor, not the pivot.** The docs put the 3D cursor on the chin, but the cursor only sets where
    341:   the squash starts (full above it, fading 5 cm below). The pivot is the parent bone. On the Yin rig: the falloff
    342:   starts at her chin (z 1.447), and the pivot is the head bone 4.7 cm above it, about 11 cm behind the face front.
    343:   Ours matches: cursor at the chin, pivot at J_Bip_C_Head, about 3 cm above it.
    344: - **Pivot moved to the chin's front (`flattice-pivot.png`):** the head keeps its size at 0 and 35 degrees, but at 60
    345:   and 90 the hair breaks up near the neck. The head-bone pivot is the stable one. A close-up head still looks a
    346:   little small, mostly because the unflattened shoulders bulge toward the lens. Options for the game camera: a pivot
    347:   partway forward, or a light squash on the shoulders too.
    348: 
    349: **Flattice parked (owner, 2026-10-30): no real value until game scenes are composed with a camera.**
    350: - The "something off" in the head-only renders is two lenses in one picture: a drawn-flat head on shoulders and arms
    351:   still in strong 24 mm perspective. Flattening the whole figure (`flattice-whole.png`) reads consistent, but it then
    352:   comes close to the lens-less armory camera, so the armory gains nothing.
    353: - **When scenes come:** the anime trick is characters flattened and backgrounds left in perspective. DillonGoo's own
    354:   copy says it can flatten "face, chest, or whole body", so start from whole-figure, per shot.
    355: - The scratch page patch (`patch_lens_flattice.py`) already does lens, whole-figure, head-only and pivot options.
    356: 
    357: ### Skin range (2026-10-30)
    358: 
    359: - **Armory republished** (same link, version 15): all 14 bodies with v13.4 face shading, plus a skin picker.
    360: - **The range** (`5a2b154`, `47dcd23`, portrait guide lesson 36):
    361:   - `cast.SKINS` has 12 people tones (porcelain to ebony) and 7 fantasy tones (drow_ash, drow_slate, ashen, orc,
    362:     orc_deep, sea, infernal). The mobs' older 7 tones are unchanged.
    363:   - `export_glb.skin_ramp` derives each tone's shade and deep shade; the painted renderer uses the ramp.
    364: - **The picker:** `?skin=<tone>` for headless sheets; `SKIN_PICKER` in build.py lists it. The armory bodies themselves
    365:   still default to light skin.
    366: - **Sheets:** `skin-range-people.png`, `skin-range-fantasy.png` (trials folder). Runner: `scripts/run_range.sh`.
    367: - **Next range candidates (owner to order):**
    368:   - hair types VRoid lacks (curly, coily, braids, locs) via our hair kit;
    369:   - feature variety (nose, lips, eye shape);
    370:   - eye colours, freckles and marks;
    371:   - fantasy ears (elf);
    372:   - ages and builds beyond the 14.
    373: 
    374: ### Expressions: Yin and Yang vs ours (2026-10-30)
    375: 
    376: Sheet: `~/.local/share/lowmarch/trials/yin-yang-review-2026-10-30/expressions-vs-yin-yang.png`. It shows 9
    377: expressions and 5 lip-sync mouths, at 0 and 35 degrees, with Yin beside our slender woman and Yang beside our youth.
    378: 
    379: **How their faces are posed:** with the rig's own macro controls, Rigify Action constraints (`yy_action_map.py`):
    380: - `eye-look-blink-macro`: Z+ gives happy closed eyes, Z- sleepy closed eyes;
    381: - `lip-corner-MASTER.L/R`: Z for smile and frown;
    382: - `brow-shape-control`;
    383: - eye tilt on the `eye-blink-top/bottom` rotation;
    384: - the `jaw` rotation;
    385: - `sync-control`: 9 lip-sync mouths.
    386: 
    387: Line Art evaluates headless once its Grease Pencil objects are visible in the viewport. `yin_expr.py` projects its
    388: strokes and `expr_lines.py` draws them, because the rig's closed mouth is Line Art.
    389: 
    390: **Ours:** VRoid's 57 shapes, baked at build (`variant_build.py rest=...`).
    391: 
    392: **Findings:**
    393: - **Open mouths:** ours are a flat dark-brown blob. VRoid's own mouth texture (FaceMouth) holds white teeth, a pink
    394:   tongue and a pink lining, and the painted renderer throws it away (the mouth role is flat colour "1"). Yin shows
    395:   teeth and tongue.
    396: - **Brows:** our slender woman's bangs cover her brows, so angry and sad barely read. Yin's bangs stop above hers,
    397:   with gaps. She does not draw brows over hair; that anime trick would be our own option.
    398: - **Asymmetry:** VRoid has no one-sided mouth shapes, so no smirk. The rig's bones allow it.
    399: - **Closed-mouth shapes:** theirs are drawn strokes (a "u" smile, an inverted-v frown). Ours are VRoid's painted line,

    118 more lines not shown.