# 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. ## 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_stretch` 0,25, `forearm_stretch` 0,16, **`spine_03`** 0,15, **`hand`** 0,09, **`head`** 0,08. - Handgelenk bei x = 0,75: `hand` 0,36, `forearm_twist` 0,20, **`spine_03`** 0,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-256 `f2b80124…`, 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 ```