A 3D model pipeline, pushed by Gemini 4 Carbon
agent (cont.)
+0:58read_file{"EndLine":1442,"Path":"~/work/lowmarch/docs/portrait-guide.md","StartLine":614}
input
{ "EndLine": 1442, "Path": "~/work/lowmarch/docs/portrait-guide.md", "StartLine": 614 }result, 595 lines
Partial read (lines 614-1413 of 1442). Showing bytes 0-46080 of 62750 in this line range, truncated at the 46080-byte limit. To read the rest of this line range, call this tool again with the same StartLine and EndLine and ByteOffset=46080. 614: 615: **Why the VRoid bases limit us** (the user asked why the enemies all looked alike): 616: - The eight samples are one face mesh and two body meshes. 617: - VRoid's body sliders are baked in on export, so the files carry expression morphs only. 618: - The eyes, brows and mouth are anime drawings in textures, so moving the skull under them changes 619: little. 620: - Bone scaling inflates limbs like tubes; it can't add muscle, fat or a hunch. 621: 622: **The test:** MakeHuman's CC0 base mesh and targets (`docs/makehuman.md`), converted by 623: `tools/makehuman.py` into a VRM-shaped file so the whole pipeline runs unchanged. 624: - **Macro targets** (gender, age, muscle, weight, height, proportions) blend as MakeHuman blends them: 625: each slider has anchors, and the weight of a combined target is the product of its sliders' 626: weights. Named targets take -1..1 for an incr/decr pair; an `l-` name applies to both sides. 627: - **The rig:** joints are the default rig's head positions, taken from the morphed joint helpers. 628: The weights are mapped onto VRoid's J_Bip names, which suits the rig, the clips and the costume kit. 629: - **The rest pose:** arms are rotated to horizontal, the forearms straightened, the palms twisted 630: down (thumb forward) and the fingers aligned with the hand; legs are straight. It is then turned to 631: face -z, in metres, with every bone's rest rotation identity. 632: - **The parts:** the face mask (head skin in front of a plane 3 cm behind the eyes) is split from the 633: body, as VRoid's is. The eyes are stylised by us: the eyeball as the white, an iris cap with a 634: painted greyscale iris and a highlight disc, a tapered lid line along the lash helper's root, 635: smoothed brow strips, and a lip line. 636: 637: **Result** (three bodies in the soldier kit, in the lineup beside the VRoid soldier): 638: - **Bodies:** a big win. The youth, the stocky veteran and the brute are clearly different people; 639: the brute is broad and massive where the VRoid "huge" build was only tall. 640: - **Faces:** the bone structure and age now read (jaw, cheekbones, nose, eye bags). 641: - **Still rough:** the stylised eyes are small, and the faces read pale and flat without painted 642: detail. The lip line breaks into dashes. Hair is a plain crop. 643: - **Also:** the kettle hat sits lower on these heads, over the eyes (as Unicorn Overlord's fighters 644: wear it). 645: 646: ### 17 · VRoid heads on MakeHuman bodies, 2026-10-09 647: 648: **Why:** the user found the MakeHuman faces realistic, not anime, and the arms odd. No free base has 649: both anime faces and real body variety under a licence we can ship (MB-Lab's anime bases are AGPL; 650: CharMorph's and Quaternius's are realistic or simple). So the head comes from VRoid and the body from 651: MakeHuman (`spec["head"]`, `makehuman.graft()`). 652: 653: **The graft:** 654: - **Scale and place:** the VRoid head is scaled so crown-to-chin matches the MakeHuman head 655: (`head_scale` on top), pivots on the body's head bone, and is lowered until the chins meet. VRoid's 656: head bone sits lower in its head, so pivot alone left a long neck. The eye bones move to VRoid's. 657: - **The neck:** VRoid doesn't stitch head to neck. The body's neck tube runs up inside the head and 658: the face's lower edge tucks against it. We do the same: MakeHuman's neck takes VRoid's neck section 659: above the point where the neck enters the head, and eases from its own shape below. A thick neck and 660: VRoid's slim one meet halfway: the head's outer shell (face skin, hair, never the mouth inside it) 661: widens near the neck to match, fading out upward. Stitching rings with a band failed: VRoid's 662: head/neck seam slopes, so a level cut tore the ring. 663: - **What goes:** MakeHuman's own face and jaw, which is anything in front of the neck above its chin. 664: If any of it stays, it pokes through the VRoid face as white shards around the mouth. 665: - **One body buffer:** the pipeline reads every body-skin primitive as indices into the first one's 666: vertices, as VRoid's share a buffer. VRoid's skull skin therefore joins the MakeHuman body buffer. 667: As a separate primitive, its indices were read against the wrong vertices and drew long triangles 668: across the collar, and the shirt cut from them crumpled. 669: 670: **Arms:** the weird arms were the soldier's puffed sleeve, sized for VRoid's thin arm and mostly buried 671: in MakeHuman's realistic one. Only its fold ripples poked through, and they read as muscle. `gear.puff` 672: now sizes the puff from the arm's measured thickness as well as its length. On MakeHuman bodies, 673: sleeves and trousers span the hollows between muscles (`fitting.limb_hull`: each limb segment's 674: cloth goes out to its convex hull, fading near the joints). Both leave VRoid bodies as they were. 675: 676: **Also fixed:** the face-length preset slid every skin vertex below the eyes, including the neck and 677: body, after the clothes were fitted. It now moves the body only as far as its head weight. On the 678: gaunt VRoid veteran, the neck had been dropping 1.9 cm out from under the collar. 679: 680: **Lessons:** 681: - When skin shows through cloth, find out whether it's the geometry or the renderer (`?mode=3d` on a 682: sheet), then whether the garment has holes (its boundary loops), before tuning offsets. 683: - Asymmetric damage on a symmetric body means bad data, not bad tuning. 684: 685: ### 18 · The body workshop, after an outside critique, 2026-10-09 686: 687: The user still found the MakeHuman arms odd, the neck join wonky in places, and the older faces young. 688: A second model (Fable) critiqued the renders against the Unicorn Overlord study. The six MakeHuman 689: soldiers (three men, three women) now have their own page (`LOWMARCH_SITE=mh-workshop` for 690: `build.py` and `sheets.py`; its roster and notes are in `build.WORKSHOPS`). 691: 692: **Arms:** 693: - **The puff was the "muscle".** Sized for VRoid's thin arm, it was buried in MakeHuman's realistic 694: one, and only its fold ripples poked through the sleeve. The `cap` puff (on MakeHuman bodies): 695: - a shoulder cap, widest at the top and fuller at the back, wider than the arm by at least a third; 696: - five folds converging on a leather band above the elbow, the band traced round the sleeve itself; 697: - the shirt sleeve tucked inside it. 698: - **Arms sank into broad sides.** `shape["arm_out"]` holds them out; `build.arm_room()` picks the 699: smallest angle that clears the body in the reference pose and the idle. 700: - **Hands were splayed paddles.** `shape["curl"]` relaxes the fingers wherever a pose leaves them alone. 701: - **Cloth followed every muscle.** `fitting.limb_hull` pushes sleeves, trousers and boots (toes included) 702: out to each segment's convex hull. 703: 704: **Neck:** 705: - **The ring under the chin** was our own throat cut open, plus MakeHuman's chin left inside VRoid's. 706: Now the throat stays, MakeHuman's chin goes, and the throat is drawn back onto VRoid's neck line. 707: - **The head's lower edge** widens only at the back and sides, and takes the neck's normals where it 708: overlaps, so the two shade alike. 709: - **The shirt** has a straight, sloped neckline (`wrap(cut=...)` plus a hem on the same plane). The coif 710: covers the nape. 711: - **Removing VRoid's face strip under the jaw** (`strip_reach`) was a wrong turn: the hole let the head 712: chart sink inside the jaw, and beards went with it. 713: 714: **Faces (age, the study's way):** 715: - `strip_blush`: VRoid's cheek and eye-corner blush off. 716: - `face_lines`: a few strokes drawn into a copy of the face texture. They are laid out in 3D from the 717: face's landmarks, dropped onto the face from the front, and mapped to texture space. 718: - `iris`: smaller irises. 719: - Expression shapes: VRoid's angry eye (a straight heavy lid), a little of the smile eye (it raises the 720: lower lid), and the mouth turned down. 721: - **Hair and beards now follow the face presets' reshaping.** A widened jaw used to cover the beard 722: built on it. 723: - **The moustache** is placed from the mouth on MakeHuman units. A long face put the old fixed angle on 724: the chin. 725: 726: **Also:** a "Neck and collar" row on every check sheet; `?mode=3d` on a sheet (geometry or shading?); a 727: collar crumple that turned out to be our bug: the pipeline reads all body skin as one vertex buffer. 728: 729: **Still open** (critique): trousers like tights; breastplate a bib on wide chests; a stiff idle; no 730: puffs on big men (a sleeve per build); beards as a solid shape. 731: 732: ### 19 · Sleeves and a polearm guard after the study's soldiers, 2026-10-09 733: 734: Side by side with the Unicorn Overlord soldiers (`~/.local/share/lowmarch/study/uo_soldier_arms*.png`, 735: study only), the user saw that their arms show no muscle at all, and four differences in how ours 736: were built: 737: - **Their whole sleeve is loose,** fullest round the elbow. Ours puffed at the shoulder and went tight, 738: and that bump read as a bicep. `gear.loose_sleeves` now lets the shirt's own sleeves out: little at 739: the shoulder, most round the elbow and above the gauntlet, less on the side toward the body, a little 740: more behind, with six soft folds that turn down the arm and deepen toward the cuff. No puff, no band. 741: - **Their gauntlets reach almost to the elbow** and flare; the sleeve bags into them. `cuffs(length=0.70)`, 742: and `gear.tuck_sleeves` pulls the sleeve inside the cuff's inner face (binned by angle and distance 743: along the forearm). The shirt is subdivided once so the folds have vertices to sit on. 744: - **No band on the upper arm.** Theirs have none. 745: - **Both hands on the weapon.** `clips.polearm` (cast entries get `stance="polearm"` for classes in 746: `cast.POLEARMS`): a low guard, left foot forward, the shaft across the body with the head forward and 747: up. The right fist is placed from the right shoulder in arm lengths (fixed offsets from the hips fit 748: one build and put the brute's hand in his hip). The left fist holds the shaft where a set reach from 749: the left shoulder meets it, so every build keeps bent elbows instead of a fixed hand spacing that a 750: short arm can't span. Both arms grip with `duel.clear_grip`, trying elbow directions until they clear 751: the body. The attack draws back and thrusts on a lunge, both hands on throughout. 752: - **Lean from the hips.** Bending the spine for the thrust pushed the breastplate's hem through the belt; 753: most of the lean is now a hip tilt. 754: - The halberd's rear hand moved to 0.5 m from the butt (it was 0.8: a long tail behind the soldier). 755: 756: Garment-through-plate flags dropped from up to 30 mm in workshop v1 to 8 mm at most (the brute's 757: reference pose aside). 758: 759: ### 20 · Breeches, solid beards, a skirt that hangs, a measured grip and a studied idle, 2026-10-09 760: 761: **Outfits (the rest of the critique):** 762: - **Breeches** (`gear.breeches`): the trousers let out like the sleeves (`_let_out` and `_tuck`, now shared 763: by arms and legs through `_limb_frame`), fullest above the boot top and bagging into it, less on the inner 764: thigh; the boot tops stand off the shin (`flare_boots`). The women wear tights and boots to above the knee 765: (`mobs.soldier_f`), as the study draws them. 766: - **Breastplate** `arm=64`: the armhole scoop starts later, so the plate reaches the armpits. 767: - **Solid beards**: `outline_plate(thickness=f(u, v, s, t))` fills a beard down to the face; the fall under 768: the chin is one spade-shaped mass (three locks read as a ruff, a wide block as a bib). 769: - **The scale skirt** (`skirt_cone(clear=...)`) hangs from the waist over what it covers: the tightest 770: outline that starts at the waist and clears the trousers below (an upper concave hull down each line). 771: Sized from the waist alone, the seat came through the back; stepping straight out to the seat, it 772: stood off like a shelf (a TorsoChart fills the rows above what it measured with the nearest row's 773: radius, so the trousers' hips read as present right up at the waist: those rows are ignored). In the 774: guard it follows the thighs (`share=0.15`), and `slim_under` draws the 775: trousers in where it hides them: a stiff skirt and a striding thigh otherwise always meet somewhere. 776: - The layer check's "up to N mm" now measures only the points it counts (it included rim hits it had 777: thrown out, so a 4 mm problem read 17). 778: 779: **The grip.** A weapon's shaft went through a fixed point near the wrist, tuned on one VRoid hand. On the 780: soldiers' scaled hands and MakeHuman's own, it was 3.5 to 8 cm off: the shaft ran over the knuckles and the 781: fingers closed under it. `rig.grip_points` measures the hole: each finger's joints and fingertip in the 782: fist pose fitted with a circle across the palm; the weapon (`gear._hand_frame`, through `fit.grip`) and the 783: clips (`clips.fists`) both use it. 784: 785: **The idle, after a study.** One clean animated idle from the study (a mercenary), tracked patch by patch 786: (`~/.local/share/lowmarch/study/uo_idle*`, study only): 787: - a loop of about 2 s; the feet planted, the knees nearly still; 788: - the hips sink about 2% of the figure's height and the chest about twice that, forward as they sink, and 789: the upper body rocks back as it rises (the back shoulder dips as the front one rises); 790: - uneven timing: a slow rise (about 0.7 s), a short hold, a quicker sink (about 0.4 s), a longer settle; 791: - the arms ride on the torso; the weapon's tip dips as the body sinks, so it swings the most. 792: `clips.polearm` now samples that loop every 0.1 s (`GUARD_TOP`, `GUARD_LOW`, `IDLE_SINK`, eased between 793: points), the shaft a beat behind, the head kept level, and grips both hands afresh at every sample so they 794: stay on the shaft in between. The check sheets have an "Idle loop" row (one side, six moments). 795: A battle clip with soldiers in formation was too small and dithered to measure. 796: 797: ### 21 · Base spike, 2026-10-09 798: 799: **Why:** the user saw that the base decides how many kinds of character we can make, and asked what else 800: there is besides VRoid and MakeHuman. The candidates were researched (licence first), then the plausible 801: ones were put in the same soldier kit on their own page (`LOWMARCH_SITE=base-spike`; the `spk_` cast 802: entries). Each was judged on a checklist: 803: 1. a licence we can ship; 804: 2. body variety without bone-scaling; 805: 3. faces that can read as Unicorn Overlord, vary with age and structure, and have no seam; 806: 4. pipeline fit (rig, kit, clips); 807: 5. the overall read against MakeHuman with a VRoid head. 808: 809: **Results:** 810: - **MakeHuman + VRoid head** (the baseline): 811: - still the only anime read; 812: - the youth's ring under the chin is still there; 813: - face variety stops at VRoid's two heads plus presets. 814: - **MakeHuman's own head pushed toward anime** (`cast._anime`: MakeHuman's face targets for bigger, lower 815: eyes, a small nose and mouth and a narrower chin; `face_round`, rounded face normals; heavier lines): 816: - no seam; 817: - real structure and age (a 15- and a 70-year-old); 818: - still a pale mask with small eyes. MakeHuman's eye targets scale a realistic opening, and an anime eye 819: is a drawn shape bigger than the opening. `face_round` 0.75 flattened the face too far. 820: - MakeHuman has 34 CC0 expression units (`targets/expression/units`) that the converter doesn't use yet. 821: - **Quaternius Universal Base Characters** (CC0; `tools/quaternius.py`, `docs/quaternius.md`): 822: - **Bodies:** the free pack has only the two "superhero" bodies, each fixed. 823: - **Faces:** a painted Western face with no face shapes, about 7.8 heads tall. 824: - **Fit:** it converts in one step onto our rig (`makehuman.straighten`, `settle` and `write`, now shared). 825: - **Arms:** the man's wide lats put an arm 2.1 cm into the body through the guard idle. 826: - **Plates:** the breastplate copies the sculpted abs and back muscles. 827: - **Animations:** its CC0 animation libraries share the skeleton and could serve any base. 828: - **Blender Studio base meshes** (CC0): unrigged sculpting bases with no shape keys. The stylized pair are 829: 5.5-6-head caricatures, the wrong direction for a "stylize" target. 830: - **Anny:** MakeHuman's mesh and targets as a PyTorch library; our converter already reads the same targets. 831: 832: **Measuring proportions:** crown to chin by the pipeline's own landmark (the face mask's lowest midline 833: point). A front-profile search for the chin was unreliable: it found chests and collars. 834: 835: **Verdict:** keep MakeHuman for bodies. The next head experiment would warp VRoid's face mask (drawn eyes, 836: brows, mouth and expression shapes) by landmarks onto MakeHuman's skull, keeping MakeHuman's structure and 837: age with VRoid's drawing and no neck seam. 838: 839: ### 22 · VRoid Studio driven from WSL, and MakeHuman's mass on a VRoid body, 2026-10-09 840: 841: **The driver** (`tools/winvroid`, after mcp-vroid's Linux driver, MIT): 842: - **How it works:** VRoid Studio runs on Windows, and WSL drives it through `powershell.exe`: 843: - `V.cs` is compiled once and does capture, input and window queries; 844: - `ocr.ps1` uses Windows' own OCR. 845: - **Capture:** `PrintWindow` returns a blank client for Unity's DirectX window, so the screen is captured 846: instead, and VRoid must be uncovered. 847: - **Pointer:** Unity reads raw mouse input. A cursor moved by `SetCursorPos` never hovers, so scroll wheels 848: did nothing; absolute `SendInput` moves fixed it. 849: - **Safety:** input is refused unless the foreground window belongs to VRoid's process. 850: - **Quirks found:** 851: - The first click on a sample downloads it; a second opens it. 852: - The export dialog writes VRoid's default licence fields into our copy. 853: - A new character won't export until Title and Creator are filled. 854: - OCR reads "Title" as "Titte". 855: - VRoid's "height" slider is stored as `figureSlender*`, and extrapolates hard: -1.5 made an 81 cm figure. 856: - **Export without clothes:** VRoid Studio 2.14 deletes the body skin its own clothes cover (Base_Male, an 857: older export, has its full skin). Our costume is shaped from the skin, so a clothed export lost its 858: chest, shoulders and upper arms. The driver now removes tops, bottoms and shoes first 859: (`winvroid.outfit_none`: each Outfit category's first tile is "none"). 860: - **The `.vroid` project:** a ZIP whose `v1model/data.bin` is protobuf. Each slider is a pair of shape keys 861: with float weights, and keys at 0 are left out. It is readable; writing projects directly is possible 862: but untried. 863: 864: **What VRoid lacks for heavy and muscular bodies:** mass. Its body keys change length, width and scale only, 865: and it has none for regional volume. Its clothing must follow every body key, which is probably why there 866: are few. 867: 868: **Mass carried across** (`tools/mass.py`): 869: - **Method:** MakeHuman's muscle and weight are mapped region by region onto a VRoid model's body: 870: - limbs by distance along the bone and angle round it; 871: - the torso by height between the hip and shoulder joints and angle round the vertical; 872: - the neck fading below the head. 873: - **Blending:** regions blend by skin weights; hands, feet and head are left alone. The outward part is 874: scaled by VRoid's thickness against MakeHuman's. 875: - **The output:** a copy of the VRM with only the body mesh's positions and normals replaced. VRoid's 876: clothes share that mesh's vertices and move with it. 877: - **Scale:** 878: - MakeHuman's macros alone are mild: maximum weight adds about 3 cm at the waist. 879: - The regional muscle and fat targets do the work, at gain 2.6. At 1.4, the loose sleeves hid it. 880: - **Open:** 881: - The guard puts an arm into wide bodies, as it did with Quaternius. 882: - The figures keep Base_Male's height and face. 883: 884: ### 23 · The armory, and proportions held by code, 2026-10-09 885: 886: **Why:** iterating on whole costumed, animated soldiers took minutes per try and hid the bodies. The user 887: asked for an armory instead: bodies, heads and hair as separate parts, T-posed and bare, to assemble into 888: archetypes later. Faces should be original in Unicorn Overlord's style; copies of its characters are only 889: study-only benchmarks. 890: 891: **The armory page** (`LOWMARCH_SITE=armory`; the cast's `arm_` entries): 892: - **Pose:** built in the T-pose (the portrait's pose is `{}`), so the reference pose shown everywhere is 893: the T-pose. 894: - **Skipped:** clips (every one holds the pose) and the arm and garment checks. 895: - **Costume:** plain shorts, plus a band for women (`mobs.underwear`), which keep all the skin 896: (`fit.keep_skin = ("J_Bip",)`). 897: - **Sheet rows:** T-pose round, head, joins (`ARMORY_ROWS`). 898: - **Speed:** the whole page rebuilds in about 15 s. 899: - **The list:** characters with a `group` show in one dropdown with sections. 900: 901: **Proportions** (`docs/proportions.md`, `tools/proportions.py`): 902: - **Source:** 16 figures and 8 faces from the study, landmarks placed by eye on ruled crops, raw data in 903: the study folder. 904: - **Targets:** per archetype (young, adult, heavy, generic). The face unit (chin to eye line) is the base 905: measure, since hair hides the skull's top. 906: - **Measured on our model files:** heads tall, eye line, eye opening, face width, crotch height, 907: shoulder, hip and waist widths, arm, hand and foot length, and thighs crossing the midline (tearing). 908: The armory build lists each body's ratios that miss its archetype in the checks panel. 909: - **Findings:** 910: - Generic units are about 6 heads with short legs; heroes run 6.5 to 9.5. 911: - Our bodies are too tall in heads and narrow for the heavy and generic builds. 912: - VRoid's bodies are narrow with short arms, though their faces pass. 913: - MakeHuman's own heads set the eyes too high in the head (the "realistic" read). 914: - The massed VRoid bodies' thighs cross by about 4 cm: the tearing. 915: 916: **VRoid sample export:** `python3 tools/winvroid/winvroid.py samples` exports pixiv's 26 samples into 917: `vroid/samples_2_14/` (resumable; it stops when VRoid loses the foreground). That keeps them apart from 918: the older D–G, which are other characters and back the hunter and the thief. 919: 920: ### 24 · Bodies fitted by code, and the faults behind the armory's shoulders, 2026-10-10 921: 922: **Why:** in the first armory nearly every body had wrong shoulders and too much distance from the neck to 923: the chest, some had chest holes, head sizes didn't match, and the VRoid bodies with MakeHuman's mass were 924: torn. Each fault is now held by a measurement and a fix in code. 925: 926: **Shoulders and neck:** 927: - **What was wrong:** MakeHuman's neck is long. The chin sat 0.52 to 0.58 head heights above the shoulder 928: joints, where VRoid's bodies sit at 0.30 to 0.36. The trapezius ran in a long ramp from the jaw to arms 929: set low. 930: - **What wasn't:** the collarbones. MakeHuman's already slope 6 to 10 degrees down and out, like VRoid's. 931: Lifting them in the straightening (`clavicle_lift`, kept) flattens the ramp but shrugs the shoulders. 932: - **The fix:** the neck is fitted with MakeHuman's own controls (`neck-scale-vert`, then 933: `measure-neck-height`). 934: - **New measures** (`proportions.py`): `neck_hd`, `clav_deg`, `drop_hd`, taken from the joints. The skin's 935: top above a thick arm is the arm. 936: 937: **The fitter** (`tools/fit.py`, see `docs/proportions.md`): each ratio moves the MakeHuman control behind 938: it, the head is sized in closed form, and the figure is scaled back to its design height. 939: 940: **What a short neck broke in the head graft**, all fixed: 941: - **The jaw cut:** it took any skin in front of the neck above MakeHuman's chin. Two consequences: 942: - It took the trapezius' top on a short neck. Only skin bound to the head (`jaw_hw`, 0.9) goes now. 943: - It took the throat's top, half head and half neck, and opened a gap under VRoid's chin. The same 944: threshold fixes this. 945: - **The neck's radius:** it's now measured from the neck bone's skin only. Mid-neck had moved down into 946: the trapezius' flare, so the radius read too thick. 947: - **The throat stitch:** it switched to VRoid's section on a hard 60-degree edge, which left a box on the 948: throat. It now eases in with the angle. 949: - **Fixed distances:** the graft's distances (the chin search, the neck ring, the taper) now scale with 950: `body_scale`. A 1.2 times bigger body put the chin outside the search window, and the head came out the 951: wrong size. 952: 953: **The inspection underwear:** 954: - **Notches at the waistband:** they came from skin triangles crossing the hem line, which were dropped, 955: leaving gaps as deep as a triangle (3 cm on MakeHuman's hips). The shorts now take triangles past the 956: hems and clamp everything onto the hem planes (`wrap(..., clamp=True)`). They also push back out what a 957: hem pulls into the skin (`refloor=True`). Both are off by default, so finished costumes don't drift. 958: - **Holes:** they came from skin weighted to bones outside the list. The shorts take every bone but the 959: arms'. 960: - **Skin coming through:** the skin well inside the shorts is hidden (`fit.drop_skin`). It must leave 961: the arms alone: the costume is fitted with the arms hanging beside the hips, and the first try hid the 962: forearms. 963: 964: **Mass on VRoid bodies** (`tools/mass.py`): 965: - **Rebased:** onto VRoid's own bases, exported unclothed in the PC session (`base_masc.vrm`, 966: `base_fem.vrm`). 967: - **Seams:** VRoid 2's exports split vertices along texture seams, so the move is made on welded 968: vertices. 969: - **Thighs:** each leg's skin eases toward a 3 mm gap at the midline instead of crossing it (was 4 cm). 970: - **Limbs carry thickness only:** the segment's own joint motion is taken out. MakeHuman's muscular macro 971: widens the shoulders, and copying that shift slid the forearm skin past the hands. 972: - **The torso** takes its own share of the gain (`torso_gain`). At the limbs' 2.6 the lats ballooned. 973: 974: **The PC session:** 975: - **Exported:** all 26 VRoid samples (A to Z, `vroid/samples_2_14/`, about 95 s each) and both bases, 976: unclothed (`winvroid.py bases`). 977: - **A retry added:** the menu ignores clicks while the editor reloads after an export. 978: 979: ### 25 · VRoid bodies shaped by MakeHuman, their own head kept, 2026-10-10 980: 981: **Why:** the head graft looked like surgery and the heads didn't sit naturally on some bodies, and 982: MakeHuman's mass carried onto VRoid didn't sculpt well. VRoid's bodies only come in a narrow range and 983: MakeHuman's realistic bodies don't match an anime head. The spike (`tools/cage.py`) keeps VRoid's whole 984: model, head included, and takes only the broad shape from a MakeHuman body: MakeHuman gives the range of 985: builds, VRoid gives the head and the surface. 986: 987: **How it's done** (the details are in `tools/cage.py`): 988: - **The skeleton goes onto the MakeHuman body's joints:** the limb bones are turned and stretched from 989: joint to joint, the spine as one piece. The head, hands and feet are scaled whole, and the head is 990: placed by its chin. 991: - **The wrap:** each body vertex casts a ray along its normal to the MakeHuman skin. The distance is 992: smoothed over space, so only broad volumes come across. 993: - **Untouched:** the head, hands and feet, and every vertex the body shares with the face mesh. 994: 995: **What didn't work, and why:** 996: - **Shaping by hand with the spec's own controls** (bone thickness, rings, bumps) made fat or boxy 997: bodies: 998: - Scaling a whole bone's thickness shows as a step wherever its skin weight changes quickly (knees, 999: wrists). Scaling the collarbone made a box round the shoulders. 1000: - Smooth rings along each limb fixed the steps, but widening a slim body's cross-sections reads as fat, 1001: not strong. The trapezius and deltoids are shapes over the top of the shoulder, which rings can't 1002: raise. 1003: - **Nearest points:** for a slim body inside a big one, the nearest reference point usually lies to the 1004: side. Cast along the normal instead, and only accept skin facing the same way: without that, a neck 1005: whose front is missing (the reference's grafted head) takes its back and pinches the throat. 1006: - **Smoothing a vector:** it cancels round a limb, because opposite sides point opposite ways. Smooth the 1007: distance along the normal instead. 1008: - **Smoothing by mesh passes:** it isn't the same distance everywhere. VRoid's chest is densely meshed 1009: and kept MakeHuman's pec edges as two domes. A Gaussian over real distance is the same everywhere, and 1010: the torso gets a wider one than the limbs (3.5 to 4.5 cm against 2 to 2.5). 1011: - **Stretching short bones one by one:** the 6 cm pelvis bone stretched 2.6 times made a box. The spine 1012: stretches as one piece instead.195 more lines not shown.
read_file{"Path":"~/work/lowmarch/docs/map.md"}
input
{ "Path": "~/work/lowmarch/docs/map.md" }result, 70 lines
Showing lines 1-69 of 69 1: # Map of the repo 2: 3: What's current, what's stale, where the big files are. Checked 2026-11-08 at `c4f1015`. Nothing was moved or deleted. 4: "Live" means the armory build or the first-session kit reaches it. Reach was read from imports, including the 5: `__import__` calls in `outfit.py`, not from running every path. 6: 7: ## Docs 8: 9: | File | Status | 10: |---|---| 11: | `handbook.md` | **Start here** | 12: | `map.md`, `todos-2026-11-08.md` | Current; suggestions only | 13: | `portrait-guide.md` | Detail log, 40 lessons. True when written, some since contradicted; marks are in the handbook | 14: | `vroid.md` | Current. Says 54 expression shapes at the top; the files carry 57 (2.14) and 56 (older). Licence: see #1443 | 15: | `anthro.md` | Current for bodies | 16: | `proportions.md` | Bodies current; face ratios are reported, not held, since lesson 30 | 17: | `makehuman.md` | Current: references for the cage | 18: | `study.md` | Current; one clause is guessed (handbook, Things that don't bend) | 19: | `quaternius.md` | Stale: a spike that lost (lesson 21) | 20: 21: ## Tools 22: 23: **First-session kit (new):** `tools/session/` (`frame.py`, `rows.py`, `smoke.sh`, `smoke_spec.json`), `review/frame/index.html`. 24: 25: **Render scripts (copied in 11-08 from `~/Projects/lowmarch-bench/kit`, which still has the originals):** `tools/shots/`: 26: `arm_shoot.py` (ran 11-08), `variant_build.py`, `all14.sh`, `all14_sheet.py`, `expr_build_tiles.py`, `expr_page.html`. Only 27: `all14.sh` changed, to find its own folder. 28: 29: | Status | Files | 30: |---|---| 31: | Live: the armory | `cage`, `heads`, `fit`, `proportions`, `anthro`, `makehuman`, `collide`, `vroid_portrait`, `vrm`, `export_glb`, `poses`, `rig`, `fitting`; `review/vroid-02/build.py`, `sheets.py`, `index.html`; `art/cast/cast.py`, `expressions.txt` | 32: | Live checks | `lash_check`, `lash_shots`, `checks`, `regress`, `review/vroid-02/snapshot.py` (keeps the baseline `regress` reads), `review/vroid-02/duel_check.py` (build imports `chars_for` from it), `hair_check` (standalone, nothing imports it) | 33: | Kept for later: costumes and motion on old bases, reached from the build | `outfit`, `plates`, `gear`, `mobs`, `hair`, `clips`, `duel`, `terrain`, `saber_study` (benchmark, not for the game). Not unused: the armory's inspection shorts come from `mobs.underwear` and the hair texture from `hair` | 34: | Spike that lost, still imported by the build | `mass`, `quaternius` | 35: | Pixel era, abandoned; still imported | `head3d`, `pix`, `vecpix`, `study` | 36: | Blocked | `tools/winvroid` (V.dll, #1105) | 37: | Looks dead: nothing imports it | `features.py`, `compare.py` (study side-by-sides) | 38: | Looks dead: old one-off tests, nothing imports them | `review/vroid-02/`: `battle_test`, `closeup_test`, `costume_test`, `fit_test`, `pose_test`, `mouths` | 39: | Stale pages | `review/rowan-01/`, `art/portraits/rowan*`, `art/templates/`, `review/vroid-02/base_spike_notes.html`, `mh_workshop_notes.html` | 40: 41: `vroid_portrait.py` is named for the abandoned pixel renderer, but the build still uses its `Portrait` class. Don't edit it 42: lightly: it's in cage's cache key, and so are the other cache-key files listed in the handbook. 43: 44: **Scripts that live outside the repo:** 45: 46: - `~/Projects/lowmarch-bench/kit/`: the benchmark's kit, including `front_sheet.py`, `build_expr.sh`, `blind_sheet.py`, `terra_review.sh`. 47: - `~/.local/share/lowmarch/trials/*/scripts` and loose scripts there, such as `patch_lens_flattice.py` (a perspective lens for the painted page). Copy one in if it's needed again. 48: 49: ## Big files 50: 51: The repo's tracked files are small: `.git` is 5 MB. Everything below is outside git. 52: 53: | Where | Size | What | 54: |---|---|---| 55: | `~/.local/share/lowmarch/vroid/lowmarch_bodies` | 14 GB | Built bodies and heads; holds cage's cache (`fits.json`). The bulk of everything | 56: | `~/.local/share/lowmarch/vroid/samples_2_14` | 466 MB | The 26 VRoid samples | 57: | `~/.local/share/lowmarch/makehuman` | 1.7 GB | MakeHuman data | 58: | `~/.local/share/lowmarch/trials` | 1.9 GB | Sheets and shots; `combined-2026-10-31` is 1.8 GB | 59: | `~/.local/share/lowmarch/tools` | 1.5 GB | Portable Blender 4.5, tar included. Unused since the spike | 60: | `~/.local/share/lowmarch/winvroid` | 803 MB | VRoid driver data | 61: | `~/.local/share/lowmarch/refs3d`, `study`, `quaternius`, `blender-base-meshes`, `refs`, `anthro` | 1.2 GB together | Study and spike data. References stay out of the repo | 62: | `~/.local/share/lowmarch/sessions` | new | First-session folders from `rows.py` | 63: | `~/Projects/lowmarch-bench/work` | 4.9 GB | Benchmark builds; `e` is 3 GB. Transcripts and judging keep the benchmark's record | 64: | `review/out/` (git-ignored) | 1.1 GB | `versions` 410 MB, `vroid-02` 249, `base-spike` 206, `armory` 115, `mh-workshop` 89, `frozen` 14 | 65: | `~/.local/opt/blender-5.2.3-linux-x64` | | Blender 5.2.3, unused by the pipeline | 66: 67: If space is ever needed, the safest candidates to discuss are the Blender 4.5 tar, `review/out/versions` and 68: `review/out/base-spike`. Nothing has been removed. Ask first, and check `~/Projects/lowmarch-bench/README.md`: the 69: benchmark's raw material is being kept for a blog post (#1141).
read_file{"Path":"~/work/lowmarch/docs/todos-2026-11-08.md"}
input
{ "Path": "~/work/lowmarch/docs/todos-2026-11-08.md" }result, 66 lines
Showing lines 1-65 of 65 1: # Open todos, sorted for the restart 2: 3: Suggestions only. Nothing has been closed. 33 open and 4 someday on 2026-11-08, read from `led ls all`. Any of these can 4: change once the owner has shown their picture. 5: 6: ## Still matters (10) 7: 8: | # | What | Why | 9: |---|---|---| 10: | 1443 | VRoid sample licence metadata; pixiv's help page unread | Needed before anything ships. Owner reads it by hand | 11: | 1105 | Owner allows the VRoid driver's V.dll | Blocks any new VRoid face or body session | 12: | 735 | Study how VRoid sample hair is built | Open since 10-08. Part done by the 11-08 research; the owner asked for this directly | 13: | 768 | Heads: variety in shape, modelled age | Recurring complaint, never solved. Reword it for one character's face | 14: | 1128 | A drawn lip line that follows every shape | Closed frowns are weak on any VRoid face; studios draw these as lines | 15: | 733 | Fabric textures | "We should look into fabric textures too, but that can come later" (10-08) | 16: | 1192 | Braids, coils and locks in the hair kit | Waits on the owner. Range work, so after one character | 17: | 1193 | Half-day Blender trial of built-in hair nodes | Waits on the owner. No install needed | 18: | 1141 | Blog post on the benchmark | The owner wants it later. Doesn't depend on the restart | 19: | 714 | Battle stage | Close to "one game frame", but later: the first session only needs a flat stand-in | 20: 21: ## Depends on what the restart keeps (14) 22: 23: These only matter if the current bodies or VRoid faces carry over. Suggest parking them until the first session has settled that. 24: 25: | # | What | Depends on | 26: |---|---|---| 27: | 1123 | Average woman's ear and hair slice | Sample A's hair. The dark under-layer idea is in the first-session plan either way | 28: | 770 | Mature faces in VRoid's editor | A mature character being wanted; also needs #1105 | 29: | 1121 | Flattice once scenes have a camera | The frame's camera. Nothing to do under orthographic | 30: | 761 | Neck, wrist and ankle thickness: style or fix | The current bodies; needs the owner's call | 31: | 765 | Brute's dark wedge at the deltoid | The brute | 32: | 766 | Faint crescent under inflated busts | The current women | 33: | 767 | Bodies 2 to 4 cm tall from VRoid's feet | The current bodies | 34: | 759 | Dark slit in the inspection shorts | Bare inspection bodies; goes away once dressed | 35: | 1129 | Expression picker in the armory | The armory staying the review page | 36: | 1181 | Youth's closed lid at 0.8 of his lash | The youth's face | 37: | 1184 | Angry mouth thins to a hairline on four women | Those faces; #1128 would likely cover it | 38: | 1185 | Pale tick at the end of smug's mouth | Those faces | 39: | 1186 | Shut lids follow texture steps | VRoid's painted lids | 40: | 715 | Plate edges and contact shadows | Armour returning. The kit is still there | 41: 42: ## Dead given the restart (9 open, 4 someday) 43: 44: Suggest closing or moving to someday. All of these are about retired characters or old bases. 45: 46: | # | What | Why | 47: |---|---|---| 48: | 718 | Elaine follow-ups | Elaine is retired | 49: | 727 | Attack clip puts the arm in the chest | Those clips and characters are retired; motion restarts on a new character | 50: | 729 | Saber study follow-ups | "Let's leave saber alone" (10-08) | 51: | 730 | Redesign Elaine as a knight-princess | Dead as written. The idea survives only as my default first character, and that's the owner's pick | 52: | 732 | Saber's tassets clip | Same as #729 | 53: | 737 | Enemies: arms in heavy builds, more classes | Mobs on old bases, far from one character | 54: | 743 | Main viewer rebuild for the soldiers | Old viewer, old soldiers | 55: | 748 | Polearm attack; settle battle presentation | The attack is dead; the owner's picture answers the presentation question | 56: | 1119 | Inked lid crease (optional) | Optional, already dropped once, tied to VRoid's overlay | 57: | 749 | Someday: polearm elbow flip | Old clip | 58: | 755 | Someday: fit VRoid-native bodies | That line was removed on the owner's say, 10-11 | 59: | 756 | Someday: pale band at the MakeHuman neck graft | The graft is gone | 60: | 1112 | Someday: proxy face normals | Already done, #1114 | 61: 62: ## Not mine 63: 64: - #981 sortie pilot from this pipeline: belongs to the mech tab, which is restarting too. It depends on whatever this restart keeps. 65: - #1369 project trackers: the trackers session's.