# 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 ```