rinkplanner/docs/findings-2026-10-31-3d-vorschau.md
torsten 723e1bc84a 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
2026-10-31 12:53:19 +01:00

109 lines
4.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
```