rinkplanner/docs/findings-2026-11-12-tripo-skater-rig.md
torsten 9f115764d0 feat: Tripo-Skater riggen und Glide anbinden
Neues Mesh über die Tripo-Pay-as-you-go-API erzeugt (v3.1, 60k Faces,
Textur v3.5, 30 Credits), lokal mit AutoRigPro geriggt und mit einem
Rotations-Retargeting an den bestehenden Glide-Clip angeschlossen.

- neues Manifest-Asset character.skater.figure_tripo_glide (v007,
  59.350 Dreiecke, 30 Deform-Bones, 4 Einflüsse, Glide 2-s-Loop)
- Skater3D lädt das neue Asset; Klingenabstand auf ±0,154 m gesetzt
- check_export.sh prüft GLB und Textur der v007
- Ablauf und Stolpersteine in docs/findings-2026-11-12-tripo-skater-rig.md
- assets.md: Bestand, Export-Presets und Lizenzlage aktualisiert
- Lizenz-Log um den Tripo-Task ergänzt
- AGENTS.md: Tripo ist die 3D-Quelle, fal nur noch für Bilder

Der unrigged 30k-Eintrag bleibt als Zwischenstand dokumentiert.
2026-11-12 05:51:09 +01:00

5.8 KiB
Raw Blame History

Findings – Tripo-Skater riggen und Glide retargeten (2026-11-12)

Ziel

Aus dem Tripo-Mesh einen Spielcharakter machen: riggen, den bestehenden Glide-Clip übernehmen, als GLB exportieren und in Skater3D anbinden. Kostenrahmen: nur ein Tripo-Lauf, kein fal.

Ausgangslage

  • Mesh: tripo3d/h3.1/image-to-3d über die Tripo-Pay-as-you-go-API (Task d8ee7a30-c1dc-4873-8770-4747d98a62ff), 60.000-Face-Budget, Textur v3.5, Referenz flux2pro_reference_front.png, 30 Credits.
  • Ergebnis: 59.350 Dreiecke, 34.103 Vertices, 1,70 m, Pivot in der Körpermitte, Blick +X, A-Pose mit leicht geöffneten Armen.
  • Vergleich zur Produktionsfigur (skater_figure_glide_v006.glb): 1,898 m, 13.956 Dreiecke, 30 Deform-Bones, Glide als 2-s-Loop.

Stolperstein 1: Rig-Transfer von der Produktionsfigur scheitert

Erster Versuch war, die 30-Bone-Armatur der Produktionsfigur zu behalten, das neue Mesh auf 1,898 m zu skalieren und mit ARMATURE_AUTO (Bone-Heat) zu binden. Der Bind lief ohne Fehler durch, das Ergebnis war aber unbrauchbar: Ärmelstücke, Rockfragmente und Handpartien hingen als freie Inseln im Raum, weil die Gelenkpositionen des alten Rigs nicht zu den Proportionen des neuen Meshes passen und die Tripo-Topologie aus vielen Inseln besteht. Bone-Heat scheitert hier still, nicht mit einer Fehlermeldung.

Konsequenz: Rig muss zum Mesh passen. Also AutoRigPro.

Stolperstein 2: AutoRigPro headless

ARP ist ein UI-Addon. Die relevanten Stellen:

  • arp.append_arp(rig_preset='human') bricht in blender -b ab, weil bpy.context.space_data.overlay in der Konsole None ist. Der Abbruch passiert nach dem Anlegen der Referenzknochen, aber vor Treiber- und Layer-Konvertierung – einfaches Abfangen reicht deshalb nicht.
  • Lösung: Blender mit GUI starten (DISPLAY=:0), den Aufruf in bpy.context.temp_override(window=…, screen=…, area=…, region=…) legen und die Arbeit aus einem bpy.app.timers-Callback starten. Direkt beim Skriptstart ist bpy.context.window_manager.windows noch leer.
  • bpy.ops.wm.quit_blender() am Ende, sonst hängt der Prozess.

Ablauf, der funktioniert

  1. Mesh vorbereiten – Transformationen direkt in die Mesh-Daten backen (mesh.data.transform(...)), nicht per transform_apply: der Operator lief im Timer-Kontext still ins Leere, sodass Skalierung und Rotation nie ankamen. Danach: Drehung um −90° um Z (Blick −Y, ARP-Vorne), auf 1,70 m skalieren, Füße auf Z = 0, in X/Y zentrieren.
  2. Smart-Modus – bpy.ops.id.get_selected_objects('EXEC_DEFAULT') mit ausgewähltem Mesh. Legt body_temp und die Marker-Sammlung an, scene.arp_body_name zeigt danach auf die Kopie.
  3. Marker setzen – bpy.ops.id.add_marker('EXEC_DEFAULT', body_part=…) für root, neck, chin, head_tip, shoulder, elbow, hand, hand_tip, thigh, knee, foot. Die rechte Seite entsteht automatisch als _loc_sym mit gespiegelter Copy-Location. arp_fingers_enable = False, arp_smart_sym = True, arp_bind_engine = 'PSEUDO_VOXELS'.
  4. Erkennen – bpy.ops.id.go_detect('EXEC_DEFAULT'). Meldet „Could not find wrist/shoulder, marker out of mesh“, wenn ein Marker neben dem Mesh liegt; dann Marker nachjustieren, nicht das Rig.
  5. Match to Rig + Bind – bpy.ops.arp.match_to_rig() und bpy.ops.arp.bind_to_rig() mit Mesh plus Armatur ausgewählt (Armatur aktiv). Ergebnis: 222 Control-Bones, 30 gewichtete Deform-Bones, 4 Einflüsse pro Vertex.
  6. Glide retargeten – Produktions-GLB zusätzlich importieren, pro Frame die Weltrotation jedes Quell-Bones relativ zu seiner Ruhepose berechnen (delta = pose_src · rest_src⁻¹) und daraus die lokale Basis des Ziel-Bones ableiten. Nur Rotationen, keine Translationen – sonst wandert die Figur wegen der unterschiedlichen Hüfthöhe nach oben. Die Namen sind zwischen beiden Rigs identisch (thigh_stretch.l, leg_stretch.l, arm_stretch.l, …), weil die Produktionsfigur ebenfalls aus ARP stammt.
  7. Export – use_deform nur für die 30 gewichteten Bones, alle anderen Aktionen löschen, damit der Clip exakt Glide heißt (sonst exportiert Blender Glide.001 und Skater3D findet ihn nicht).

Messwerte

Wert Produktion (v006) Neu (v007)
Dreiecke 13.956 59.350
Höhe 1,898 m 1,700 m
Deform-Bones 30 30
Einflüsse/Vertex 8 4
Glide 48 Frames / 2 s 48 Frames / 2 s (retargetet)
Klingen x ±0,065 m ±0,154 m
Dateigröße 8,59 MB 2,71 MB

Der Klingenabstand steht als BLADE_LATERAL_OFFSET_M in skater_3d.gd und muss bei einem Figurenwechsel mitgezogen werden, sonst liegt die Kufenspur neben den Schlittschuhen.

Bewertung

  • Der Bind ist stabil: Arme über Kopf, Knie angehoben und Glide hinterlassen keine Risse oder abgerissenen Inseln.
  • Der Rock bleibt starr am Becken; ein angehobenes Bein kann den Schlittschuh durch den Rock schieben. Für die Vorschau akzeptabel, für Sprünge nicht.
  • Gesicht und Hände bleiben die Schwachstellen des Meshes (geschlossene Lider, spitz zulaufende Ohren, verschmolzene Finger). In der Vorschau-Distanz unsichtbar, in Nahaufnahmen sichtbar.
  • Glide ist ein subtiler Loop; das Retargeting validiert die Zuordnung, nicht die Deformation unter starker Bewegung. Ein Stresstest mit echten Clips (Pirouette, Sprung) steht aus.

Artefakte

  • Rig-Quelle: source/characters/skater/skater_rig_v007.blend (Workbench)
  • GLB: library/characters/skater_figure_glide_v007.glb → rinkplanner/assets/external/characters/skater_figure_glide_v007.glb
  • Zwischenschritte und Vergleichsrender: ~/Downloads/rinkplanner_skater_tripo_v002/ (arp_markers_v2.blend, arp_matched.blend, arp_bound.blend, arp_glide.blend, glide_new_sheet.png, arp_ik_test.png)