rinkplanner/docs/findings-2026-10-31-3d-vorschau.md
torsten 0325e53984 feat: 3D-Bande mit Sockel, Fugen und mehr Kontrast zum Eis
Eis und Bande waren fast gleich hell, die Kante war kaum zu sehen. Die Bande
ist jetzt dreiteilig und deutlich abgesetzt:

- petrolfarbener Sockel (0,22 m) als dunkle Trennlinie zum Eis
- Bandfläche in kühlerem Graublau mit prozeduraler Fugen-Textur; die Fugen
  wiederholen sich per world-triplanar alle 2,4 m, auch in den Kurven
- rote Reling als obere Kante, leicht abgedunkelt
- Eisfläche etwas dunkler, damit sie nicht ausbrennt

Tests prüfen Sockel, Textur, Weltkoordinaten-Fugen und Helligkeitsabstand;
Sichtprüfung über tests/manual/capture_rink_boards.gd (vier Blickwinkel).
2026-11-12 06:22:10 +01:00

129 lines
5.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
```
## Nachtrag: Bande mit mehr Kontrast (2026-11-12)
Eis und Bande waren beide nahezu weiß (`e8f3ff` bzw. `f4f7fa`), bei flachem
Licht war die Kante kaum zu sehen. Die Bande ist jetzt dreiteilig:
- **Sockel (Kickplate):** 0,22 m hoch, petrolfarben (`0f3b46`), sitzt leicht
vor der Bande und trennt Eis und Bande als dunkle Linie.
- **Bandfläche:** `bccddd`, also deutlich kühler und dunkler als das Eis
(`d3e6f5`), mit einer prozedural erzeugten Fugen-Textur
(`BOARD_PANEL_WIDTH_M = 2,4`). Die Textur läuft über
`uv1_world_triplanar`, damit die Panelbreite auf geraden Stücken und in den
Kurven gleich bleibt – BoxMesh-UVs hätten die Fugen pro Segment gestreckt.
- **Reling:** rot (`b3261e`) als obere Kante.
Sichtprüfung mit vier Blickwinkeln (Übersicht, Bande nah, Folgekamera,
Innenansicht): `tests/manual/capture_rink_boards.gd`. Die Tests prüfen, dass
jede Bande einen Sockel hat, die Bande eine Textur trägt, die Fugen in
Weltkoordinaten wiederholen und sich Bande und Eis in der Helligkeit
unterscheiden.