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
This commit is contained in:
parent
7f35162966
commit
1530914814
13 changed files with 478 additions and 15 deletions
|
|
@ -3,8 +3,8 @@
|
|||
Stand: 2026-10-31
|
||||
Grundlage: `rinkplanner/rinkplanner_definition_agent_guidelines.md`
|
||||
Übergeordnete Reihenfolge: `docs/roadmap.md`
|
||||
Letzte Session: `docs/findings-2026-10-31-rotoscoping.md`
|
||||
(Session davor: `docs/findings-2026-10-31-3d-vorschau.md`)
|
||||
Letzte Session: `docs/findings-2026-10-31-kufenspur.md`
|
||||
(Session davor: `docs/findings-2026-10-31-rotoscoping.md`)
|
||||
|
||||
## 1. Leitentscheidung
|
||||
|
||||
|
|
@ -212,6 +212,14 @@ Arbeitsdateien bleiben im Workbench-Archiv. Godot kennt nur die GLB und die
|
|||
Clipnamen; die Zuordnung Element → Clip ist ein späterer Schritt. Details:
|
||||
`docs/rotoscoping.md`.
|
||||
|
||||
**D16 – Die Kufenspur ist eine reine 3D-Visualisierung.**
|
||||
`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
|
||||
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.
|
||||
|
||||
## 4. View- und Controller-Grenzen
|
||||
|
||||
- **View** (`Node2D`/`Control`) liest das Modell und zeichnet. Sie verändert
|
||||
|
|
@ -484,9 +492,9 @@ 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:** 44 Assertions für Koordinatenabbildung, Rink-Geometrie,
|
||||
Kamera-Modi, Platzhalter-Fallback und den 2D/3D-Moduswechsel samt
|
||||
geteilter Playback-Position.
|
||||
- **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.
|
||||
- **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
|
||||
|
|
|
|||
104
docs/findings-2026-10-31-kufenspur.md
Normal file
104
docs/findings-2026-10-31-kufenspur.md
Normal file
|
|
@ -0,0 +1,104 @@
|
|||
# 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
|
||||
```
|
||||
|
|
@ -24,7 +24,12 @@ der bisherige Bearbeitungsstand wieder da.
|
|||
- **Playback geteilt:** Start/Pause, Reset, Timeline und Geschwindigkeit
|
||||
wirken auf den 2D-Marker und den 3D-Skater gleichzeitig.
|
||||
- **Kamera:** Der Button „Kamera: Folge" wechselt zwischen der
|
||||
Folgekamera (hinter dem Skater) und der Übersicht (ganzes Rink).
|
||||
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
|
||||
Sprung in der Zeit wird sie zurückgesetzt. Die Legende steht oben links
|
||||
im 3D-Bild.
|
||||
- **Zurück:** erneut **2D** drücken oder **Esc**.
|
||||
- **Statusleiste:** zeigt im 3D-Modus den Hinweis „Esc: 2D" und die aktive
|
||||
Kamera.
|
||||
|
|
|
|||
|
|
@ -187,6 +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] 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)
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue