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

View file

@ -0,0 +1,104 @@
# Findings 2026-10-31 – Kufenspur in der 3D-Vorschau
## Ziel
Die Fahrtrichtung im 3D-Bild sichtbar machen, besonders vorwärts und
rückwärts. Zwei verblassende Spuren an den Kufen sollen die Bewegung
nachvollziehbar machen, ohne das Modell zu verändern.
## Umsetzung
Neu: `src/presentation3d/skate_trail_3d.gd` (`SkateTrail3D`).
- Zwei Ribbons an den geschätzten Blade-Positionen
(`Skater3D.get_blade_positions()`, seitlicher Offset ±0,065 m,
1,5 cm über dem Eis).
- Breite 0,048 m, 120 Samples, Alterung 1,3 s.
- Farbe aus `PathSegment.direction`:
- **türkis** `#0ea5e9` = vorwärts,
- **orange** `#f97316` = rückwärts.
- Die Alterung läuft über die **Playback-Zeit**, nicht über die Echtzeit:
Beim Pausieren bleibt die Spur stehen.
- Reset bei Positionssprung > 1,5 m, Zeit-Rücksprung (Loop/Scrub) und
`clear_pose`.
- Während Element-Markern (Pirouette, Sprung) werden keine neuen Samples
erzeugt; die vorhandene Spur blendet über die Playback-Zeit aus.
- Unshaded-Material mit Vertex-Alpha; die neuesten Samples sind kräftig,
die ältesten laufen transparent aus.
### Kamera
Die reine Folgekamera direkt hinter dem Skater verdeckte die Spur im unteren
Bildrand. Sie ist jetzt eine 3/4-Verfolgung:
- 9 m hinter dem Skater,
- 3,5 m seitlich versetzt,
- 6 m hoch,
- Blickpunkt 2,5 m vor dem Skater.
Damit liegt die Spur sichtbar neben/hinter dem Skater, und die Fahrtrichtung
bleibt auch bei Rückwärtsfahrt erkennbar.
### Legende
Ein `Label` oben links im 3D-Bild erklärt die Farben:
`Spur: türkis = vorwärts · orange = rückwärts`
Es ist nur im 3D-Modus sichtbar und blockiert keine Eingaben.
## Tests
`tests/run_presentation3d_tests.gd` erweitert um:
- Vortwärtsbewegung erzeugt Samples,
- zwei getrennte Blade-Positionen,
- Vortwärtsfarbe türkis,
- Rückwärtsfarbe orange,
- großer Sprung leert die Spur,
- `clear_pose` leert die Spur,
- Legende sichtbar in 3D / verborgen in 2D.
Ergebnis: **52 Assertions** (vorher 44), Gesamtsuite **1181** grün.
## Visuelle Prüfung
- 1400 × 900: Vorwärtsspur türkis, Rückwärtsspur orange, je zwei Linien.
- 1024 × 768: Legende und Spur passen; die Top-Leiste bleibt im
Compact-Layout.
- Die Spur beginnt an den Füßen und läuft hinter dem Skater aus.
## Gefundene Punkte
1. **Spur beim Scrubbing unsichtbar:** Ein einzelner Seek erzeugt nur eine
Pose; ohne Playback gibt es keine Samples. Der manuelle Capture spielt
jetzt 1,2 s vor dem Screenshot. In der App entsteht die Spur beim
Abspielen.
2. **Spur unter dem Bildrand:** Die direkt hinter dem Skater stehende Kamera
projizierte die Spur nach unten aus dem Bild. Die 3/4-Kamera löst das.
3. **Farben zu blass:** Auf dem weißen Eis waren die ersten Farben kaum zu
sehen. Kräftigere Farben, 0,048 m Breite und 0,95 Alpha.
4. **Einfrieren beim Pausieren:** Die Alterung wurde von Echtzeit auf
Playback-Zeit umgestellt. Die Spur bleibt beim Pausieren stehen und
verschwindet erst, wenn die Zeit weiterläuft.
## Grenzen
- Die Blade-Positionen sind feste lokale Offsets, keine Knochenauswertung.
Für den visuellen Effekt reicht das; bei extremen Fußstellungen kann die
Spur leicht neben der Kufe liegen.
- Bei Pirouetten und Element-Markern wird die Spur nicht weitergezeichnet.
- Die Spur ist nur in 3D sichtbar und wird nicht gespeichert.
- Es gibt noch keine freie Kamera/Orbit-Steuerung.
## Dateien
```
rinkplanner/src/presentation3d/skate_trail_3d.gd
rinkplanner/src/presentation3d/presentation_3d.gd
rinkplanner/src/presentation3d/skater_3d.gd
rinkplanner/scenes/presentation3d/presentation_3d.tscn
rinkplanner/scenes/whiteboard/whiteboard.tscn
rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd
rinkplanner/tests/run_presentation3d_tests.gd
```

View file

@ -24,7 +24,12 @@ der bisherige Bearbeitungsstand wieder da.
- **Playback geteilt:** Start/Pause, Reset, Timeline und Geschwindigkeit
wirken auf den 2D-Marker und den 3D-Skater gleichzeitig.
- **Kamera:** Der Button „Kamera: Folge" wechselt zwischen der
Folgekamera (hinter dem Skater) und der Übersicht (ganzes Rink).
Folgekamera (hinten/seitlich versetzt) und der Übersicht (ganzes Rink).
- **Kufenspur:** Zwei verblassende Spuren an den Kufen zeigen die
Fahrtrichtung: **türkis = vorwärts**, **orange = rückwärts**. Beim
Pausieren bleibt die Spur stehen; bei Sprüngen, Scrubben oder einem
Sprung in der Zeit wird sie zurückgesetzt. Die Legende steht oben links
im 3D-Bild.
- **Zurück:** erneut **2D** drücken oder **Esc**.
- **Statusleiste:** zeigt im 3D-Modus den Hinweis „Esc: 2D" und die aktive
Kamera.

View file

@ -187,6 +187,7 @@ UI-Feedback der Tester ohnehin noch ausstehen.
- [x] Geriggter Skater (AutoRigPro, 226 Control-/30 Deform-Bones, glTF-Export)
- [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)
- [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)