2026-10-31 14:20:53 +01:00
|
|
|
|
# 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:
|
2026-10-31 14:46:54 +01:00
|
|
|
|
Beim Pausieren bleibt die Spur stehen. Am Kür-Ende, wenn die Wiedergabe
|
|
|
|
|
|
stoppt, wird sie in Echtzeit abgebaut.
|
2026-10-31 14:20:53 +01:00
|
|
|
|
- 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.
|
2026-10-31 14:46:54 +01:00
|
|
|
|
- Abbau beim Stehen (Trail-Fade) und am Ende der Wiedergabe
|
|
|
|
|
|
(Controller-Integration).
|
2026-10-31 14:20:53 +01:00
|
|
|
|
|
2026-10-31 14:46:54 +01:00
|
|
|
|
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.
|
2026-10-31 14:20:53 +01:00
|
|
|
|
|
|
|
|
|
|
## 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
|
|
|
|
|
|
```
|