From c0cc2b29f7960dc60d43cd839d1e22edbe9209db Mon Sep 17 00:00:00 2001 From: torsten Date: Sat, 31 Oct 2026 15:24:45 +0100 Subject: [PATCH] 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 --- docs/architecture.md | 16 +++- docs/assets.md | 30 ++++--- docs/findings-2026-10-31-arm-gewichte.md | 83 +++++++++++++++++++ docs/roadmap.md | 1 + rinkplanner/assets/asset_manifest.json | 17 ++-- rinkplanner/src/presentation3d/skater_3d.gd | 2 +- rinkplanner/tests/manual/capture_rig.gd | 21 +++-- rinkplanner/tests/manual/inspect_rig.gd | 2 +- rinkplanner/tests/run_asset_manifest_tests.gd | 29 +++++++ tools/blender/rotoscope.py | 12 +++ 10 files changed, 180 insertions(+), 33 deletions(-) create mode 100644 docs/findings-2026-10-31-arm-gewichte.md diff --git a/docs/architecture.md b/docs/architecture.md index e54ef0d..3168770 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -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 diff --git a/docs/assets.md b/docs/assets.md index 1832863..62ef456 100644 --- a/docs/assets.md +++ b/docs/assets.md @@ -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. diff --git a/docs/findings-2026-10-31-arm-gewichte.md b/docs/findings-2026-10-31-arm-gewichte.md new file mode 100644 index 0000000..0dc308c --- /dev/null +++ b/docs/findings-2026-10-31-arm-gewichte.md @@ -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 +``` diff --git a/docs/roadmap.md b/docs/roadmap.md index c938b02..b424ee7 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -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) diff --git a/rinkplanner/assets/asset_manifest.json b/rinkplanner/assets/asset_manifest.json index 96b81cb..07e7cc5 100644 --- a/rinkplanner/assets/asset_manifest.json +++ b/rinkplanner/assets/asset_manifest.json @@ -4,14 +4,14 @@ "assets": [ { "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": "f45858cd256628395409829c42f1669132ca330523f6a1be7a9f8d1ffbe9a45b", - "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": "50a3b84a68f899ae2652a31d60a93880177a7e80cae563fd458baac3d8e6036a", + "bytes": 8584300, "source_scene": "source/characters/skater/skater_rig_v003.blend", "created": "2026-10-31", "license": "Eigenes GenAI-Asset, Rig mit AutoRigPro erstellt.", @@ -24,14 +24,15 @@ }, "rig": { "type": "humanoid", - "control_bones": 226, + "control_bones": 222, "deform_bones": 30, + "vertex_influences": 8, "bind": "PSEUDO_VOXELS" }, "animations": [ "Glide" ], - "notes": "T-Pose als Rest, Glide als 2-s-Loop. Weitere Clips folgen über Rotoscoping." + "notes": "T-Pose als Rest, Glide als 2-s-Loop. 8 Bone-Influences pro Vertex, damit die Ärmel nicht kollabieren." } ] } diff --git a/rinkplanner/src/presentation3d/skater_3d.gd b/rinkplanner/src/presentation3d/skater_3d.gd index 295c80e..b3377de 100644 --- a/rinkplanner/src/presentation3d/skater_3d.gd +++ b/rinkplanner/src/presentation3d/skater_3d.gd @@ -6,7 +6,7 @@ extends Node3D const MANIFEST_PATH := "res://assets/asset_manifest.json" const ASSET_ID := "character.skater.figure" -const FALLBACK_MODEL_PATH := "res://assets/external/characters/skater_figure_glide_v003.glb" +const FALLBACK_MODEL_PATH := "res://assets/external/characters/skater_figure_glide_v004.glb" const IDLE_ANIMATION := "Glide" const BLADE_LATERAL_OFFSET_M := 0.065 const BLADE_HEIGHT_M := 0.015 diff --git a/rinkplanner/tests/manual/capture_rig.gd b/rinkplanner/tests/manual/capture_rig.gd index 01a9459..aba672a 100644 --- a/rinkplanner/tests/manual/capture_rig.gd +++ b/rinkplanner/tests/manual/capture_rig.gd @@ -6,7 +6,7 @@ extends SceneTree ## xvfb-run -a godot --path rinkplanner \ ## --script res://tests/manual/capture_rig.gd -- 640 840 /tmp/opencode/godot_rig.png -const MODEL_PATH := "res://assets/external/characters/skater_figure_rigged_deform_v002.glb" +const MODEL_PATH := "res://assets/external/characters/skater_figure_glide_v004.glb" func _init() -> void: @@ -20,6 +20,7 @@ func _capture() -> void: var output := args[2] if args.size() > 2 else "user://capture_rig.png" var model_path := args[3] if args.size() > 3 else MODEL_PATH var anim_time := float(args[4]) if args.size() > 4 else -1.0 + var camera_preset := args[5] if args.size() > 5 else "body" var packed := load(model_path) as PackedScene if packed == null: @@ -69,11 +70,19 @@ func _capture() -> void: var camera := Camera3D.new() camera.fov = 42.0 scene.add_child(camera) - camera.look_at_from_position( - Vector3(2.6, 1.45, 3.9), - Vector3(0.0, 0.95, 0.0), - Vector3.UP - ) + if camera_preset == "arms_back": + camera.fov = 45.0 + camera.look_at_from_position( + Vector3(0.0, 1.55, -3.2), + Vector3(0.0, 1.3, 0.0), + Vector3.UP + ) + else: + camera.look_at_from_position( + Vector3(2.6, 1.45, 3.9), + Vector3(0.0, 0.95, 0.0), + Vector3.UP + ) camera.current = true root.size = Vector2i(width, height) diff --git a/rinkplanner/tests/manual/inspect_rig.gd b/rinkplanner/tests/manual/inspect_rig.gd index f6dbf3a..daac679 100644 --- a/rinkplanner/tests/manual/inspect_rig.gd +++ b/rinkplanner/tests/manual/inspect_rig.gd @@ -5,7 +5,7 @@ extends SceneTree ## Aufruf: ## godot --headless --path rinkplanner --script res://tests/manual/inspect_rig.gd -const MODEL_PATH := "res://assets/external/characters/skater_figure_rigged_deform_v002.glb" +const MODEL_PATH := "res://assets/external/characters/skater_figure_glide_v004.glb" func _init() -> void: diff --git a/rinkplanner/tests/run_asset_manifest_tests.gd b/rinkplanner/tests/run_asset_manifest_tests.gd index a43512e..fe1e3be 100644 --- a/rinkplanner/tests/run_asset_manifest_tests.gd +++ b/rinkplanner/tests/run_asset_manifest_tests.gd @@ -158,6 +158,9 @@ func _validate_asset( _validate_synced_file(asset_id, target, sha256, size) + if rig is Dictionary and int(rig.get("deform_bones", 0)) > 0: + _validate_bone_weights(asset_id, target) + func _validate_placement(asset_id: String, placement: Dictionary) -> void: _check( @@ -231,6 +234,32 @@ func _validate_synced_file( ) +func _validate_bone_weights(asset_id: String, target: String) -> void: + var absolute := "res://" + target + if not FileAccess.file_exists(absolute): + return + + var packed := load(absolute) as PackedScene + _check(packed != null, "asset '%s' loads as a scene" % asset_id) + if packed == null: + return + + var instance := packed.instantiate() + var meshes := instance.find_children("*", "MeshInstance3D", true, false) + _check(not meshes.is_empty(), "asset '%s' contains a mesh" % asset_id) + for mesh_instance: MeshInstance3D in meshes: + var mesh := mesh_instance.mesh + if mesh == null or mesh.get_surface_count() == 0: + continue + var format: int = mesh.surface_get_format(0) + _check( + (format & Mesh.ARRAY_FLAG_USE_8_BONE_WEIGHTS) != 0, + "asset '%s' uses eight bone influences" % asset_id + ) + break + instance.free() + + func _is_relative_path(path: String) -> bool: return ( not path.is_empty() diff --git a/tools/blender/rotoscope.py b/tools/blender/rotoscope.py index aaa78f6..a2602e3 100755 --- a/tools/blender/rotoscope.py +++ b/tools/blender/rotoscope.py @@ -160,6 +160,7 @@ def export_clips(args: argparse.Namespace) -> None: export_animations=True, export_animation_mode="ACTIONS", export_def_bones=True, + export_all_influences=True, export_force_sampling=True, export_bake_animation=True, export_anim_single_armature=True, @@ -412,6 +413,17 @@ def _read_glb_animations(path: str) -> list[dict]: document = json.loads( data[json_chunk[1] : json_chunk[1] + json_chunk[2]].decode("utf-8") ) + + meshes = document.get("meshes", []) + if meshes: + attributes = meshes[0].get("primitives", [{}])[0].get("attributes", {}) + print("EXPORT_ATTRIBUTES", list(attributes.keys())) + if "JOINTS_1" not in attributes: + print( + "WARNUNG: Nur 4 Bone-Influences exportiert; " + "Ärmel können kollabieren." + ) + result = [] for animation in document.get("animations", []): duration = 0.0