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:
parent
697274ce1b
commit
723e1bc84a
20 changed files with 1282 additions and 34 deletions
109
docs/findings-2026-10-31-3d-vorschau.md
Normal file
109
docs/findings-2026-10-31-3d-vorschau.md
Normal 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
|
||||
```
|
||||
Loading…
Add table
Add a link
Reference in a new issue