rinkplanner/docs/findings-2026-10-31-arm-gewichte.md
torsten c0cc2b29f7 fix: Aermel-Skinning mit acht Bone-Influences
- Ursache: glTF-Export trimmte auf vier Einfluesse; Godot liess die
  Aermel an Schulter und Ellbogen kollabieren
- export_all_influences=True fuer Produktion und Rotoscoping
- v004-Asset mit JOINTS_1/WEIGHTS_1, Manifest, Sync und FTP aktualisiert
- Manifest-Test prueft die 8-Bone-Gewichte (57 Assertions)
- 1189 Assertions gesamt, Doku und Findings aktualisiert
2026-10-31 15:24:45 +01:00

2.9 KiB
Raw Blame History

Findings 2026-10-31 – Kollabierende Ärmel im 3D-Export

Symptom

In der Godot-Vorschau sahen die Ärmel der Skaterin zermatscht aus: Die Stoffärmel knickten an Schulter und Ellbogen ein, obwohl die ungeriggte GLB und die Blender-Ansicht sauber aussahen.

Diagnose

Das Mesh hat 3.104 Vertices mit mehr als vier Knochen-Einflüssen, maximal neun. Der glTF-Exporter meldete:

There are more than 4 joint vertex influences.
The 4 with highest weight will be used (and normalized).

Der Blender-Render nutzt alle Einflüsse und zusätzlich use_deform_preserve_volume = True; Godot nutzt Linear Blend Skinning mit der Anzahl, die im GLB steht.

Vergleichsexporte aus skater_rig_v003.blend, jeweils mit dem Glide-Clip:

Variante Einflüsse Hierarchie Godot-Ergebnis
v003 (Produktion) 4 nur Deform-Bones Ärmel kollabiert
influences4_full 4 alle 222 Bones Ärmel kollabiert
influences8_def 8 nur Deform-Bones sauber
influences8_full 8 alle 222 Bones sauber

Damit war klar: Der 4-Einfluss-Trim ist die Ursache, nicht die flache Deform-Hierarchie. Die zusätzlichen Gewichte an den Ärmeln fehlten Godot.

Fix

  • Produktions-Export mit export_all_influences=True.
  • Neue Datei skater_figure_glide_v004.glb:
    • 8.584.300 Bytes,
    • 30 Deform-Joints,
    • JOINTS_1/WEIGHTS_1 vorhanden,
    • Clip Glide, 2,0 s,
    • SHA-256 50a3b84a….
  • Manifest auf Version 4 aktualisiert; Control-Bones auf die tatsächlichen 222 korrigiert, vertex_influences: 8 ergänzt.
  • Lokal synchronisiert und per FTP veröffentlicht.
  • Skater3D-Fallback auf v004 umgestellt.
  • Die Rotoscoping-Werkbank exportiert ebenfalls mit export_all_influences=True und warnt, wenn JOINTS_1 im GLB fehlt.

Test

Der Manifest-Test prüft bei synchronisiertem Asset, dass die importierte Mesh-Oberfläche Mesh.ARRAY_FLAG_USE_8_BONE_WEIGHTS trägt. Damit fällt ein Rückfall auf 4 Einflüsse sofort auf.

  • 3D-Assets: 57 Assertions (vorher 54).
  • 3D-Vorschau: 57 Assertions.
  • Gesamtsuite: 1189 grün.
  • Sichtprüfung: Rückansicht der Ärmel in Godot bei 600 × 600, zusätzlich die normale 3D-Vorschau.

Offen

  • Das Mesh hat weiterhin bis zu neun Einflüsse; der Export behält acht. Die Sichtprüfung ist sauber, bei anderen Bewegungen kann der neunte Einfluss theoretisch fehlen.
  • Blender nutzt Preserve Volume, Godot nicht. Falls künftige Clips an Schulter oder Hüfte zwicken, hilft Weight-Cleanup, nicht ein höherer Einfluss-Export.
  • Ein generischer Export-Check für alle künftigen Assets wäre sinnvoll; aktuell prüft der Manifest-Test nur den Charakter.

Dateien

workbench/library/characters/skater_figure_glide_v004.glb
workbench/source/characters/skater/skater_rig_v003.blend
rinkplanner/assets/asset_manifest.json
rinkplanner/tests/run_asset_manifest_tests.gd
tools/blender/rotoscope.py
rinkplanner/src/presentation3d/skater_3d.gd