feat: Folgekamera folgt der Fahrtrichtung

- Kamera nutzt die Bahn-Tangente statt des Koerper-Yaw
- Rueckwaerts bleibt sie auf der Bahnseite und zeigt die Laeuferin von vorn
- Element-Marker behalten die letzte Fahrtrichtung
- 61 Praesentations-Assertions (1193 gesamt)
This commit is contained in:
torsten 2026-10-31 15:43:14 +01:00
parent 81be37101f
commit a8c5e61faf
6 changed files with 151 additions and 12 deletions

View file

@ -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-arm-gewichte.md`
(Session davor: `docs/findings-2026-10-31-kufenspur.md`)
Letzte Session: `docs/findings-2026-10-31-kamera-rueckwaerts.md`
(Session davor: `docs/findings-2026-10-31-arm-gewichte.md`)
## 1. Leitentscheidung
@ -233,6 +233,14 @@ PSEUDO-VOXELS-Gewichte bleichten sonst in `spine_03`/`head`; die offenen
Ärmelflächen verlieren dadurch ihr Volumen. Details:
`docs/findings-2026-10-31-arm-gewichte.md`.
**D18 – Die Folgekamera folgt der Fahrtrichtung.**
Der Kamera-Rückwärtsversatz kommt aus der Bahn-Tangente, nicht aus dem
Körper-Yaw. Bei Vorwärtsfahrt ist beides gleich; bei Rückwärtsfahrt bleibt
die Kamera auf derselben Bahnseite, während sich die Läuferin zur Kamera
dreht. Dadurch schwenkt die Kamera am Richtungswechsel nicht um 180°, und
die Läuferin ist auch von vorn zu sehen. Element-Marker behalten die letzte
Fahrtrichtung.
## 4. View- und Controller-Grenzen
- **View** (`Node2D`/`Control`) liest das Modell und zeichnet. Sie verändert
@ -505,10 +513,10 @@ Aktueller Stand:
- **3D-Assets:** 57 Assertions für Manifest-Schema, Pfade, FTP-Pfade,
Platzierung, Rig-Metadaten, Animationen, Hashes und – falls synchronisiert
– Größe, SHA-256 sowie die 8-Bone-Gewichte der GLB-Datei.
- **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.
- **3D-Vorschau:** 61 Assertions für Koordinatenabbildung, Rink-Geometrie,
Kamera-Modi, Kamera-Fahrtrichtung, 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

@ -0,0 +1,63 @@
# Findings 2026-10-31 – Folgekamera bei Rückwärtsfahrt
## Ziel
Die Kamera soll bei Rückwärtsfahrt nicht wieder hinter die Läuferin
schwenken. Sie soll auf der bisherigen Bahnseite bleiben und die Läuferin
dadurch von vorn zeigen.
## Ursache
Die Folgekamera leitete ihre Blickrichtung aus dem **Körper-Yaw** ab. Bei
Rückwärtsfahrt zeigt der Körper gegen die Fahrtrichtung; die Kamera setzte
sich dahinter und sah wieder den Rücken.
## Lösung
`Presentation3D` speichert jetzt eine **Fahrtrichtung** (`_travel_direction`):
- Vorwärts-Segment: Fahrtrichtung = Heading.
- Rückwärts-Segment: Fahrtrichtung = −Heading (also die Bahn-Tangente).
- Element-Marker (Pirouette, Sprung): letzte Fahrtrichtung bleibt erhalten.
- Die Kamera berechnet ihren Rückwärtsversatz und den Blickpunkt aus dieser
Fahrtrichtung, nicht aus dem Körper-Yaw.
Damit gilt:
| Situation | Kamera | Ansicht |
| :--- | :--- | :--- |
| Vorwärts | hinter der Fahrtrichtung | Rücken |
| Rückwärts | weiterhin hinter der Fahrtrichtung | **Front** |
| Richtungswechsel | kein 180°-Schwenk | die Läuferin dreht sich |
| Pirouette/Sprung | letzte Fahrtrichtung | ruhige Kamera |
Die Kamera folgt weiterhin der Translation, sonst würde die Läuferin aus dem
Bild laufen. „Position behalten" heißt hier: **kein Orbit um den Körper**,
sondern dieselbe Seite relativ zur Bahn.
## Tests
Neu in `tests/run_presentation3d_tests.gd`:
- Vorwärtskamera folgt +X.
- Rückwärts bei Heading −X behält die Kamera +X als Fahrtrichtung.
- Die Kameraposition ändert sich beim Richtungswechsel nicht.
- Der Skater-Yaw ist bei Rückwärtsfahrt um 180° gedreht (Front zur Kamera).
Ergebnis: **61 Assertions** (vorher 57), Gesamtsuite **1193** grün.
## Visuelle Prüfung
- Vorwärts bei 1400 × 900: Rückenansicht, türkise Kufenspur.
- Rückwärts: Frontalansicht, orange Kufenspur zwischen Kamera und Läuferin.
- Kein Schwenk am Übergang; die Kamera bleibt auf der Bahnseite.
- Die ringgewichteten Ärmel (v005) bleiben in beiden Ansichten sauber.
## Dateien
```
rinkplanner/src/presentation3d/presentation_3d.gd
rinkplanner/tests/run_presentation3d_tests.gd
docs/manual.md
docs/architecture.md (D18)
```

View file

@ -24,7 +24,9 @@ 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 (hinten/seitlich versetzt) und der Übersicht (ganzes Rink).
Folgekamera und der Übersicht (ganzes Rink). Die Folgekamera orientiert
sich an der **Fahrtrichtung**: vorwärts sieht man den Rücken, rückwärts
bleibt sie auf derselben Bahnseite und zeigt die Läuferin von vorn.
- **Kufenspur:** Zwei verblassende Spuren an den Kufen zeigen die
Fahrtrichtung: **türkis = vorwärts**, **orange = rückwärts**. Beim
Pausieren bleibt die Spur stehen; am Kür-Ende, wenn die Wiedergabe

View file

@ -189,6 +189,7 @@ UI-Feedback der Tester ohnehin noch ausstehen.
- [x] 3D-Rink, Kamera und Skater auf denselben Kurven (schreibgeschützte Vorschau)
- [x] Kufenspur mit Richtungsfarbe (vorwärts türkis, rückwärts orange, Abbau am Kür-Ende)
- [x] Ärmel-Skinning mit 8 Bone-Influences und ringweiser Armgewichtung
- [x] Folgekamera folgt der Fahrtrichtung (Frontansicht bei Rückwärtsfahrt)
- [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)