feat: schreibgeschuetzte 3D-Vorschau mit Glide-Clip

- Presentation3D mit Rink, Folge-/Uebersichtskamera und Skater
- 2D/3D-Umschalter, Esc-Rueckweg, geteilte Playback-Steuerung
- Skater laedt GLB ueber Manifest-ID, Platzhalter als Fallback
- Glide-Clip (2 s) als v003, Manifest und FTP-Spiegel aktualisiert
- 44 Praesentations-Assertions (1173 gesamt)
- Doku, Architektur (D14) und Roadmap aktualisiert
This commit is contained in:
torsten 2026-10-31 12:53:19 +01:00
parent 697274ce1b
commit 723e1bc84a
20 changed files with 1282 additions and 34 deletions

View file

@ -0,0 +1,109 @@
# Findings 2026-10-31 – 3D-Vorschau und Glide-Clip
## Ziel
Eine schreibgeschützte 3D-Ansicht, die dieselbe Kür mit denselben
Playback-Zeiten und Kurven zeigt wie das 2D-Whiteboard. Kein 3D-Editor,
keine Änderung am Phase-1-Workflow.
## Umsetzung
```
src/presentation3d/
├── presentation_3d.gd # Kamera, Licht, Modus, Playback-Pose
├── rink_3d.gd # Eisfläche, Bande, Markierungen
└── skater_3d.gd # GLB aus dem Manifest + Platzhalter-Fallback
scenes/presentation3d/presentation_3d.tscn
```
- **Lazy Load:** Die Szene wird erst beim ersten Klick auf **3D** geladen.
Phase 1 startet weiterhin ohne `Node3D`.
- **Koordinaten:** 2D `(x, y)` → 3D `(x, 0, -y)`. Blickrichtung `(hx, hy)`
→ `(hx, 0, -hy)`; der Skater wird per `rotation.y` ausgerichtet.
- **Rink:** 60 × 30 m aus `RinkDimensions`, abgerundete Ecken mit
`corner_radius_m = 8,5`, Bande 1,1 m, rote Reling, Mittellinie und
Mittelkreis.
- **Kamera:** Folgekamera 8 m hinter und 5,5 m über dem Skater; Übersicht
aus 36 m Höhe. Weicher Übergang, Snap bei großen Sprüngen (Scrubbing).
- **Playback:** `_update_playback_state()` schiebt Position und Blickrichtung
direkt an die Vorschau. Start/Pause, Reset, Timeline und Geschwindigkeit
bleiben die bestehenden Controls.
- **UI:** In 3D werden Rink-Canvas, Sections-Panel, Timing-Leiste und
Bearbeitungsbuttons ausgeblendet. Die Playback-Leiste bleibt. Der Button
wechselt zwischen **3D** und **2D**; Esc schließt die Vorschau.
- **Statusleiste:** zeigt im 3D-Modus Abschnitt, Dauer, Kamera und
„Esc: 2D".
- **Fallback:** Fehlt die GLB, baut `Skater3D` einen Platzhalter aus Kapsel,
Kopf und Richtungsmarker. Tests und ein frischer Checkout laufen dadurch
ohne Asset-Sync.
## Glide-Clip
Der Skater hatte im GLB nur die T-Pose. Für die Vorschau entstand der erste
Produktionsclip:
- ARP-Control-Rig aus `skater_rig_v002.blend`.
- Arme über die Hand-IK nach unten, 2-s-Loop mit leichtem Schwanken.
- Export mit `export_def_bones=True`, 30 Deform-Bones, eine Animation
`Glide`, 90 Kanäle, Dauer 2,0 s.
- Neue Datei `skater_figure_glide_v003.glb`, 8.420.244 Bytes,
SHA-256 `f45858cd…`.
- Manifest auf Version 3 aktualisiert; lokal synchronisiert und per
`--publish` auf den FTP-Spiegel geladen.
`Skater3D` liest die Manifest-ID `character.skater.figure`, spielt `Glide`
mit `LOOP_LINEAR` und fällt bei fehlender Datei auf den Platzhalter zurück.
## Gefundene und behobene Fehler
1. **Eisfläche unsichtbar:** Die Triangulation war nach der 2D→3D-Abbildung
falsch gewickelt. Indizes werden jetzt gedreht; die Fläche zeigt nach
oben.
2. **Kamera am falschen Ort:** Beim Öffnen wurde die Kamera auf den
Skater-Ursprung gesetzt, bevor die Playback-Pose kam. Jetzt wird die Pose
vor `set_active()` gesetzt; bei Sprüngen über 4 m snappt die Kamera.
3. **Top-Leiste zu breit bei 1024 px:** Der 3D-Button und der Separator
sprengten die Tablet-Breite. Im Compact-Modus heißt „Einpassen" jetzt
„Fit" (56 px), der 3D-Button ist 56 px breit, Undo/Redo sind 72 px breit
und der Separator entfällt. Der Touch-Test ist wieder grün.
## Tests
- Neu: `tests/run_presentation3d_tests.gd` mit **44 Assertions**:
- Koordinatenabbildung inkl. Blickrichtung
- Eisgröße 60 × 30, Mittelkreis, Skater-Instanz
- Kamera-Modi und deutsche Labels
- Platzhalter-/Modell-Fallback
- 2D/3D-Wechsel, Ausblenden der 2D-Controls, erhaltene Playback-Leiste
- Skater folgt `get_playback_position()` beim Öffnen und beim Scrubbing
- Kamera-Button, Esc-Rückweg
- Manifest-Test: 54 Assertions (neue `Glide`-Animation).
- Gesamtsuite: **1173 Assertions** grün.
## Visuelle Prüfung
- `tests/manual/capture_3d.gd` rendert die Vorschau mit einer Testkür.
- Geprüft bei 1400 × 900: Folgekamera, Übersicht, Glide-Pose, Schatten,
Bande und Markierungen.
- Der Skater steht mit den Füßen auf dem Eis; die Kameraposition folgt der
Blickrichtung.
## Offen
- Weitere Clips: Vorwärts/Rückwärts, Kantenwechsel, Pirouette, Sprünge.
- Freie Kamera/Orbit und eine dritte Ansicht (z. B. von vorn).
- 3D-Auswahl oder Bearbeitung ist bewusst nicht enthalten.
- Android: 8,42-MB-GLB und 2K-Texturen prüfen, bevor die Vorschau in einen
Mobile-Build wandert.
## Dateien
```
rinkplanner/src/presentation3d/{presentation_3d,rink_3d,skater_3d}.gd
rinkplanner/scenes/presentation3d/presentation_3d.tscn
rinkplanner/tests/run_presentation3d_tests.gd
rinkplanner/tests/manual/capture_3d.gd
workbench/source/characters/skater/skater_rig_v003.blend
workbench/library/characters/skater_figure_glide_v003.glb
```