rinkplanner/docs/findings-2026-10-31-arp-rig.md

121 lines
4.5 KiB
Markdown
Raw Normal View History

# Findings 2026-10-31 – AutoRigPro, Skater-Rig und Asset-Pipeline
## Ziel
Prüfen, ob sich die GenAI-Skaterin mit AutoRigPro in Blender 5.2 riggen
lässt, ob der Export nach Godot trägt und wie die externen Assets
reproduzierbar ins Projekt kommen.
## Ausgangsdatei
`workbench_rinkplanner/inbox/figure_skater_blades_aligned.glb`
| Eigenschaft | Wert |
| :--- | :--- |
| Mesh | 8.188 Vertices, 13.956 Dreiecke, 1 Objekt |
| Topologie | 37 zusammenhängende Inseln, 2.346 offene/Non-Manifold-Kanten |
| Texturen | 3 × 2048² PNG (BaseColor, Normal, MetallicRoughness) |
| Maße | 1,66 × 0,35 × 1,90 m, Füße bei Z = 0 |
| Ausrichtung | T-Pose, Blick +Z, Pivot Körpermitte |
| Animation | keine, kein Skelett |
## AutoRigPro
- ARP liegt als Blender-5.2-Extension unter
`~/.config/blender/5.2/extensions/superhivemarket_com/`.
- Die AI-Marker-Dateien fehlen (`~/Dokumente/AutoRigPro/AI` existiert nicht).
Die Marker wurden deshalb skriptbasiert gesetzt:
Neck, Chin, Head Tip, Root, Thigh, Knee, Foot, Shoulder, Elbow, Hand,
Hand Tip.
- Smart Rig mit `arp_smart_sym = True`, Finger aus, Bind-Engine
`PSEUDO_VOXELS`.
- Ergebnis: 226-Bone-Control-Rig, 33 Deform-Bones, Bindung in 1,3 s.
### Befund: erste Platzierung war falsch
Der erste Lauf setzte die Beinkette zu weit außen:
| Knochen | erster Lauf | korrekt |
| :--- | ---: | ---: |
| Fuß x | 0,24 | 0,10 |
| Knie x | 0,17 | 0,095 |
| Hand z | 1,17 | 1,50 |
Die Reference-Bones waren bereits korrekt; nur die Deform-/IK-Kette wich ab.
**`arp.match_to_rig` („Match to Rig")** baut die Deform-Kette aus den
Reference-Bones neu, aktualisiert die Gewichte und setzt die Armature-Scale
auf 1,0. Danach sitzen Fuß, Knie, Hand und Schulter exakt auf dem Mesh.
Dieser Schritt ist bei diesem Mesh-Typ Pflicht.
### Testpose
Arm hoch/tief, Bein gehoben, Kopf gedreht, Oberkörper geneigt. Rock, Haare
und Schlittschuhe folgen ohne sichtbare Artefakte. Die Bindung wurde nicht
manuell nachgearbeitet.
## Export
| Variante | Bones | Größe |
| :--- | ---: | ---: |
| vollständiger Control-Rig | 226 | 8,41 MB |
| nur Deform-Bones (`export_def_bones`) | 30 | 8,35 MB |
Der Exporter meldet:
- mehr als 4 Joint-Einflüsse → auf die 4 stärksten gekürzt und normalisiert
- mehrere Shader-Tex-Image-Knoten → Sampler-Warnung, visuell unauffällig
- Constraints nicht glTF-fähig → Animationen werden gebacken
## Godot
- Import über `res://assets/external/characters/`.
- `Skeleton3D` mit 30 Bones, eine skinnende `MeshInstance3D`, AABB
1,659 × 1,898 × 0,352 m, Material `model`.
- Testclip `TestWave`: 2,0 s, 90 Kanäle (3 pro Joint), als
`AnimationPlayer` mit Länge 2,0 s importiert und bei t = 1,0 gerendert.
- Prüfwerkzeuge: `tests/manual/inspect_rig.gd`, `tests/manual/capture_rig.gd`.
## Asset-Pipeline
- `assets/asset_manifest.json` beschreibt ID, Quelle, Ziel, SHA-256, Größe,
Platzierung und Rig-Metadaten.
- `tools/sync_assets.sh --check|--sync [--force]` prüft Quelle und Ziel gegen
den Hash, kopiert nach `assets/external/` und importiert in Godot.
- `assets/external/` ist gitignored.
- Die Phase-1-Export-Presets schließen `assets/external/*` aus; 3D-Builds
brauchen ein eigenes Preset.
- Neuer Test `tests/run_asset_manifest_tests.gd`: 48 Assertions für Schema,
Pfade, Platzierung, Rig-Daten und optional die synchronisierte Datei.
- Gesamtsuite: **1123 Assertions** grün.
## Dateien
```
workbench/source/characters/skater/
├── skater_rig_v002.blend # Produktions-Rig, ohne Testaktion
├── skater_anim_test.blend # Rig + TestWave
├── skater_rig_v001.blend # erster Lauf (vergleichen)
└── skater_rig_test_01.blend # vor dem Rig
workbench/library/characters/
├── skater_figure_rigged_deform_v002.glb # 30 Bones, 8,35 MB
├── skater_figure_anim_test_v001.glb # + TestWave
└── ... (Vergleichsversionen)
```
## Entscheidungen
- **D13:** 3D-Assets bleiben extern; das Repo hält Manifest und Sync-Werkzeug.
- Der Produktions-Rig bleibt im `.blend`; exportiert werden nur Deform-Bones.
- Animationen werden beim glTF-Export gebacken, nicht als Constraints
mitgeschleppt.
- Der Testclip bleibt aus dem Produktions-Rig und aus dem Manifest.
## Offen
- 3D-Rink und Skater im Godot-Prototyp bewegen (Kurven-Sampling aus Phase 1).
- Rotoscoping-Workflow: Referenzvideo, Kamera, Action-/NLA-Konventionen.
- Erste echte Clips (Vorwärtsgleiten, Rückwärts, Pirouette).
- Android: Texturen auf 1K reduzieren oder separater Asset-Pack.
- Workbench-Backup außerhalb des Repos sicherstellen.