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:
parent
894f3d950d
commit
c0cc2b29f7
10 changed files with 180 additions and 33 deletions
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
83
docs/findings-2026-10-31-arm-gewichte.md
Normal file
83
docs/findings-2026-10-31-arm-gewichte.md
Normal 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
|
||||
```
|
||||
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -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."
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -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:
|
||||
|
|
|
|||
|
|
@ -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()
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue