- v006 verbessert die Gewichte, aber die sichtbare Falte bleibt - Pose/Twist und offene, einlagige Aermelflaechen sind der naechste manuelle Schritt (Weight Paint, Solidify/Subdivision)
6.2 KiB
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_1vorhanden,- Clip
Glide, 2,0 s, - SHA-256
50a3b84a….
- Manifest auf Version 4 aktualisiert; Control-Bones auf die tatsächlichen
222 korrigiert,
vertex_influences: 8ergänzt. - Lokal synchronisiert und per FTP veröffentlicht.
Skater3D-Fallback auf v004 umgestellt.- Die Rotoscoping-Werkbank exportiert ebenfalls mit
export_all_influences=Trueund warnt, wennJOINTS_1im 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.
Nachtrag: Ringweise Armgewichtung (v005)
Die 8 Einflüsse verhinderten den groben Kollaps, aber die Ärmel blieben flach und knickten am Ellbogen. Die PSEUDO-VOXELS-Gewichte waren über den Arm verteilt:
- Oberarm bei x = 0,40:
arm_stretch0,25,forearm_stretch0,16,spine_030,15,hand0,09,head0,08. - Handgelenk bei x = 0,75:
hand0,36,forearm_twist0,20,spine_030,08.
Die Ärmel sind offene, einlagige Flächen. Unterschiedliche Gewichte rund um den Arm ließen den Querschnitt kollabieren. Ein pauschales Entfernen der Torso-Gewichte faltete die Schulter; eine abgestufte Variante beulte den Oberarm auf.
Die Lösung ist eine ringweise, rein x-basierte Gewichtung der Armregion (0,20–0,85 m, z 1,28–1,72 m):
| x-Bereich | Gewichte |
|---|---|
| 0,20–0,30 | spine_03 → shoulder, arm_stretch |
| 0,30–0,42 | shoulder → arm_stretch |
| 0,42–0,50 | arm_stretch |
| 0,50–0,58 | arm_stretch → forearm_stretch |
| 0,58–0,66 | forearm_stretch |
| 0,66–0,74 | forearm_stretch → hand |
| > 0,74 | hand |
Die Twist-Bones erhalten jeweils 25 % der Arm-/Unterarmgewichtung
(c_arm_twist_offset, forearm_twist). Alle Vertices eines Rings bekommen
dieselben Gewichte; dadurch bleibt der Ärmelquerschnitt erhalten.
Ergebnis:
- neue Quelle
skater_rig_v005.blend, - neues GLB
skater_figure_glide_v005.glb, 8.584.300 Bytes, SHA-256f2b80124…, 8 Bone-Influences, - Manifest Version 5, lokal synchronisiert und per FTP veröffentlicht,
- Ärmel in Blender und Godot rund und ohne flache Knicke.
Nachtrag 2: Gelenkgenaue Ringe (v006)
Die erste Ringgewichtung saß noch an den falschen x-Positionen. Die echten Gelenke liegen bei:
| Gelenk | x |
|---|---|
| Schulter | 0,17 |
| Ellbogen | 0,37 |
| Handgelenk | 0,65 |
Geblendet wurde aber erst bei 0,50–0,58 (Arm → Unterarm) und 0,66–0,74 (Unterarm → Hand). Der Ärmel bog sich dadurch mitten im Unterarm, nicht am Ellbogen – das war der sichtbare Knick von vorn.
Die Bänder wurden auf die Gelenke verschoben:
| x-Bereich | Gewichte |
|---|---|
| 0,20–0,27 | spine_03 → shoulder / arm_stretch |
| 0,27–0,32 | shoulder → arm_stretch |
| 0,32–0,40 | arm_stretch → forearm_stretch (Ellbogen) |
| 0,40–0,50 | forearm_stretch |
| 0,50–0,60 | forearm_stretch → hand |
| > 0,60 | hand |
Ergebnis:
- Quelle
skater_rig_v006.blend, - GLB
skater_figure_glide_v006.glb, 8.584.300 Bytes, 8 Bone-Influences, - SHA-256
3b49dc76…, - Manifest Version 6, synchronisiert und per FTP veröffentlicht,
- Front- und Rückansicht in Godot deutlich runder; der Ellbogen knickt nicht mehr mitten im Unterarm.
Ein kleiner Restknick am Ellbogen bleibt der Geometrie geschuldet (offene, dünne Ärmelfläche). Im App-Maßstab ist der Unterschied zwischen v005 und v006 gering; die Gewichte sind nur ein Teil des Problems. Der Glide-Twist im Unterarm und die einlagige Fläche verstärken die Falte. Nächster Schritt ist manueller Feinschliff: Pose/Twist prüfen, Gewichte glätten und – wenn nötig – Solidify/Subdivision oder eine Ärmel-Retopologie.
Gesamtsuite: 1193 Assertions.
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.
- Die ringweise Gewichtung ist auf die T-Pose und die x-Achse dieses Meshes zugeschnitten; bei einem neuen Skater-Mesh muss sie neu angewendet werden.
Dateien
workbench/library/characters/skater_figure_glide_v006.glb
workbench/source/characters/skater/skater_rig_v006.blend
rinkplanner/assets/asset_manifest.json
rinkplanner/tests/run_asset_manifest_tests.gd
tools/blender/rotoscope.py
rinkplanner/src/presentation3d/skater_3d.gd