feat: Kufenspur mit Richtungsfarbe in der 3D-Vorschau

- zwei verblassende Ribbons an den Kufen (tuerkis vorwaerts,
  orange rueckwaerts)
- Alterung ueber Playback-Zeit, Reset bei Spruengen/Scrubbing
- 3/4-Folgekamera macht die Spur sichtbar
- Legende im 3D-Bild
- 52 Praesentations-Assertions (1181 gesamt)
- Doku, Architektur (D16) und Roadmap aktualisiert
This commit is contained in:
torsten 2026-10-31 14:20:53 +01:00
parent 7f35162966
commit 1530914814
13 changed files with 478 additions and 15 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-rotoscoping.md`
(Session davor: `docs/findings-2026-10-31-3d-vorschau.md`)
Letzte Session: `docs/findings-2026-10-31-kufenspur.md`
(Session davor: `docs/findings-2026-10-31-rotoscoping.md`)
## 1. Leitentscheidung
@ -212,6 +212,14 @@ Arbeitsdateien bleiben im Workbench-Archiv. Godot kennt nur die GLB und die
Clipnamen; die Zuordnung Element → Clip ist ein späterer Schritt. Details:
`docs/rotoscoping.md`.
**D16 – Die Kufenspur ist eine reine 3D-Visualisierung.**
`SkateTrail3D` zeichnet zwei Ribbons an den geschätzten Blade-Positionen.
Die Farbe kommt aus `PathSegment.direction`: türkis für vorwärts, orange für
rückwärts. Die Alterung läuft über die Playback-Zeit (1,3 s), nicht über die
Echtzeit; beim Pausieren bleibt die Spur stehen. 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.
## 4. View- und Controller-Grenzen
- **View** (`Node2D`/`Control`) liest das Modell und zeichnet. Sie verändert
@ -484,9 +492,9 @@ Aktueller Stand:
- **3D-Assets:** 54 Assertions für Manifest-Schema, Pfade, FTP-Pfade,
Platzierung, Rig-Metadaten, Animationen, Hashes und – falls synchronisiert
– Größe und SHA-256 der GLB-Datei.
- **3D-Vorschau:** 44 Assertions für Koordinatenabbildung, Rink-Geometrie,
Kamera-Modi, Platzhalter-Fallback und den 2D/3D-Moduswechsel samt
geteilter Playback-Position.
- **3D-Vorschau:** 52 Assertions für Koordinatenabbildung, Rink-Geometrie,
Kamera-Modi, Platzhalter-Fallback, Kufenspur (Farbe, zwei Kufen, Reset)
und den 2D/3D-Moduswechsel samt geteilter Playback-Position.
- **Blender-Werkbank:** Rotoscoping wird separat geprüft
(`tools/rotoscope.sh test-reference` → `setup` → `export` → `promote
--dry-run`), nicht in `./tools/test.sh`, weil Blender und ffmpeg