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

4.5 KiB
Raw Blame 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.