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)
This commit is contained in:
torsten 2026-10-31 14:46:54 +01:00
parent 1530914814
commit e79fa9635b
9 changed files with 131 additions and 15 deletions

View file

@ -216,7 +216,8 @@ Clipnamen; die Zuordnung Element → Clip ist ein späterer Schritt. Details:
`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
Echtzeit; beim Pausieren bleibt die Spur stehen. Am Kür-Ende, wenn die
Wiedergabe stoppt, läuft sie in Echtzeit aus. 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.
@ -492,9 +493,10 @@ 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:** 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.
- **3D-Vorschau:** 57 Assertions für Koordinatenabbildung, Rink-Geometrie,
Kamera-Modi, Platzhalter-Fallback, Kufenspur (Farbe, zwei Kufen, Reset,
Abbau am Kür-Ende) 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

@ -18,7 +18,8 @@ Neu: `src/presentation3d/skate_trail_3d.gd` (`SkateTrail3D`).
- **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.
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
@ -58,8 +59,28 @@ Es ist nur im 3D-Modus sichtbar und blockiert keine Eingaben.
- 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: **52 Assertions** (vorher 44), Gesamtsuite **1181** grün.
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

View file

@ -27,7 +27,8 @@ der bisherige Bearbeitungsstand wieder da.
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
Pausieren bleibt die Spur stehen; am Kür-Ende, wenn die Wiedergabe
stoppt, läuft sie in Echtzeit aus. 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**.

View file

@ -187,7 +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] Kufenspur mit Richtungsfarbe (vorwärts türkis, rückwärts orange, Abbau am Kür-Ende)
- [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)