A 3D model pipeline, pushed by Gemini 4 Argon
agent (cont.)
+0:48read_file{"Path":"~/work/lowmarch/docs/vroid.md"}
input
{ "Path": "~/work/lowmarch/docs/vroid.md" }result, 272 lines
Showing lines 1-271 of 271 1: # VRoid base models 2: 3: **Status (2026-11-09):** current. The files carry 57 expression shapes (2.14 exports) or 56 (older), not the 54 below. Licence terms were read by hand on 11-09: see "Licence, read 2026-11-09" below, which replaces the licence notes further down (led #1443). 4: 5: ## Licence, read 2026-11-09 6: 7: Read by hand from pixiv's own pages on 2026-11-09 (headless browser, no login). Page copies and text dumps are in 8: `~/citadel-render/workers/handoff/overnight-1109/lowmarch-prep/pages/`. This is a reading of the terms, not legal advice. 9: The English terms of use are a translation; pixiv says the Japanese original prevails. 10: 11: Sources, with the date each page gives: 12: - **[G]** VRoid Studio guidelines, edited 2023-12-21: <https://vroid.com/en/studio/guidelines> 13: - **[T]** VRoid Studio terms of use, revised 2026-06-24 (articles renumbered then): <https://policies.pixiv.net/en.html#vroidstudio> 14: - **[AZ]** "VRoidPreset_A - Z", the page the 2.14 samples point at, updated 2024-12-26: <https://vroid.pixiv.help/hc/en-us/articles/4402394424089> 15: - **[SC]** "Do VRoid Studio's sample models come with conditions of use?", undated: <https://vroid.pixiv.help/hc/en-us/articles/4402614652569> 16: - **[F]** FAQ "Can I use the models created with VRoid Studio Stable Ver. for commercial purposes?": <https://vroid.pixiv.help/hc/en-us/articles/4405813333657> 17: - **[β1 to β4]** <https://vroid.pixiv.help/hc/en-us/articles/360012381793>, `.../360014900273`, `.../360014900113`, `.../360014900233` 18: - **[SF]** Sakurada Fumiriya <https://vroid.pixiv.help/hc/en-us/articles/360014788554>; **[SS]** Sendagaya Shino <https://vroid.pixiv.help/hc/en-us/articles/360013482714> 19: - **[H]** VRoid Hub terms <https://policies.pixiv.net/en.html#vroidhub>, and the official VRoid Project account's model licences 20: (read from `hub.vroid.com/api/character_models/<id>`, the same JSON the model page shows) 21: 22: ### What we hold, and whose terms apply 23: 24: | Our folder | What it is | pixiv's terms | 25: |---|---|---| 26: | `avatarsample_d` to `_g` (OpenGameArt) | Not the 2.14 D to G. They are β Ver AvatarSample_1 to 4: Sendagaya Shibu, Vivi, Vita, Victoria Rubin (file titles match the Japanese β pages) | CC0 [β1 to β4]. The official Hub copy of β1 also allows everything, credit unnecessary [H] | 27: | `sakurada_fumiriya`, `sendagaya_shino` | VRoid's mascots | CC0 [SF] [SS]. Official Hub copies allow everything, credit unnecessary [H] | 28: | `hairsample_male`, `hairsample_female` | alpha-era hair samples | CC0 [SC] | 29: | `base_male`, `base_female` (OpenGameArt) | alpha-era bases, Studio 0.14 exports | **Unclear.** [SC] lists "Base models" under CC0, as a picture of the 2021 bases. [G] says "All content provided by pixiv, including the base models when creating a new avatar, is not CC0." Either way [T] Art. 13 licenses them for any purpose | 30: | `samples_2_14/avatarsample_a` to `_z` | VRoidPreset A to Z, from Studio 2.14 | [AZ]: not CC0, any use, no credit, a list of prohibited acts (below) | 31: | `lowmarch_bodies/base_masc`, `base_fem` | Studio 2.14 new-model bases | Provided Content under [T] Art. 13: any purpose, not CC0 [G] | 32: | `faces/face_sexy.vrm`, our armory bodies | our own outputs | Ours, except the pixiv content inside them, which keeps its own terms [T] Art. 11 | 33: 34: The armory bodies are built on `base_masc`/`base_fem` with A to Z faces and hair, so [T] and [AZ] are the terms that 35: matter for them. 36: 37: ### 1. A character made in VRoid Studio from scratch 38: 39: Allowed: ship it in a game, sell the game, show it on a public page, post renders on a public blog, change it in code. 40: - Rights: "The copyright and other rights for textures and hair meshes you created from scratch on VRoid Studio or other 41: tools belong to you, the creator." The body and clothing meshes and presets are pixiv's, licensed "so that you can use 42: it for as wide a range of purposes as possible." [G] 43: - Licence: pixiv grants "a non-exclusive, perpetual, worldwide, non-transferable, non-sublicensable license to use, 44: duplicate, archive, modify, and display Provided Content ... for (1) any purpose and (2) any use, except where 45: different license conditions are specified and displayed for individual items" [T] Art. 13. 46: - Games, sale, web pages, renders: "You can use images and videos of models created with VRoid Studio and generate 47: profit from videos, books, ... games, applications, software, collections of materials, websites" and "You can sell 48: the model data exported from VRoid Studio." [G] 49: - Changing it in code: "You can edit and use the model data exported from VRoid Studio using software other than VRoid 50: Studio." [G] 51: - Limits: items with their own clause keep it ("When using items that display special licensing terms, please observe 52: those specific terms" [G]); nothing may suggest pixiv backs it ("refrain from creating any publication or video 53: production that leads people to believe it was created in collaboration with VRoid Studio or pixiv Inc." [G]); and 54: the character-creator rule in 3. 55: 56: ### 2. The sample avatars 57: 58: - **β 1 to 4 (our old D to G), Sakurada Fumiriya, Sendagaya Shino:** all of the above, with no conditions. "The CC 59: license* for this model is CC0. This model can be edited and used freely." [β1] [SF] [SS] 60: - **A to Z (2.14):** game, sale, public page, blog renders and code changes are allowed. "This model's .vroid and VRM 61: files can be used by anyone in any kind of activity, be it for-profit or not." Examples given: "Edit its texture and 62: parameters, and create an original 3D character" and "Edit its texture and parameters, upload it to BOOTH for sale to 63: others." [AZ] Prohibited, among others [AZ]: 64: - "Distributing a sample model or its VRM file to a third party by setting the 'Redistribution and alteration' 65: conditions of use to 'Copyright Disclaimer (CC0)'." 66: - "Development of a character creation service using data contained in the sample model, or diversion of data 67: contained in the sample model to an existing character creation service." 68: - "Redistributing the .vroid or VRM file of the sample model (or other data such as image data within the model) in 69: exchange for a fee." 70: - "Acts that can lure people into thinking that the Company supports or recommends some product/event." 71: - pixiv may narrow the terms later: "it's possible that the conditions of use may be limited if there are incidents". 72: - **Unclear:** whether a paid game that ships a sample's textures unedited (our faces keep each sample's iris, 73: highlight, brow and eyeline drawings as they are) counts as redistributing "image data within the model" for a fee. 74: Edited and sold is allowed; how much editing is enough isn't said. 75: - **Metadata against the page:** for our use, pixiv's page wins. The licence fields in our 2.14 exports 76: (`Redistribution_Prohibited`, `OnlyAuthor`, commercial `Disallow`) were set at our export, not by pixiv: "Users will 77: be licensed to set licenses freely for VRM data constituting Output Items, as long as they do not breach the license 78: conditions for Provided Content" [T] Art. 12. They bind whoever receives our file, not us. pixiv's own terms for its 79: items apply to us: "Where the Company has specified and displayed license conditions for individual items of Provided 80: Content, Users will use such Provided Content in accordance therewith" [T] Art. 13. No page states a precedence rule 81: in so many words; this is a reading of those two articles. The OpenGameArt files carry pixiv's own metadata (a VRoid 82: Hub licence allowing everything, or CC0), which agrees with the pages. 83: - If we ever hand out VRM files built on A to Z, their licence field must not be CC0 [AZ]. 84: 85: ### 3. A player-facing character creator 86: 87: Confirmed: it needs a separate licence from pixiv, and pixiv may refuse. 88: - "Users are not licensed to use Provided Content, or 3D models or Output Items containing Provided Content, to create 89: applications having functions that allow avatars, items, or other 3D models to be created by deforming meshes or 90: combining meshes or textures. When a User wishes to create an application containing such a function, they must 91: receive a separate license from the Company; provided, however, that this does not apply when the User is creating 92: the application for personal use." [T] Art. 13; also a prohibited act in [T] Art. 7. 93: - "Please contact us if you'd like an application creation license. It's possible that we may decline granting you a 94: license." [G] [F] 95: - [AZ] prohibits a creator built on A to Z data outright and names no licence route. 96: - So our own build tools are fine (personal use), and baked characters in a game are fine. A creator in the game, built 97: on anything from Studio 2.x or A to Z, needs pixiv's licence. 98: - **Unclear:** whether CC0 parts alone (β 1 to 4, the mascots, the hair samples) would escape this. CC0 waives 99: copyright, but [T] is a contract we agreed to by using Studio, and our exports pass through it. Not settled by the 100: pages. 101: 102: ### 4. Credit lines 103: 104: None required. 105: - A to Z: "There is no need to credit the original creator when using this sample model." [AZ] 106: - CC0 models: "Copyright is waived, and there is no particular limit when using them." [β1] 107: - Official VRoid Hub copies: `credit: unnecessary` [H]. 108: - Studio outputs: [G] and [T] ask for none (none found). [G] asks only that nothing implies pixiv's backing, and notes 109: "VRoid is a trademark or registered trademark of pixiv Inc." 110: 111: ### Superseded 112: 113: The licence notes further down (the table's "Licence in the file", the yomox9 D to Z note, "That page is behind a 114: Cloudflare check and wasn't read") predate this read. Where they differ, this section holds. 115: 116: Since 2026-10-08 our portraits (and later battle sprites) are rendered from VRoid sample models 117: through our own pipeline. VRoid supplies a professionally built anime head, hair, body, skeleton and 118: 54 expression shapes. Pose, archetype reshaping, hair swaps, colours, shading, outlines and the 119: reduction to GBA pixels are ours. 120: 121: ## Where they live 122: 123: `~/.local/share/lowmarch/vroid/<name>/*.vrm` (override with `LOWMARCH_VROID`). They are 11–17 MB 124: each and stay out of the repo. Source: <https://opengameart.org/content/vroid-studio-cc0-models>. 125: 126: | Model | Licence in the file | 127: |---|---| 128: | Base_Male, Base_Female, HairSample_Male, HairSample_Female | CC0 | 129: | AvatarSample D–G, Sakurada Fumiriya, Sendagaya Shino | VRoid Hub licence: everyone, commercial use allowed, modification allowed, redistribution allowed, credit unnecessary | 130: 131: The last two are VRoid's mascot characters. Use their parts (hair), not their look. Our characters 132: are built from the CC0 bodies. 133: 134: **AvatarSample A–Z (researched 2026-10-09):** exported by `tools/winvroid` into `samples_2_14/avatarsample_<x>/` (apart from the older D–G above, which are other characters). 135: All 26 were exported on 2026-10-10 (VRM 0.0, VRoid Studio 2.14, 15 to 22 MB each). They are clothed 136: exports, so VRoid has deleted the body skin under their clothes: use their heads and hair, not their bodies. 137: 138: **VRoid's own bases, unclothed (2026-10-10):** `lowmarch_bodies/base_masc.vrm` and `base_fem.vrm`: a new 139: character from the Masc or Fem base at default settings, every outfit category set to none, exported as 140: VRM 0.0 (`python3 tools/winvroid/winvroid.py bases`). They keep all their skin (10,934 body triangles; 141: the old `base_male/Base_Male.vrm` export has 7,340). The briefs and band are painted on the skin texture, 142: not geometry. `tools/mass.py` builds on `base_masc.vrm`. 143: VRoid Studio 2.1.0 and later ship 26 144: sample avatars. The VRoid Project account on VRoid Hub publishes A–C with VRoid Hub's licence: 145: - everyone may use them; 146: - corporate commercial use is allowed; 147: - modification and redistribution are allowed; 148: - no credit is needed. 149: 150: D–Z are on VRoid Hub only as exports by another user (yomox9, character 2175138617022572467). Their 151: files carry the same terms in VRM 1.0 metadata (`commercialUsage: corporation`, 152: `allowModificationRedistribution`, credit unnecessary), pointing at pixiv's "AvatarSample A-Z" help page. 153: That page is behind a Cloudflare check and wasn't read. Take them from VRoid Studio itself, or the 154: official account where it has them. 155: 156: What the set offers: 157: - about 9 male and 17 female faces, all young and slim, two of them adult men (T, V); 158: - different eye drawings, hair and outfits. 159: 160: **VRoid Studio's guidelines** (vroid.com/en/studio/guidelines, read 2026-10-09): 161: - **Allowed:** models made in VRoid Studio may be sold, edited in other software, and used in games. 162: - **Restricted:** "You cannot create an application that can generate or output 3D models, avatars, 163: or items consisting of deformed or combined meshes and textures that were created in VRoid Studio" 164: without a separate licence from pixiv. Tools meant only for your own use are exempt. 165: - **For us:** our build pipeline (the graft, the costume kit) is for our own use, and shipping baked 166: characters in the game is fine. A player-facing character creator built on VRoid parts would need 167: pixiv's licence. 168: 169: ## Heads (`tools/heads.py`, 2026-10-13) 170: 171: The armory's bodies all wore VRoid's base face. A head is now one of the 26 samples' faces on our base: 172: - **One template:** every VRoid face mesh has the same skin, eye-white and mouth triangles and texture coordinates 173: (4,232 skin triangles in each), so a face moves vertex for vertex. The irises, highlights, brows and eyelines are 174: each sample's own geometry: that is where its eye drawing lives, and it comes along whole. 175: - **Only the face is taken:** eyes, nose, mouth, cheeks and jaw, fading out up the forehead, toward the ears and toward 176: the seam with the body. VRoid's face mesh is the head's front; the back of the skull is in the body mesh, and the 177: seam between them runs from the neck to the crown. Taking a sample's whole front set its skull against the base's 178: back, and VRoid's hair base (the short cap) couldn't sit on both. The base's skull, ears, seam and cap stay. 179: - **Also taken:** the sample's 57 expressions (the same names, in the same order, in every model), its skin weights 180: mapped by bone name, its eye bones (so the eyes turn about their own centres), and its eye, brow, eyeline and mouth 181: materials. The face skin keeps the base's texture, so the skin tone matches the body. 182: - **Sculpted in the file:** the face controls of `tools/vroid_portrait.py` (lower-face length, jaw, chin, cheek, brow 183: ridge, nose, eye size and tilt, iris, mouth), with one rule for the face and the neck so the seam holds. The checks 184: then measure the face that is shown. 185: - **Blends:** a face spec's `sample` may be several samples with weights; the face's shape is their weighted mean 186: (one template, so a blend stays coherent from every angle) and the first gives the eye drawing and expressions. 187: - **Not fitted (2026-10-13):** `heads.fitted` can move the lower face's length, the cheeks and the eye size until a 188: face archetype's ratios pass (`docs/proportions.md`), but the armory doesn't use it. Those ratios were measured on 189: the study's paintings, mostly seen from the front; held to them, faces were stretched (lower faces up to 17% 190: longer, eyes 20% larger) and read too sharp from the side and too wide from the front. VRoid's faces all set the 191: eyes low (0.56 to 0.64 of the head down from the crown), the young look; the study's adults have them at 0.40 to 192: 0.58. The armory's faces are VRoid's as built, chosen and blended by look, and the ratios are reported. 193: - **Then the cage** (`tools/cage.py`, a spec's `face`) builds the body on the headed base and sizes the head to its 194: reference's, so head size stays held in metres. 195: 196: What the face rests in (a frown, half-closed eyes) and age lines are drawn when the figure is built, not in the file. 197: 198: ## Tools 199: 200: - `tools/vrm.py`: VRM/glTF loader (meshes, materials, textures, morph targets, skins) and a numpy 201: z-buffer rasterizer with alpha testing. 202: - `tools/vroid_portrait.py`: `Portrait(model, morphs, pose, shape, hair_from)` and `.render(yaw)` 203: give a 96×80 char grid; `image(char, palette=...)` gives a PNG; `smooth_view()` shows the 3D model. 204: - `tools/outfit.py`: costume pieces generated in code and fitted to the posed body (`COSTUMES`). 205: - `art/cast/cast.py`: one entry per character (base model, hair donor, shape controls, colours, costume). 206: 207: ## Notes 208: 209: - VRoid models face −z; `FLIP` turns them toward the camera. Character's left is −x. 210: - They stand in a T-pose. `BUST_POSE` lowers the arms through linear blend skinning. 211: - Expression names end in `Fcl_EYE_Close`, `Fcl_MTH_A`, `Fcl_ALL_Joy` and so on; match the suffix 212: exactly (`_Close` also prefixes `_Close_L`). 213: - The eyeline texture is a thick graded band over the iris. Only texels darker than `LID_CORE` 214: count as the lash line, or the eyes read as half shut at 1×. 215: 216: ## Review tooling 217: 218: `python3 review/vroid-02/build.py aldric` builds the model viewer: `bust`/`battle` GLB models 219: (`tools/export_glb.py`), pixel frames every 15°, and `camera.json` so the three.js orthographic 220: camera matches the pixel camera exactly. `tools/poses.py` holds poses (BUST, BATTLE_IDLE, `fist`), 221: `tools/terrain.py` holds battle ground (`plains`). 222: 223: ## Hair (`tools/heads.py`, 2026-10-13) 224: 225: A head spec's `hair` names a sample whose hairstyle goes on. Every VRoid head matches point for point (the face skin, 226: and the 562 vertices of skull in the body mesh, by texture coordinates), so the style is warped from its sample's 227: head onto ours (a similarity plus the matched points' residuals spread by inverse distance) and held 1.5 mm off the 228: skin. It keeps its hair base (HairBack), which replaces the base's; its hair bones (only those its mesh moves with: 229: the samples' skins list accessory ears too, and the weightless end bones that say where a lock's last bone points); 230: its spring groups; and its head's collision sphere, warped onto our head. `tools/cage.py` scales the head's sphere 231: and the hair's spring radius with the head. Hair colour is the character's. 232: 233: **Collision (`tools/collide.py`, 2026-10-13).** Spring bones collide only with spheres the model carries 234: (`secondaryAnimation.colliderGroups`); every runtime that plays a VRM (UniVRM, three-vrm, the review page) runs 235: those and nothing else, so what the hair can't pass through is set here, not by the engine. The samples' body 236: spheres were sized for VRoid's slim sample bodies, with none over the back or bust, and v11's hair sank up to 237: 6 cm into our bodies' upper backs, shoulders and napes. Now, on each finished body, `tools/cage.py` calls 238: `collide.hair`: 239: - **Spheres fitted to the skin:** medial balls (each touching the skin at a point, as large as fits inside), chosen 240: greedily until all the skin the hair can reach (within a lock's length below its joints; the shoulders and upper 241: arms whole once the hair reaches them) stands within 1 cm of one. Each rides the bone most of its skin is 242: weighted to, the breasts' spring bones included. They stand 2 cm out from the skin: a lock's bone runs down its 243: middle, and VRoid's locks stand a median 2.3 cm round it, so a bone held at the skin left the lock in it. That 244: comes to 30 to 60 spheres per body. 245: - **The hair draped at rest:** each lock's bones, root to tip, keep their own way unless the body is in it. A bone 246: is turned until its whole length (not only its tail: the body bulges between two joints) is out of the spheres 247: and the mesh it carries stands off the skin, and what no turn can lift (points the head carries) is pushed off. 248: That is the bind pose, so the hair starts where it rests, not inside the body. 249: - **The check:** `tools/hair_check.py` replays the page's spring bones (Still, Twist, Bounce; arms out or down) and 250: counts hair vertices inside the skin. 251: 252: ## Designing faces in VRoid Studio (first session, 2026-10-13) 253: 254: - **The face editor** (Face tab) has 89 sliders: eye size, position and slant, eyelids, droopy and scornful eyes, 255: iris size, brows, nose, mouth and lips, teeth, ears, jaw, chin and cheeks, and masculine and feminine blends of 256: each feature. Its **Face Sets** are presets that set many sliders and textures at once (eye, lash and brow 257: drawings, lips, blush). Several read more adult than any of the 26 samples. 258: - **The sliders are subtle:** a step of 0.2 to 0.3 barely shows at full-head zoom. Presets move the face far more. 259: - **A face made there transplants like a sample:** export it (`winvroid.export_vrm`) to `faces/` under 260: `LOWMARCH_VROID`, and name it in a head spec (`cast._head(face="faces/....vrm", makeup=True)`; `makeup` keeps its 261: lips, blush and eye shadow, which live on the face's skin texture). 262: - **First result:** one face, the sexy woman's, from preset 11 (lashes, almond eyes, fuller lips) with a longer chin, 263: sunken cheeks, heavier lids and upturned corners. In the painted renderer its glossy eyes and blush read cuter, 264: not sultrier, so it was kept aside (`faces/face_sexy.vrm`). Next time: start from a narrower-eyed preset (3 or 5) 265: and change the iris to one with small highlights. 266: - **The driver** (`tools/winvroid`): the parameter panel scrolls smoothly and is long (89 rows), so a row search 267: waits for it to settle and scrolls 140 ticks to the top. A notification toast took the foreground from VRoid 268: repeatedly and Windows refused to give it back; `front()` now falls back to a real click on VRoid's own title bar, 269: checked to be VRoid's window. **That change stopped the session:** it rebuilt the driver's helper DLL (V.dll), and 270: Windows' application control ("An Application Control policy has blocked this file") refuses to load the new, 271: unsigned build. The PC's owner has to allow it before the driver works again.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.