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
This commit is contained in:
torsten 2026-10-31 15:35:17 +01:00
parent c0cc2b29f7
commit d4b227a936
11 changed files with 78 additions and 27 deletions

View file

@ -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 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 Manifest-Test prüft `ARRAY_FLAG_USE_8_BONE_WEIGHTS`. Vier Einflüsse sind für
diesen Rig nicht zulässig. 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 ## 4. View- und Controller-Grenzen

View file

@ -125,15 +125,15 @@ eine still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
```json ```json
{ {
"id": "character.skater.figure", "id": "character.skater.figure",
"version": 4, "version": 5,
"kind": "character", "kind": "character",
"format": "glb", "format": "glb",
"source": "library/characters/skater_figure_glide_v004.glb", "source": "library/characters/skater_figure_glide_v005.glb",
"target": "assets/external/characters/skater_figure_glide_v004.glb", "target": "assets/external/characters/skater_figure_glide_v005.glb",
"remote": "characters/skater_figure_glide_v004.glb", "remote": "characters/skater_figure_glide_v005.glb",
"sha256": "50a3b84a…", "sha256": "f2b80124…",
"bytes": 8584300, "bytes": 8584300,
"source_scene": "source/characters/skater/skater_rig_v003.blend", "source_scene": "source/characters/skater/skater_rig_v005.blend",
"placement": { "placement": {
"up_axis": "Y", "up_axis": "Y",
"facing": "+Z", "facing": "+Z",
@ -189,7 +189,7 @@ eine still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
| ID | Datei | Größe | Rig | Clips | | 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 Die 3D-Vorschau lädt die Datei über die Manifest-ID
`character.skater.figure`. Fehlt sie, erscheint ein Platzhalter aus `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. statt 0,10.
5. Animationen auf dem Control-Rig erstellen (IK/FK, Fußrollen, Root Motion). 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` Der erste Clip ist `Glide`: Arme unten, 2-s-Loop, im `.blend`
`skater_rig_v003.blend`. `skater_rig_v005.blend`.
6. Export mit `export_def_bones=True` und **`export_all_influences=True`**; 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 der Exporter backt Constraints automatisch. Im GLB landen nur die 30
Deform-Bones, aber **8 Bone-Influences pro Vertex**. Mit dem Standard- Deform-Bones, aber **8 Bone-Influences pro Vertex**. Mit dem Standard-
Export (4 Einflüsse) kollabieren die Ärmel in Godot. 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_rig.gd`); die 3D-Vorschau mit
`tests/manual/capture_3d.gd`. `tests/manual/capture_3d.gd`.

View file

@ -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 - Sichtprüfung: Rückansicht der Ärmel in Godot bei 600 × 600, zusätzlich
die normale 3D-Vorschau. 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 ## Offen
- Das Mesh hat weiterhin bis zu neun Einflüsse; der Export behält acht. Die - 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. Einfluss-Export.
- Ein generischer Export-Check für alle künftigen Assets wäre sinnvoll; - Ein generischer Export-Check für alle künftigen Assets wäre sinnvoll;
aktuell prüft der Manifest-Test nur den Charakter. 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 ## Dateien
``` ```
workbench/library/characters/skater_figure_glide_v004.glb workbench/library/characters/skater_figure_glide_v005.glb
workbench/source/characters/skater/skater_rig_v003.blend workbench/source/characters/skater/skater_rig_v005.blend
rinkplanner/assets/asset_manifest.json rinkplanner/assets/asset_manifest.json
rinkplanner/tests/run_asset_manifest_tests.gd rinkplanner/tests/run_asset_manifest_tests.gd
tools/blender/rotoscope.py tools/blender/rotoscope.py

View file

@ -188,7 +188,7 @@ UI-Feedback der Tester ohnehin noch ausstehen.
- [x] Animations-Bake und Godot-Import eines Testclips (`TestWave`) - [x] Animations-Bake und Godot-Import eines Testclips (`TestWave`)
- [x] 3D-Rink, Kamera und Skater auf denselben Kurven (schreibgeschützte Vorschau) - [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] 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] Erster Produktionsclip `Glide` als 2-s-Loop
- [x] Rotoscoping-Workflow (Blender-Werkbank, Referenz, Multi-Clip-Export, Manifest) - [x] Rotoscoping-Workflow (Blender-Werkbank, Referenz, Multi-Clip-Export, Manifest)
- [ ] Erste echte Clips aus Referenzmaterial (Vorwärts, Rückwärts, Pirouette) - [ ] Erste echte Clips aus Referenzmaterial (Vorwärts, Rückwärts, Pirouette)

View file

@ -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). - Blender 5.2 mit AutoRigPro (für die Control-Rig-Bones).
- Das Produktions-Rig: - 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 synthetischen Testfilm: `ffmpeg`.
- Für den FTP-Upload: `docs/credentials.txt` wie beim Asset-Sync. - Für den FTP-Upload: `docs/credentials.txt` wie beim Asset-Sync.

View file

@ -4,15 +4,15 @@
"assets": [ "assets": [
{ {
"id": "character.skater.figure", "id": "character.skater.figure",
"version": 4, "version": 5,
"kind": "character", "kind": "character",
"format": "glb", "format": "glb",
"source": "library/characters/skater_figure_glide_v004.glb", "source": "library/characters/skater_figure_glide_v005.glb",
"target": "assets/external/characters/skater_figure_glide_v004.glb", "target": "assets/external/characters/skater_figure_glide_v005.glb",
"remote": "characters/skater_figure_glide_v004.glb", "remote": "characters/skater_figure_glide_v005.glb",
"sha256": "50a3b84a68f899ae2652a31d60a93880177a7e80cae563fd458baac3d8e6036a", "sha256": "f2b801244884279694eede44f44cc70ac6b8dd560780f6f37b797175a9e09a60",
"bytes": 8584300, "bytes": 8584300,
"source_scene": "source/characters/skater/skater_rig_v003.blend", "source_scene": "source/characters/skater/skater_rig_v005.blend",
"created": "2026-10-31", "created": "2026-10-31",
"license": "Eigenes GenAI-Asset, Rig mit AutoRigPro erstellt.", "license": "Eigenes GenAI-Asset, Rig mit AutoRigPro erstellt.",
"placement": { "placement": {
@ -32,7 +32,7 @@
"animations": [ "animations": [
"Glide" "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."
} }
] ]
} }

View file

@ -6,7 +6,7 @@ extends Node3D
const MANIFEST_PATH := "res://assets/asset_manifest.json" const MANIFEST_PATH := "res://assets/asset_manifest.json"
const ASSET_ID := "character.skater.figure" 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 IDLE_ANIMATION := "Glide"
const BLADE_LATERAL_OFFSET_M := 0.065 const BLADE_LATERAL_OFFSET_M := 0.065
const BLADE_HEIGHT_M := 0.015 const BLADE_HEIGHT_M := 0.015

View file

@ -6,7 +6,7 @@ extends SceneTree
## xvfb-run -a godot --path rinkplanner \ ## xvfb-run -a godot --path rinkplanner \
## --script res://tests/manual/capture_rig.gd -- 640 840 /tmp/opencode/godot_rig.png ## --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: func _init() -> void:

View file

@ -5,7 +5,7 @@ extends SceneTree
## Aufruf: ## Aufruf:
## godot --headless --path rinkplanner --script res://tests/manual/inspect_rig.gd ## 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: func _init() -> void:

View file

@ -14,7 +14,7 @@ WORKBENCH = os.environ.get(
os.path.expanduser("~/Documents/workbench_rinkplanner"), os.path.expanduser("~/Documents/workbench_rinkplanner"),
) )
DEFAULT_RIG = os.path.join( 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( DEFAULT_WORK = os.path.join(
WORKBENCH, WORKBENCH,

View file

@ -11,7 +11,7 @@ WORKBENCH="${RINKPLANNER_WORKBENCH:-$HOME/Documents/workbench_rinkplanner}"
BLENDER="${BLENDER:-$(command -v blender || true)}" BLENDER="${BLENDER:-$(command -v blender || true)}"
SCRIPT="$REPO_ROOT/tools/blender/rotoscope.py" 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" ROTOSCOPE_DIR="$WORKBENCH/source/characters/skater/rotoscope"
WORK="$ROTOSCOPE_DIR/rotoscope_work.blend" WORK="$ROTOSCOPE_DIR/rotoscope_work.blend"
REFERENCES="$ROTOSCOPE_DIR/references" REFERENCES="$ROTOSCOPE_DIR/references"
@ -48,7 +48,7 @@ Aufruf: tools/rotoscope.sh <befehl> [optionen]
Umgebung: Umgebung:
RINKPLANNER_WORKBENCH Workbench-Archiv RINKPLANNER_WORKBENCH Workbench-Archiv
BLENDER Blender-Binary BLENDER Blender-Binary
RINKPLANNER_RIG Quell-Rig (Standard: skater_rig_v003.blend) RINKPLANNER_RIG Quell-Rig (Standard: skater_rig_v005.blend)
EOF EOF
} }