From d4b227a9365308addd69a0b8b046ad349a182228 Mon Sep 17 00:00:00 2001 From: torsten Date: Sat, 31 Oct 2026 15:35:17 +0100 Subject: [PATCH] fix: Armgewichte ringweise, Aermel behalten Volumen - PSEUDO-VOXELS-Gewichte bleichten in spine/head; die offenen Aermelflaechen kollabierten trotz 8 Bone-Influences - x-basierte Ringgewichtung fuer die Armregion, 8 Influences - neues Quell-Rig und GLB v005, Manifest, Sync und FTP aktualisiert - Rotoscoping-Default auf skater_rig_v005.blend - 1189 Assertions gesamt --- docs/architecture.md | 4 ++ docs/assets.md | 24 ++++++----- docs/findings-2026-10-31-arm-gewichte.md | 47 ++++++++++++++++++++- docs/roadmap.md | 2 +- docs/rotoscoping.md | 2 +- rinkplanner/assets/asset_manifest.json | 14 +++--- rinkplanner/src/presentation3d/skater_3d.gd | 2 +- rinkplanner/tests/manual/capture_rig.gd | 2 +- rinkplanner/tests/manual/inspect_rig.gd | 2 +- tools/blender/rotoscope.py | 2 +- tools/rotoscope.sh | 4 +- 11 files changed, 78 insertions(+), 27 deletions(-) diff --git a/docs/architecture.md b/docs/architecture.md index 3168770..18965dc 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -228,6 +228,10 @@ 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. +Zusätzlich wird die Armregion **ringweise** (x-basiert) gewichtet. Die +PSEUDO-VOXELS-Gewichte bleichten sonst in `spine_03`/`head`; die offenen +Ärmelflächen verlieren dadurch ihr Volumen. Details: +`docs/findings-2026-10-31-arm-gewichte.md`. ## 4. View- und Controller-Grenzen diff --git a/docs/assets.md b/docs/assets.md index 62ef456..64a772a 100644 --- a/docs/assets.md +++ b/docs/assets.md @@ -125,15 +125,15 @@ eine still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet. ```json { "id": "character.skater.figure", - "version": 4, + "version": 5, "kind": "character", "format": "glb", - "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…", + "source": "library/characters/skater_figure_glide_v005.glb", + "target": "assets/external/characters/skater_figure_glide_v005.glb", + "remote": "characters/skater_figure_glide_v005.glb", + "sha256": "f2b80124…", "bytes": 8584300, - "source_scene": "source/characters/skater/skater_rig_v003.blend", + "source_scene": "source/characters/skater/skater_rig_v005.blend", "placement": { "up_axis": "Y", "facing": "+Z", @@ -189,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_v004.glb` | 8,59 MB | 222 Control / 30 Deform, 8 Einflüsse | `Glide` (2-s-Loop) | +| `character.skater.figure` | `skater_figure_glide_v005.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,12 +226,16 @@ die Manifest-ID `character.skater.figure` und spielt derzeit `Glide`. statt 0,10. 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` und **`export_all_influences=True`**; + `skater_rig_v005.blend`. +6. **Armgewichte ringweise** setzen (x-basiert, siehe + `docs/findings-2026-10-31-arm-gewichte.md`). Die PSEUDO-VOXELS-Gewichte + bleichten sonst in `spine_03`/`head` und ließen die offenen Ärmelflächen + kollabieren. +7. 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`, +8. Ergebnis in Godot prüfen (`tests/manual/inspect_rig.gd`, `tests/manual/capture_rig.gd`); die 3D-Vorschau mit `tests/manual/capture_3d.gd`. diff --git a/docs/findings-2026-10-31-arm-gewichte.md b/docs/findings-2026-10-31-arm-gewichte.md index 0dc308c..3d27e37 100644 --- a/docs/findings-2026-10-31-arm-gewichte.md +++ b/docs/findings-2026-10-31-arm-gewichte.md @@ -60,6 +60,47 @@ Rückfall auf 4 Einflüsse sofort auf. - 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. + ## Offen - Das Mesh hat weiterhin bis zu neun Einflüsse; der Export behält acht. Die @@ -70,12 +111,14 @@ Rückfall auf 4 Einflüsse sofort auf. 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_v004.glb -workbench/source/characters/skater/skater_rig_v003.blend +workbench/library/characters/skater_figure_glide_v005.glb +workbench/source/characters/skater/skater_rig_v005.blend rinkplanner/assets/asset_manifest.json rinkplanner/tests/run_asset_manifest_tests.gd tools/blender/rotoscope.py diff --git a/docs/roadmap.md b/docs/roadmap.md index b424ee7..19e5a87 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -188,7 +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] Ärmel-Skinning mit 8 Bone-Influences und ringweiser Armgewichtung - [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/docs/rotoscoping.md b/docs/rotoscoping.md index 89e4df3..a1b4323 100644 --- a/docs/rotoscoping.md +++ b/docs/rotoscoping.md @@ -10,7 +10,7 @@ Workbench-Archiv; das Repo enthält die Skripte und die Dokumentation. - Blender 5.2 mit AutoRigPro (für die Control-Rig-Bones). - Das Produktions-Rig: - `workbench/source/characters/skater/skater_rig_v003.blend`. + `workbench/source/characters/skater/skater_rig_v005.blend`. - Für den synthetischen Testfilm: `ffmpeg`. - Für den FTP-Upload: `docs/credentials.txt` wie beim Asset-Sync. diff --git a/rinkplanner/assets/asset_manifest.json b/rinkplanner/assets/asset_manifest.json index 07e7cc5..6653658 100644 --- a/rinkplanner/assets/asset_manifest.json +++ b/rinkplanner/assets/asset_manifest.json @@ -4,15 +4,15 @@ "assets": [ { "id": "character.skater.figure", - "version": 4, + "version": 5, "kind": "character", "format": "glb", - "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", + "source": "library/characters/skater_figure_glide_v005.glb", + "target": "assets/external/characters/skater_figure_glide_v005.glb", + "remote": "characters/skater_figure_glide_v005.glb", + "sha256": "f2b801244884279694eede44f44cc70ac6b8dd560780f6f37b797175a9e09a60", "bytes": 8584300, - "source_scene": "source/characters/skater/skater_rig_v003.blend", + "source_scene": "source/characters/skater/skater_rig_v005.blend", "created": "2026-10-31", "license": "Eigenes GenAI-Asset, Rig mit AutoRigPro erstellt.", "placement": { @@ -32,7 +32,7 @@ "animations": [ "Glide" ], - "notes": "T-Pose als Rest, Glide als 2-s-Loop. 8 Bone-Influences pro Vertex, damit die Ärmel nicht kollabieren." + "notes": "T-Pose als Rest, Glide als 2-s-Loop. 8 Bone-Influences pro Vertex; Armregion ringweise gewichtet, damit die Ärmel Volumen behalten." } ] } diff --git a/rinkplanner/src/presentation3d/skater_3d.gd b/rinkplanner/src/presentation3d/skater_3d.gd index b3377de..3e949b8 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_v004.glb" +const FALLBACK_MODEL_PATH := "res://assets/external/characters/skater_figure_glide_v005.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 aba672a..79cdd4a 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_glide_v004.glb" +const MODEL_PATH := "res://assets/external/characters/skater_figure_glide_v005.glb" func _init() -> void: diff --git a/rinkplanner/tests/manual/inspect_rig.gd b/rinkplanner/tests/manual/inspect_rig.gd index daac679..50d596e 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_glide_v004.glb" +const MODEL_PATH := "res://assets/external/characters/skater_figure_glide_v005.glb" func _init() -> void: diff --git a/tools/blender/rotoscope.py b/tools/blender/rotoscope.py index a2602e3..dce5d5f 100755 --- a/tools/blender/rotoscope.py +++ b/tools/blender/rotoscope.py @@ -14,7 +14,7 @@ WORKBENCH = os.environ.get( os.path.expanduser("~/Documents/workbench_rinkplanner"), ) DEFAULT_RIG = os.path.join( - WORKBENCH, "source", "characters", "skater", "skater_rig_v003.blend" + WORKBENCH, "source", "characters", "skater", "skater_rig_v005.blend" ) DEFAULT_WORK = os.path.join( WORKBENCH, diff --git a/tools/rotoscope.sh b/tools/rotoscope.sh index 310845d..5deb7a0 100755 --- a/tools/rotoscope.sh +++ b/tools/rotoscope.sh @@ -11,7 +11,7 @@ WORKBENCH="${RINKPLANNER_WORKBENCH:-$HOME/Documents/workbench_rinkplanner}" BLENDER="${BLENDER:-$(command -v blender || true)}" SCRIPT="$REPO_ROOT/tools/blender/rotoscope.py" -RIG="${RINKPLANNER_RIG:-$WORKBENCH/source/characters/skater/skater_rig_v003.blend}" +RIG="${RINKPLANNER_RIG:-$WORKBENCH/source/characters/skater/skater_rig_v005.blend}" ROTOSCOPE_DIR="$WORKBENCH/source/characters/skater/rotoscope" WORK="$ROTOSCOPE_DIR/rotoscope_work.blend" REFERENCES="$ROTOSCOPE_DIR/references" @@ -48,7 +48,7 @@ Aufruf: tools/rotoscope.sh [optionen] Umgebung: RINKPLANNER_WORKBENCH Workbench-Archiv BLENDER Blender-Binary - RINKPLANNER_RIG Quell-Rig (Standard: skater_rig_v003.blend) + RINKPLANNER_RIG Quell-Rig (Standard: skater_rig_v005.blend) EOF }