jeremy
36fc0494e8
The morph lane's blocking bug was believed to be coincident duplicate verts hidden
from the solver's convergence gate. Welding was necessary but nowhere near
sufficient: the previous relaxation could satisfy every stretch bar without posing
anything, so the numbers it reported were not measuring the thing they claimed.
Measured on Ariki_Female_QuatSkin_LowPoly_40, the tracked "left hand is fully
clean" baseline was a morph that moved fingertips 0.3cm, and the right hand was a
rigid 6.5cm translation of the whole hand with its shape intact. Gated Laplacian
diffusion of a delta field has a null space — constants — and edge stretch cannot
see any of it: a rigid translation stretches no edge and neither does a collapse to
zero. Both exits report perfect bars.
Six defects fixed, each with its measurement in the code comments:
weld_roi 356 duplicate groups solved twice, deltas up to 2.55cm apart
stitch_components hand is 6 overlapping sheets with 1-10mm gaps; Dijkstra
cannot cross one, so each bone saw only its own sheet
refit_fingers skeleton finger chain ran to 19.8cm; the flesh ends at 14.0cm,
so curl_02/curl_03 drove almost no weight (shipped skeleton
untouched — this is solver-local scaffolding)
solve_weights chain-arc partition of unity; the old 8mm isotropic kernels
left ZERO of 17,480 verts owned above 0.85, and a 3-way blend
averages the curl away. Plus a support cutoff: outside every
kernel, renormalized 1e-81 noise had handed a mid-palm vertex
index_02_r=0.50 and flung it 29cm
build_roi joint-sphere ROI, so the rim is a wrist band and not a fractal
of interior chart holes
relax strain-only edge projection + ROI-border seam constraints,
replacing the diffusion described above
All 8 shapes now pass every bar with real deformation: p99.9 <= 1.58x, zero edges
over 5x, zero needles with the sliver floor removed, seam <= 3.2mm, cross-hand
independence exactly 0.0000cm, mesh fingertip travel 4.6-6.2cm on fist and
3.5-4.7cm on grip (both hands). Gates now report mesh travel and seam alongside
stretch, because stretch alone cannot gate this lane.
Verified in anim_hand_test_bed: fist and grip read as a real curl on both hands,
static and mid-dance, no fins/shards/needles. It is a loose fist rather than a
clenched one — her fingers are ~4-5cm past the knuckles.
Demo GLB stays out of git (122.6 MB, ariki-game/scratchpad/). Ship decision, the
thumb-axis refit, and the TDR crash from 8 dense targets are open — see README.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
animation
Jeremy's animation-pipeline hub AND the Mac↔PC bridge for converting files and implementing animations. iClone 8 + Video Mocap live on the PC; Blender 5, the retarget tools, and the ariki-game repo live on both. This repo carries the skills, tools, and the files in flight between machines.
Bridge workflow (Mac↔PC)
-
PC: export FBX from iClone (Blender preset, Range=All, Preserve Bone Names ON) → drop into
exchange/incoming-fbx/→ commit +tinqs push. -
Either machine:
tinqs pull, run the retargeter →blender --background --python tools/cc_retarget.py -- \ --src exchange/incoming-fbx/<take>.fbx \ --out exchange/converted-glb/<pack>.glb --name <ClipName> \ --target <path-to-ariki Superhero_Male_FullBody.gltf>→ commit the GLB +
tinqs push. -
Implementing machine: copy the GLB into ariki-game
assets/quaternius/dancegen/(auto-discovered by ClipCatalog as<pack>/<ClipName>), add a dance JSON, verify in the dance test bed. -
Optional: reference footage for QA goes in
exchange/reference-video/.
Large binaries (.fbx, .glb, .mp4, .task) ride Git LFS — see
.gitattributes. Clean out exchange/ folders once a take has shipped
into the game repo.
Layout
.claude/skills/— Claude Code skills (auto-discovered when running Claude here)animation-creation/— creating clips on the shared Quaternius skeleton: existing packs, Mixamo/Kevin retargeting, composite baking, dance JSON (paths reference the ariki-game repo)iclone-video-mocap/— iClone 8 + Video Mocap plugin advisory: filming rules, workflow, cleanup, FBX export, game integrationpose-estimation/— MediaPipe video→pose-landmark extraction (scripts/extract_pose.py,compare_poses.py; models inmodels/, venv rebuilt viascripts/setup.sh)retarget-animations/— deprecated early retarget notes (kept for history)
tools/— Blender-headless retargeters (all bake onto the Quaternius rig and export mesh-stripped GLB, one NLA track per clip)cc_retarget.py— Reallusion CC/iCloneCC_Base_*FBX (60fps; TempMotion guard)mixamo_retarget.py— Mixamo FBX (prefix auto-detect)kevin_retarget.py— Kevin Iglesias Unity FBX (B-*rig; hardcoded target path — non-portable)mocap_retarget.py— MediaPipe pose JSON → GLB (rotation solving, no source armature)bake_run_punch.mjs— composite upper/lower clip baking reference
AGENTS.md/.agents/— agent context (identity, wiki, plans, rules); seeAGENTS.mdfor the knowledge map
Canonical target rig
All retargeters default to ariki-game's
assets/quaternius/base-characters/.../Godot - UE/Superhero_Male_FullBody.gltf
via a repo-relative path — when running from this repo, pass --target with an
explicit path to that GLTF (or a local copy). Output GLBs are consumed by
ariki-game's ClipCatalog from assets/quaternius/{kevin,mixamo,dancegen}/ as
<pack>/<ClipName>.
Provenance
Copied (not yet removed) from ariki-game tools/ + .claude/skills/ +
.agents/plans/, and ~/.claude/skills/pose-estimation. The ariki-game
originals are still in place; the Windows-side iClone FBX conversion handoff
(ariki-game/.agents/handoff/iclone-fbx-conversion.md) depends on them.