- 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
83 lines
2.9 KiB
Markdown
83 lines
2.9 KiB
Markdown
# 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
|
||
```
|