rinkplanner/docs/findings-2026-10-31-kufenspur.md
torsten 1530914814 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
2026-10-31 14:20:53 +01:00

3.7 KiB
Raw Blame History

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