rinkplanner/docs/findings-2026-10-31-arp-rig.md
torsten 0ac0624ba2 fix: Dokumente-Ordner sprachunabhaengig aufloesen
- neues tools/_paths.sh loest den Dokumente-Ordner zur Laufzeit auf:
  xdg-user-dir DOCUMENTS, sonst ~/Dokumente, sonst ~/Documents
- sync_assets.sh und rotoscope.sh nutzen workbench_dir statt
  $HOME/Documents/workbench_rinkplanner
- promote_rotoscope.py und blender/rotoscope.py loesen den Workbench-Pfad
  genauso auf und bevorzugen weiterhin RINKPLANNER_WORKBENCH
- Doku auf den tatsaechlichen Pfad ~/Dokumente/workbench_rinkplanner
  umgestellt
2026-11-01 13:57:02 +01:00

120 lines
4.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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.