rinkplanner/docs/findings-2026-10-31-kufenspur.md
torsten e79fa9635b feat: Kufenspur blendet am Kuer-Ende aus
- Trail-Fade in Echtzeit, wenn die Wiedergabe endet und die Figur steht
- Pausieren mitten in der Kuer laesst die Spur weiterhin stehen
- Controller synchronisiert den Fade bei Play/Pause/Seek/Ende
- 57 Praesentations-Assertions (1186 gesamt)
2026-10-31 14:46:54 +01:00

125 lines
4.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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. Am Kür-Ende, wenn die Wiedergabe
stoppt, wird sie in Echtzeit abgebaut.
- 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.
- Abbau beim Stehen (Trail-Fade) und am Ende der Wiedergabe
(Controller-Integration).
Ergebnis: **57 Assertions** (vorher 44), Gesamtsuite **1186** grün.
## Nachtrag: Abbau am Kür-Ende
Wenn die Wiedergabe das Ende erreicht, bleibt die Figur stehen. Die Spur soll
dann nicht einfrieren, sondern ausblenden.
- `SkateTrail3D.start_fade()` setzt den Fade-Modus; `_process(delta)` erhöht
die Trail-Zeit in Echtzeit, entfernt alte Samples und baut das Mesh neu.
Ist der Puffer leer, stoppt der Prozess.
- `WhiteboardController._sync_trail_fade()` startet den Fade nur, wenn die
Wiedergabe am Ende ist und nicht läuft. Beim Pausieren mitten in der Kür
bleibt die Spur stehen.
- Wird weiterbewegt, gescrubbt oder neu gestartet, beendet `add_sample()`
den Fade; ein Zeit-Rücksprung leert die Spur.
Damit verschwindet die Spur nach dem letzten bewegten Segment innerhalb von
1,3 s. Endet die Kür mit einer Pirouette, ist sie bereits während der
Standzeit ausgelaufen.
## 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
```