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
This commit is contained in:
torsten 2026-10-31 15:24:45 +01:00
parent 894f3d950d
commit c0cc2b29f7
10 changed files with 180 additions and 33 deletions

View file

@ -3,8 +3,8 @@
Stand: 2026-10-31
Grundlage: `rinkplanner/rinkplanner_definition_agent_guidelines.md`
Übergeordnete Reihenfolge: `docs/roadmap.md`
Letzte Session: `docs/findings-2026-10-31-kufenspur.md`
(Session davor: `docs/findings-2026-10-31-rotoscoping.md`)
Letzte Session: `docs/findings-2026-10-31-arm-gewichte.md`
(Session davor: `docs/findings-2026-10-31-kufenspur.md`)
## 1. Leitentscheidung
@ -221,6 +221,14 @@ Wiedergabe stoppt, läuft sie in Echtzeit aus. Bei Positionssprüngen über
1,5 m, Zeit-Rücksprüngen oder `clear_pose` wird sie verworfen. Sie schreibt
keine Modelldaten und ist nur in der 3D-Vorschau sichtbar.
**D17 – Charakter-Exporte behalten acht Bone-Influences.**
Der Skater hat bis zu neun Gewichte pro Vertex, besonders an den Ärmeln.
Der glTF-Standardexport trimmt auf vier und lässt die Ärmel in Godot
kollabieren. Alle Charakter-Exporte setzen `export_all_influences=True`;
Godot importiert `JOINTS_1`/`WEIGHTS_1` und nutzt 8-Bone-Skinning. Der
Manifest-Test prüft `ARRAY_FLAG_USE_8_BONE_WEIGHTS`. Vier Einflüsse sind für
diesen Rig nicht zulässig.
## 4. View- und Controller-Grenzen
- **View** (`Node2D`/`Control`) liest das Modell und zeichnet. Sie verändert
@ -490,9 +498,9 @@ Aktueller Stand:
PASV/EPSV/MDTM-Parsing, Sync-Stand und die Einstellungs-Verdrahtung.
Der FTP-Client wurde zusätzlich gegen den echten Zielserver geprüft
(Upload, Download, Übernahme, Konflikt, Aufräumen).
- **3D-Assets:** 54 Assertions für Manifest-Schema, Pfade, FTP-Pfade,
- **3D-Assets:** 57 Assertions für Manifest-Schema, Pfade, FTP-Pfade,
Platzierung, Rig-Metadaten, Animationen, Hashes und – falls synchronisiert
– Größe und SHA-256 der GLB-Datei.
– Größe, SHA-256 sowie die 8-Bone-Gewichte der GLB-Datei.
- **3D-Vorschau:** 57 Assertions für Koordinatenabbildung, Rink-Geometrie,
Kamera-Modi, Platzhalter-Fallback, Kufenspur (Farbe, zwei Kufen, Reset,
Abbau am Kür-Ende) und den 2D/3D-Moduswechsel samt geteilter

View file

@ -125,14 +125,14 @@ eine still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
```json
{
"id": "character.skater.figure",
"version": 3,
"version": 4,
"kind": "character",
"format": "glb",
"source": "library/characters/skater_figure_glide_v003.glb",
"target": "assets/external/characters/skater_figure_glide_v003.glb",
"remote": "characters/skater_figure_glide_v003.glb",
"sha256": "f45858cd…",
"bytes": 8420244,
"source": "library/characters/skater_figure_glide_v004.glb",
"target": "assets/external/characters/skater_figure_glide_v004.glb",
"remote": "characters/skater_figure_glide_v004.glb",
"sha256": "50a3b84a…",
"bytes": 8584300,
"source_scene": "source/characters/skater/skater_rig_v003.blend",
"placement": {
"up_axis": "Y",
@ -143,8 +143,9 @@ eine still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
},
"rig": {
"type": "humanoid",
"control_bones": 226,
"control_bones": 222,
"deform_bones": 30,
"vertex_influences": 8,
"bind": "PSEUDO_VOXELS"
},
"animations": [
@ -188,7 +189,7 @@ eine still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
| ID | Datei | Größe | Rig | Clips |
| :--- | :--- | ---: | :--- | :--- |
| `character.skater.figure` | `skater_figure_glide_v003.glb` | 8,42 MB | 226 Control / 30 Deform | `Glide` (2-s-Loop) |
| `character.skater.figure` | `skater_figure_glide_v004.glb` | 8,59 MB | 222 Control / 30 Deform, 8 Einflüsse | `Glide` (2-s-Loop) |
Die 3D-Vorschau lädt die Datei über die Manifest-ID
`character.skater.figure`. Fehlt sie, erscheint ein Platzhalter aus
@ -226,8 +227,10 @@ die Manifest-ID `character.skater.figure` und spielt derzeit `Glide`.
5. Animationen auf dem Control-Rig erstellen (IK/FK, Fußrollen, Root Motion).
Der erste Clip ist `Glide`: Arme unten, 2-s-Loop, im `.blend`
`skater_rig_v003.blend`.
6. Export mit `export_def_bones=True`; der Exporter backt Constraints
automatisch. Im GLB landen nur die 30 Deform-Bones.
6. Export mit `export_def_bones=True` und **`export_all_influences=True`**;
der Exporter backt Constraints automatisch. Im GLB landen nur die 30
Deform-Bones, aber **8 Bone-Influences pro Vertex**. Mit dem Standard-
Export (4 Einflüsse) kollabieren die Ärmel in Godot.
7. Ergebnis in Godot prüfen (`tests/manual/inspect_rig.gd`,
`tests/manual/capture_rig.gd`); die 3D-Vorschau mit
`tests/manual/capture_3d.gd`.
@ -245,6 +248,7 @@ Details und Messwerte: `docs/findings-2026-10-31-arp-rig.md`.
## Tests
`tests/run_asset_manifest_tests.gd` prüft Schema, Pfade, FTP-Pfade, Hashes,
Animationen und – falls synchronisiert – Größe und SHA-256 der Zieldatei.
Fehlt das Asset (z. B. in CI), wird der Dateicheck übersprungen, der
Schema-Test bleibt aktiv. Aktuell: 54 Assertions.
Animationen und – falls synchronisiert – Größe, SHA-256 sowie die
8-Bone-Gewichte der Zieldatei. Fehlt das Asset (z. B. in CI), wird der
Dateicheck übersprungen, der Schema-Test bleibt aktiv. Aktuell: 57
Assertions.

View file

@ -0,0 +1,83 @@
# 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
```

View file

@ -188,6 +188,7 @@ UI-Feedback der Tester ohnehin noch ausstehen.
- [x] Animations-Bake und Godot-Import eines Testclips (`TestWave`)
- [x] 3D-Rink, Kamera und Skater auf denselben Kurven (schreibgeschützte Vorschau)
- [x] Kufenspur mit Richtungsfarbe (vorwärts türkis, rückwärts orange, Abbau am Kür-Ende)
- [x] Ärmel-Skinning mit 8 Bone-Influences (verhindert den Kollaps in Godot)
- [x] Erster Produktionsclip `Glide` als 2-s-Loop
- [x] Rotoscoping-Workflow (Blender-Werkbank, Referenz, Multi-Clip-Export, Manifest)
- [ ] Erste echte Clips aus Referenzmaterial (Vorwärts, Rückwärts, Pirouette)